xapi.reflect.service

Interface ReflectionService

All Known Implementing Classes:

ReflectionServiceDefault

public interface ReflectionService

A service interface for providing reflection support to limited runtimes. Currently, this serves primarily to allow GWT to use reflection, but there's no reason it cannot be used for gwt-flash or java2objc tranpiling either.

Author:

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

Method Summary

Modifier and Type	Method and Description
Package	getPackage(Object o) This method is mostly for gwt; but is also useful for web apps and codegen Gwt dev mode has problems as its isolated classloader doesn't provide packages.
Package	getPackage(String parentName, ClassLoader cl)
<T> Class<T>	magicClass(Class<T> classLit)
<T> T[]	newArray(Class<T> classLit, int... dimensions)
<T> T[]	newArray(Class<T> classLit, int dimension)

Method Detail

magicClass

<T> Class<T> magicClass(Class<T> classLit)

newArray

<T> T[] newArray(Class<T> classLit,
                 int dimension)

newArray

<T> T[] newArray(Class<T> classLit,
                 int... dimensions)

getPackage

Package getPackage(Object o)

This method is mostly for gwt; but is also useful for web apps and codegen Gwt dev mode has problems as its isolated classloader doesn't provide packages. We can get class metadata directly using the thread classloader, but the instances will throw class cast when trying to use constructors. Classes returned by magicClass in devmode will be fully functional in terms of reflection, but some data, like package, are stripped. It can also be used in gwt-prod to load class data that you do not want compiled into the javascript; it will request the binary class data, and parse out the metadata It can also be used in multi-classloader web app environments, to perform class metadata introspection on objects from foreign classloaders. the extra support needed for gwt-dev is extracted here.

Parameters:

o -

Returns:

getPackage

Package getPackage(String parentName,
                   ClassLoader cl)