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

Modifier and Type	Method and Description
static String	getWorkingDirectory()
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".
static boolean	isTest()

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.

isTest

public static boolean isTest()

isMultithreaded

public static boolean isMultithreaded()

Returns:

true unless X_Namespace.PROPERTY_MULTITHREADED is set to 0

getWorkingDirectory

public static String getWorkingDirectory()