ReflectionStrategy (GWT Javadoc)

@Target(value={TYPE,PACKAGE})
 @Retention(value=RUNTIME)
public @interface ReflectionStrategy

Field Summary

Fields
Modifier and Type	Fields and Description
`static int`	`ALL_ANNOTATIONS`
`static int`	`ALL_MEMBERS`
`static int`	`ANNOTATION`
`static int`	`COMPILE`
`static int`	`CONSTRUCTOR`
`static int`	`FIELD`
`static int`	`INHERITED`
`static int`	`META`
`static int`	`METHOD`
`static int`	`NONE`
`static int`	`RUNTIME`
`static int`	`SOURCE`
`static int`	`TYPE`

Optional Element Summary

Optional Elements
Modifier and Type	Optional Element and Description
`int`	`annotationRetention` An int register of annotation-retention level; if set to `NONE`, no annotations will be kept for any members, otherwise, this sets the retention level for this type only; to set member-level return, you can set global member retention via `memberRetention()`, member-type level retention via `methodRetention()`, `constructorRetention()`, `typeRetention()` and `fieldRetention()`.
`GwtRetention`	`constructorRetention`
`int`	`debug` An int register of member types that should emit debug data.
`GwtRetention`	`fieldRetention`
`boolean`	`keepCodeSource` Whether or not to include the file url to the source file, as returned by Class.class.getProtectionDomain().getCodeSource().getLocation().getPath();
`boolean`	`keepEverything` Simple flag to mark a type (or package) that should keep all reflection data.
`boolean`	`keepInnerTypes` Whether or not to automatically retain inner classes.
`boolean`	`keepNothing` Simple flag to mark a type (or package) that should keep zero reflection data.
`boolean`	`keepPackage`
`boolean`	`magicSupertypes` Set to true to retain all ancestors' public fields.
`GwtRetention[]`	`memberRetention` If you return any retention level here, it will override the defaults in `methodRetention()`, `constructorRetention()`, `fieldRetention()` and `typeRetention()`.
`GwtRetention`	`methodRetention` Define a retention policy for all methods within the annotated class or package.
`java.lang.Class<? extends NewInstanceStrategy>`	`newInstanceStrategy`
`GwtRetention`	`typeRetention`

- Field Detail
  - NONE
```
public static final int NONE
```
- - COMPILE
```
public static final int COMPILE
```
- - RUNTIME
```
public static final int RUNTIME
```
- - INHERITED
```
public static final int INHERITED
```
- - ALL_ANNOTATIONS
```
public static final int ALL_ANNOTATIONS
```
- - TYPE
```
public static final int TYPE
```
- - CONSTRUCTOR
```
public static final int CONSTRUCTOR
```
- - FIELD
```
public static final int FIELD
```
- - METHOD
```
public static final int METHOD
```
- - ANNOTATION
```
public static final int ANNOTATION
```
- - META
```
public static final int META
```
- - SOURCE
```
public static final int SOURCE
```
- - ALL_MEMBERS
```
public static final int ALL_MEMBERS
```
- Element Detail
  - magicSupertypes
```
public abstract boolean magicSupertypes
```
    Set to true to retain all ancestors' public fields.
    Ancestors (supertypes and interfaces) will be checked for public members, and will have reflection data written for those members (via clinit on supertypes) when the direct .getMethod(), .getMethods(), etc is called (versus the more precise .getDeclaredMethod(), .getDeclaredMethods()).
    
    Returns:
    
    true to cause all superclasses to be enhanced.
    
    Default:
    
    false
- - keepNothing
```
public abstract boolean keepNothing
```
    Simple flag to mark a type (or package) that should keep zero reflection data.
    
    Default:
    
    false
- - keepEverything
```
public abstract boolean keepEverything
```
    Simple flag to mark a type (or package) that should keep all reflection data.
    USE AT YOUR OWN RISK. Use -compileReport and -extra to view how much code is added when you apply this setting. In the case of large classes that would be pruned, this could easily triple the amount of compiled output.
    That said, if you want a complete jvm-compatible class without tweaking anything, just set this to true (but do try to avoid doing so at the package level).
    
    Default:
    
    false
- - keepCodeSource
```
public abstract boolean keepCodeSource
```
    Whether or not to include the file url to the source file, as returned by Class.class.getProtectionDomain().getCodeSource().getLocation().getPath();
    Ya, it's pretty ugly, but that's how to get a classes compiled location in any jvm that supports it.
    Setting this value to true imposes a security risk!
    This will compile locations of files on your harddrive into your application. If you do not understand the security implications of this, you should NOT use this in any production application.
    
    Returns:
    
    Default:
    
    false
- - keepInnerTypes
```
public abstract boolean keepInnerTypes
```
    Whether or not to automatically retain inner classes.
    The default of false is to help reduce default code size; you can annotate your subtypes manually; this just makes it easier to paint with a broader brush.
    
    Returns:
    
    Default:
    
    false
- - newInstanceStrategy
```
public abstract java.lang.Class<? extends NewInstanceStrategy> newInstanceStrategy
```
    Returns:
    
    a class which fulfills the NewInstanceStrategy contract.
    Allow for easy injection of new instance strategies; provided defaults are new Type(), and GWT.create(Type.class);.
    Default is new Type(), or throw Exception() if no suitable constructor is available.
    
    Default:
    
    com.google.gwt.reflect.client.strategy.UseNewKeyword.class
- - methodRetention
```
public abstract GwtRetention methodRetention
```
    Define a retention policy for all methods within the annotated class or package.
    A class-level ReflectionStrategy completely overrides a package level one.
    The default retention strategy is to synchronously include all declared members, and no supertype members.
    
    Default:
    
    @com.google.gwt.reflect.client.strategy.GwtRetention
- - constructorRetention
```
public abstract GwtRetention constructorRetention
```
    Default:
    
    @com.google.gwt.reflect.client.strategy.GwtRetention
- - fieldRetention
```
public abstract GwtRetention fieldRetention
```
    Default:
    
    @com.google.gwt.reflect.client.strategy.GwtRetention
- - typeRetention
```
public abstract GwtRetention typeRetention
```
    Default:
    
    @com.google.gwt.reflect.client.strategy.GwtRetention
- - memberRetention
```
public abstract GwtRetention[] memberRetention
```
    If you return any retention level here, it will override the defaults in methodRetention(), constructorRetention(), fieldRetention() and typeRetention().
    This is a convenience method so you do not have to type a pile of code to retain all annotations.
    Only the first value in the array is returned. An array is merely used to provide the concept of null.
    
    Default:
    
    {}
- - annotationRetention
```
public abstract int annotationRetention
```
    An int register of annotation-retention level; if set to NONE, no annotations will be kept for any members, otherwise, this sets the retention level for this type only; to set member-level return, you can set global member retention via memberRetention(), member-type level retention via methodRetention(), constructorRetention(), typeRetention() and fieldRetention().
    You may override any defaults by annotating individual members with @GwtRetention.
    
    Returns:
    
    NONE | COMPILE | RUNTIME
    
    Default:
    
    0
- - debug
```
public abstract int debug
```
    An int register of member types that should emit debug data.
    
    Returns:
    
    an non-empty string causes the compiler to dump the generated reflection source for this class. Valid values are OR'd combinations of TYPE, CONSTRUCTOR, FIELD, METHOD and ANNOTATION
    
    Default:
    
    0
- - keepPackage
```
public abstract boolean keepPackage
```
    Returns:
    
    true to keep the package, false to elide
    
    Default:
    
    true

Annotation Type ReflectionStrategy

Field Summary

Optional Element Summary

Field Detail

NONE

COMPILE

RUNTIME

INHERITED

ALL_ANNOTATIONS

TYPE

CONSTRUCTOR

FIELD

METHOD

ANNOTATION

META

SOURCE

ALL_MEMBERS

Element Detail

magicSupertypes

keepNothing

keepEverything

keepCodeSource

keepInnerTypes

newInstanceStrategy

methodRetention

constructorRetention

fieldRetention

typeRetention

memberRetention

annotationRetention

debug

keepPackage