xapi.annotation.reflect

Interface ReflectionAnnotation

All Superinterfaces:

Annotation

public interface ReflectionAnnotation
extends Annotation

The common structure of all @Keep____ Reflection annotations. Currently KeepConstructor, KeepMethod

Author:

"James X. Nelson (james@wetheinter.net)"

Method Summary

Modifier and Type	Method and Description
String	debugData() DebugData to include.
boolean	loadAsync() Whether or not to defer including reflected constructor into a code split containing all reflection data.
boolean	preventOverride() Used to allow package-level or type-level annotations to override children.

Methods inherited from interface java.lang.annotation.Annotation

annotationType, equals, hashCode, toString

Method Detail

debugData

String debugData()

DebugData to include.

Returns:

"" (default) = no debug data / production mode "anything" = keep this string, and print extra debug logging.

loadAsync

boolean loadAsync()

Whether or not to defer including reflected constructor into a code split containing all reflection data. Implementations using xapi-gwt-inject won't need to worry as much, the magic-method-injector will ensure code bloat is localized to call site and trimmed

Returns:

true to force this code into async split. Generator will throw exception if accessed outside of X_Reflect.async()

preventOverride

boolean preventOverride()

Used to allow package-level or type-level annotations to override children. Good for overriding default settings temporarily; setting debugData and preventOverride on package-info.java will turn on debugging for that package.

Returns:

true, to prevent checking for more specific child types. Inheritance Hierarchy Is -> package-info.java -> OuterClass -> OuterClass$InnerClass -> ...