com.google.gwt.core.client
Class GWT

java.lang.Object
  com.google.gwt.core.client.GWT

public final class GWT

extends Object

Supports core functionality that in some cases requires direct support from the compiler and runtime systems such as runtime type information and deferred binding.

Nested Class Summary

static interface

GWT.UncaughtExceptionHandler This interface is used to catch exceptions at the "top level" just before they escape to the browser.

Field Summary

Fields inherited from class java.lang.Object

typeId, typeName

Constructor Summary

GWT()

Method Summary

static Object	create(Class classLiteral) Instantiates a class via deferred binding.
static String	getModuleBaseURL() Gets the url prefix of the module, which can be prefixed to URLs that are known to be part of the module's public path.
static String	getModuleName() Gets the name of the running module.
static String	getTypeName(Object o) Gets the class name of the specified object, as would be returned by o.getClass().getName().
static GWT.UncaughtExceptionHandler	getUncaughtExceptionHandler() Returns the currently active uncaughtExceptionHandler.
static boolean	isScript() Determines whether or not the running program is script or bytecode.
static void	log(String message, Throwable e) Logs a message to the development shell logger in hosted mode.
static void	setUncaughtExceptionHandler(GWT.UncaughtExceptionHandler handler) Sets a custom uncaught exception handler.

Methods inherited from class java.lang.Object

equals, finalize, hashCode, toString

Constructor Detail

GWT

public GWT()

Method Detail

getUncaughtExceptionHandler

public static GWT.UncaughtExceptionHandler getUncaughtExceptionHandler()

Returns the currently active uncaughtExceptionHandler. "Top level" methods that dispatch events from the browser into user code must call this method on entry to get the active handler. If the active handler is null, the entry point must allow exceptions to escape into the browser. If the handler is non-null, exceptions must be caught and routed to the handler. See com.google.gwt.user.client.DOM#dispatchEvent(Event, Element, EventListener) for an example of how to handle this correctly.

Returns:

the currently active handler, or null if no handler is active.

setUncaughtExceptionHandler

public static void setUncaughtExceptionHandler(GWT.UncaughtExceptionHandler handler)

Sets a custom uncaught exception handler. See getUncaughtExceptionHandler() for details.

Parameters:

handler - the handler that should be called when an exception is about to escape to the browser, or null to clear the handler and allow exceptions to escape.

create

public static Object create(Class classLiteral)

Instantiates a class via deferred binding. Very important: the argument to create(Class) must be a class literal because the web mode compiler must be able to statically determine the requested type at compile-time. This can be tricky because using a Class may appear to work correctly in hosted mode.

Parameters:

classLiteral - a class literal specifying the base class to be instantiated

Returns:

the new instance, which must be typecast to the requested class.

getTypeName

public static String getTypeName(Object o)

Gets the class name of the specified object, as would be returned by o.getClass().getName().

Parameters:

o - the object whose class name is being sought, or null

Returns:

the class name of the specified object, or null if o is null

isScript

public static boolean isScript()

Determines whether or not the running program is script or bytecode.

getModuleName

public static String getModuleName()

Gets the name of the running module.

getModuleBaseURL

public static String getModuleBaseURL()

Gets the url prefix of the module, which can be prefixed to URLs that are known to be part of the module's public path.

log

public static void log(String message,
                       Throwable e)

Logs a message to the development shell logger in hosted mode. Calls are optimized out in web mode.