xapi.reflect

Class X_Reflect

java.lang.Object

xapi.reflect.X_Reflect

public class X_Reflect
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static javax.inject.Provider<ReflectionService>	singleton

Method Summary

Modifier and Type	Method and Description
static Package	getPackage(Class<?> classLit) This is an unfortunate workaround for gwt-dev mode's isolated classloader not returning packages.
static Package	getPackage(String parentName, ClassLoader cl)
static <T> Class<T>	magicClass(Class<T> cls) In order to selectively enable full class support in gwt, we need to be able to see the class literal in the generator.
static <T> T[]	newArray(Class<T> classLit, int length)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

singleton

public static final javax.inject.Provider<ReflectionService> singleton

Method Detail

newArray

public static <T> T[] newArray(Class<T> classLit,
                               int length)

getPackage

public static Package getPackage(Class<?> classLit)

This is an unfortunate workaround for gwt-dev mode's isolated classloader not returning packages. If you use super dev mode instead of dev mode, you'll never need this method. If you do use dev mode, you should route all Class.getPackage() through this method, which uses the thread classloader to get a regular jre class (one that will cause ClassCastException if used reflectively!). This method can be of limited use for production mode; it will return a package for a class completely lacking in package based annotations.

Parameters:

classLit -

Returns:

magicClass

public static <T> Class<T> magicClass(Class<T> cls)

In order to selectively enable full class support in gwt, we need to be able to see the class literal in the generator. You MUST only send class literals to this method; Class<MyClass> cls = X_Reflect.magicClass(MyClass.class); Now you may use cls like any other class, to the extent provided by MagicClass, and you may pass the variable around and use references to it in other X_Inject methods. GWT.create() does not support magic classes, as we don't want to rewrite that method for anyone. Use X_Inject.instance(), and it will default to GWT.create(). If you do use @InstanceOverride to inject a different class, it will also be instantiated w/ GWT.create(). This method will call into a magic-method generator, which pulls in all the required metadata at compile time, and emits a "subclass" of java.lang.Class. This is completely illegal in java, but gwt is js, so anything goes. Rather than glob up a bunch of metadata into all class literals, and cause terrible bloat across the app, this method lets you select which classes you want full metadata on, and which others will reduce to the typical, mostly-unsupported emulated Class. Note that for your gwt app to compile with references to the mostly unsupported class objects, you must have xapi-super above gwt-user and gwt-dev on your classpath. Our emulated class provides the method stubs, which throw exceptions to wrap objects w/ #magicClass.

Parameters:

cls -

Returns:

getPackage

public static Package getPackage(String parentName,
                                 ClassLoader cl)