com.google.gwt.lang

Class JavaClassHierarchySetupUtil

java.lang.Object

com.google.gwt.lang.JavaClassHierarchySetupUtil

public class JavaClassHierarchySetupUtil
extends Object

Utility class for defining class prototyes to setup an equivalent to the Java class hierarchy in JavaScript.

Constructor Summary

Constructors

Constructor and Description
JavaClassHierarchySetupUtil()

Method Summary

Modifier and Type	Method and Description
static JavaScriptObject	createSubclassPrototype(JavaScriptObject superTypeId) Create a subclass prototype.
static JavaScriptObject	defineClass(JavaScriptObject typeId, JavaScriptObject superTypeId, JavaScriptObject castableTypeMap) If not already created it creates the prototype for the class and stores it in prototypesByTypeId.
static JavaScriptObject	defineClassWithPrototype(int typeId, JavaScriptObject jsSuperClass, JavaScriptObject castableTypeMap) Like defineClass() but second parameter is a native JS prototype reference.
static JavaScriptObject	getClassPrototype(JavaScriptObject typeId) Retrieves the prototype for a type if it exists, null otherwise.
static JavaScriptObject	makeBridgeMethod(JavaScriptObject methodRef, boolean returnsLong, boolean[] longParams) Create a function that invokes the specified method reference.
static void	modernizeBrowser() Do polyfills for all methods expected in a modern browser.
static JavaScriptObject	provide(JavaScriptObject namespace) Creates a JS namespace to attach exported classes to.
static boolean	trampolineBridgeMethod(Object o, Object bridgeRef, Object nonbridgeRef) If the parameter o is a Javascript object, return the bridge method reference, otherwise return the nonbridge reference.

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, toString

Constructor Detail

JavaClassHierarchySetupUtil

public JavaClassHierarchySetupUtil()

Method Detail

defineClass

public static JavaScriptObject defineClass(JavaScriptObject typeId,
                                           JavaScriptObject superTypeId,
                                           JavaScriptObject castableTypeMap)

If not already created it creates the prototype for the class and stores it in prototypesByTypeId. If superTypeId is null, it means that the class being defined is the topmost class (i.e. java.lang.Object) and creates an empty prototype for it. Otherwise it creates the prototype for the class by calling createSubclassPrototype(). It also assigns the castable type map and sets the constructors prototype field to the current prototype. Finally adds the class literal if it was created before the call to defineClass. Class literals might be created before the call to defineClass if they are in separate code-split fragments. In that case Class.createFor* methods will have created a placeholder and stored in prototypesByTypeId the class literal.

As a prerequisite if superSeed is not null, it is assumed that defineClass for the supertype has already been called.

defineClassWithPrototype

public static JavaScriptObject defineClassWithPrototype(int typeId,
                                                        JavaScriptObject jsSuperClass,
                                                        JavaScriptObject castableTypeMap)

Like defineClass() but second parameter is a native JS prototype reference.

createSubclassPrototype

public static JavaScriptObject createSubclassPrototype(JavaScriptObject superTypeId)

Create a subclass prototype.

provide

public static JavaScriptObject provide(JavaScriptObject namespace)

Creates a JS namespace to attach exported classes to.

Parameters:

namespace - a dotted js namespace string

Returns:

a nested object literal representing the namespace

makeBridgeMethod

public static JavaScriptObject makeBridgeMethod(JavaScriptObject methodRef,
                                                boolean returnsLong,
                                                boolean[] longParams)

Create a function that invokes the specified method reference.

trampolineBridgeMethod

public static boolean trampolineBridgeMethod(Object o,
                                             Object bridgeRef,
                                             Object nonbridgeRef)

If the parameter o is a Javascript object, return the bridge method reference, otherwise return the nonbridge reference.

Parameters:

o - an instance object we want to invoke a method on

bridgeRef - a reference to an exported, bridgereference or jstype method

nonbridgeRef - the internal reference to Java obfuscated method

Returns:

modernizeBrowser

public static void modernizeBrowser()

Do polyfills for all methods expected in a modern browser.

getClassPrototype

public static JavaScriptObject getClassPrototype(JavaScriptObject typeId)

Retrieves the prototype for a type if it exists, null otherwise.