com.google.gwt.core.client
Class GWT

java.lang.Object
  extended bycom.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.



This javadoc distribution was not produced by Google. The official documentation is here.