public final class GWT
extends java.lang.Object
Modifier and Type | Class and Description |
---|---|
static interface |
GWT.UncaughtExceptionHandler
This interface is used to catch exceptions at the "top level" just before
they escape to the browser.
|
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
HOSTED_MODE_PERMUTATION_STRONG_NAME
This constant is used by
getPermutationStrongName() when running in
Development Mode. |
Constructor and Description |
---|
GWT() |
Modifier and Type | Method and Description |
---|---|
static <T> T |
create(java.lang.Class<?> classLiteral)
Instantiates a class via deferred binding.
|
static void |
debugger()
Emits a JavaScript "debugger" statement on the line that called this method.
|
static java.lang.String |
getHostPageBaseURL()
Gets the URL prefix of the hosting page, useful for prepending to relative
paths of resources which may be relative to the host page.
|
static java.lang.String |
getModuleBaseForStaticFiles()
Gets the URL prefix that should be prepended to URLs that point to
static files generated by the GWT compiler, such as files in the
module's public path.
|
static java.lang.String |
getModuleBaseURL()
Gets the URL prefix that should be prepended to URLs that
are intended to be module-relative, such as RPC entry points.
|
static java.lang.String |
getModuleName()
Gets the name of the running module.
|
static java.lang.String |
getPermutationStrongName()
Returns the permutation's strong name.
|
static java.lang.String |
getTypeName(java.lang.Object o)
Deprecated.
Use
Object.getClass() , Class.getName() |
static GWT.UncaughtExceptionHandler |
getUncaughtExceptionHandler()
Returns the currently active uncaughtExceptionHandler.
|
static java.lang.String |
getUniqueThreadId()
Returns the empty string when running in Production Mode, but returns a
unique string for each thread in Development Mode (for example, different
windows accessing the dev mode server will each have a unique id, and
hitting refresh without restarting dev mode will result in a new unique id
for a particular window.
|
static java.lang.String |
getVersion() |
static boolean |
isClient()
Returns
true when running inside the normal GWT environment,
either in Development Mode or Production Mode. |
static boolean |
isProdMode()
Returns
true when running in production mode. |
static boolean |
isScript()
Determines whether or not the running program is script or bytecode.
|
static void |
log(java.lang.String message)
Logs a message to the development shell logger in Development Mode, or to
the console in Super Dev Mode.
|
static void |
log(java.lang.String message,
java.lang.Throwable e)
Logs a message to the development shell logger in Development Mode, or to
the console in Super Dev Mode.
|
static void |
reportUncaughtException(java.lang.Throwable e)
Reports an exception caught at the "top level" to a handler set via
setUncaughtExceptionHandler(UncaughtExceptionHandler) . |
static void |
runAsync(java.lang.Class<?> name,
RunAsyncCallback callback)
The same as
runAsync(RunAsyncCallback) , except with an extra
parameter to provide a name for the call. |
static void |
runAsync(RunAsyncCallback callback)
Run the specified callback once the necessary code for it has been loaded.
|
(package private) static void |
setBridge(GWTBridge bridge)
Called via reflection in Development Mode; do not ever call this method in
Production Mode.
|
static void |
setUncaughtExceptionHandler(GWT.UncaughtExceptionHandler handler)
Sets a custom uncaught exception handler.
|
public static final java.lang.String HOSTED_MODE_PERMUTATION_STRONG_NAME
getPermutationStrongName()
when running in
Development Mode.public static <T> T create(java.lang.Class<?> classLiteral)
The argument to create(Class)
must be a class literal
because the Production Mode compiler must be able to statically determine
the requested type at compile-time. This can be tricky because using a
Class
variable may appear to work correctly in Development Mode.
classLiteral
- a class literal specifying the base class to be
instantiatedpublic static java.lang.String getHostPageBaseURL()
getModuleBaseURL()
unless you have a specific reason to
load a resource relative to the host page.public static java.lang.String getModuleBaseForStaticFiles()
Normally this will be the same value as getModuleBaseURL()
, but
may be different when a GWT app is configured to get its static resources
from a different server.
public static java.lang.String getModuleBaseURL()
If the URL points to an output file of the GWT compiler (such as
a file in the public path), use getModuleBaseForStaticFiles()
instead.
public static java.lang.String getModuleName()
public static java.lang.String getPermutationStrongName()
@Deprecated public static java.lang.String getTypeName(java.lang.Object o)
Object.getClass()
, Class.getName()
public static GWT.UncaughtExceptionHandler getUncaughtExceptionHandler()
reportUncaughtException(Throwable)
public static void reportUncaughtException(java.lang.Throwable e)
setUncaughtExceptionHandler(UncaughtExceptionHandler)
. This is
used in places where the browser calls into user code such as event
callbacks, timers, and RPC.
If no UncaughtExceptionHandler
is set, the exception is reported
to browser. Browsers usually log these exceptions to the JavaScript
console.
public static java.lang.String getUniqueThreadId()
public static java.lang.String getVersion()
public static boolean isClient()
true
when running inside the normal GWT environment,
either in Development Mode or Production Mode. Returns false
if this code is running in a plain JVM. This might happen when running
shared code on the server, or during the bootstrap sequence of a
GWTTestCase test.public static boolean isProdMode()
true
when running in production mode. Returns
false
when running either in development mode, or when running
in a plain JVM.public static boolean isScript()
public static void log(java.lang.String message)
public static void log(java.lang.String message, java.lang.Throwable e)
public static void debugger()
public static void runAsync(java.lang.Class<?> name, RunAsyncCallback callback)
runAsync(RunAsyncCallback)
, except with an extra
parameter to provide a name for the call. The name parameter should be
supplied with a class literal. If two GWT.runAsync calls use the same
class literal, the codesplitter will put the corresponding code in
the same code fragment.public static void runAsync(RunAsyncCallback callback)
public static void setUncaughtExceptionHandler(GWT.UncaughtExceptionHandler handler)
getUncaughtExceptionHandler()
for details.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.static void setBridge(GWTBridge bridge)