manifold.ext.api

Annotation Type Structural

@Retention(value=RUNTIME)
 @Target(value=TYPE)
public @interface Structural

Declare a structural interface using this annotation.

See the Structural Interfaces documentation for more information.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
Class	backingClass Optional.
Class	factoryClass Optional.

Element Detail

factoryClass

public abstract Class factoryClass

Optional.

A factory class that produces a class given a class extending backingClass and the structural interface to proxy. The factory class must provide a public default constructor and must implement IProxyFactory.

Note the factory class is optional and exists primarily to address performance when the first time a type is cast to a structural interface. If a factory class is not provided, Manifold dynamically generates and compiles one at runtime, which entails a significant first-time performance hit. Thus a compile-time proxy factory provides a way to eliminate this performance hit if and when needed.

Default:

java.lang.Void.class

backingClass

public abstract Class backingClass

Optional.

The base type of the object the proxy will wrap. This parameter is only relevant for structural interfaces that provide a factoryClass parameter.

Default:

java.lang.Void.class