xapi.util

Class X_Runtime

java.lang.Object

xapi.util.X_Runtime

public class X_Runtime
extends Object

This class is magic; there are four copies of this class; do not add anything to them unless you download all xapi source, and do a full text search on "X_Runtime\s+{" This is the public class exposed to a jre. Each method compiles down to a runtime constant, or as close a possible, to encourage compiler inlining. Then, we super-source a copy for normal gwt builds, which reports false for isRuntimeInjection, and GWT.isScript() for isGwtProd(). For gwt users who inherit xapi.X_Inject, we use magic method injection to replace the super-sourced copy of isRuntimeInjection() to return true or false, depending on the configuration present in gwt module xml. Finally, our xapi-debug module will override X_Runtime in the classloader, to return true for isDebug().

Author:

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

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	isActionScript()
static boolean	isDebug()
static boolean	isGwt()
static boolean	isJava() Overridden in super-source to return false.
static boolean	isJavaScript() Overridden in super-source to return GWT.isScript()
static boolean	isMultithreaded()
static boolean	isRuntimeInjection() In jres, this returns true if xapi.inject.X_Inject is on classpath, and the user has not set system property X_Namespace.PROPERTY_USE_X_INJECT explicitly to "false".

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

isJavaScript

public static boolean isJavaScript()

Overridden in super-source to return GWT.isScript()

Returns:

- true if running in compiled javascript.

isJava

public static boolean isJava()

Overridden in super-source to return false.

Returns:

- true in all jre runtimes, including gwt-dev

isActionScript

public static boolean isActionScript()

Returns:

- true only if xapi-flash-api is inherited.

isGwt

public static boolean isGwt()

Returns:

Convenience method for whether this is a gwt environment; hardcoded to true in super-source; optimized to return true in gwt dev.

isRuntimeInjection

public static boolean isRuntimeInjection()

In jres, this returns true if xapi.inject.X_Inject is on classpath, and the user has not set system property X_Namespace.PROPERTY_USE_X_INJECT explicitly to "false". Overridden in super-source to return false; overridden again with magic-method-injection to return true. The default debug module will check X_Properties on every call.

Returns:

true if runtime injection is enabled.

isDebug

public static boolean isDebug()

Returns:

true is xapi.debug property is set to true.

isMultithreaded

public static boolean isMultithreaded()

Returns:

true unless X_Namespace.PROPERTY_MULTITHREADED is set to 0