org.liquidplayer.javascript

Class JSContext

java.lang.Object

org.liquidplayer.javascript.JSValue

org.liquidplayer.javascript.JSObject

org.liquidplayer.javascript.JSContext

public class JSContext
extends JSObject

Wraps a JavaScriptCore context

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	JSContext.IJSExceptionHandler Object interface for handling JSExceptions.

Nested classes/interfaces inherited from class org.liquidplayer.javascript.JSObject

JSObject.jsexport, JSObject.Property<T>

Field Summary

Fields inherited from class org.liquidplayer.javascript.JSObject

JSPropertyAttributeDontDelete, JSPropertyAttributeDontEnum, JSPropertyAttributeNone, JSPropertyAttributeReadOnly

Constructor Summary

Constructors

Constructor and Description
JSContext() Creates a new JavaScript context
JSContext(java.lang.Class<?> iface) Creates a JavaScript context, and defines the global object with interface 'iface'.
JSContext(JSContextGroup inGroup) Creates a new JavaScript context in the context group 'inGroup'.
JSContext(JSContextGroup inGroup, java.lang.Class<?> iface) Creates a JavaScript context in context group 'inGroup', and defines the global object with interface 'iface'.

Method Summary

Modifier and Type	Method and Description
void	async(java.lang.Runnable runnable)
void	clearExceptionHandler() Clears a previously set exception handler.
java.lang.Long	ctxRef() Gets the JavaScriptCore context reference
static void	dummy() Forces static libraries to load
JSValue	evaluateScript(java.lang.String script) Executes a the JavaScript code in 'script' in this context
JSValue	evaluateScript(java.lang.String script, java.lang.String sourceURL, int startingLineNumber) Executes a the JavaScript code in 'script' in this context
JSContextGroup	getGroup() Gets the context group to which this context belongs.
long	getJSCContext()
java.lang.Boolean	isOnThread()
void	setExceptionHandler(JSContext.IJSExceptionHandler handler) Sets the JS exception handler for this context.
void	sync(java.lang.Runnable runnable)
void	throwJSException(JSException exception) If an exception handler is set, calls the exception handler, otherwise throws the JSException.

Methods inherited from class org.liquidplayer.javascript.JSObject

__nullFunc, deleteProperty, getThis, hashCode, hasProperty, isConstructor, isFunction, property, property, property, propertyAtIndex, propertyAtIndex, propertyNames, prototype, prototype

Methods inherited from class org.liquidplayer.javascript.JSValue

equals, getContext, isArray, isBoolean, isDate, isEqual, isInstanceOfConstructor, isNull, isNumber, isObject, isStrictEqual, isString, isUndefined, toBoolean, toFunction, toJSArray, toJSON, toJSON, toNumber, toObject, toString, valueRef

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

JSContext

public JSContext()

Creates a new JavaScript context

Since:

0.1.0

JSContext

public JSContext(JSContextGroup inGroup)

Creates a new JavaScript context in the context group 'inGroup'.

Parameters:

inGroup - The context group to create the context in

Since:

0.1.0

JSContext

public JSContext(java.lang.Class<?> iface)

Creates a JavaScript context, and defines the global object with interface 'iface'. This object must implement 'iface'. The methods in 'iface' will be exposed to the JavaScript environment.

Parameters:

iface - The interface to expose to JavaScript

Since:

0.1.0

JSContext

public JSContext(JSContextGroup inGroup,
                 java.lang.Class<?> iface)

Creates a JavaScript context in context group 'inGroup', and defines the global object with interface 'iface'. This object must implement 'iface'. The methods in 'iface' will be exposed to the JavaScript environment.

Parameters:

inGroup - The context group to create the context in

iface - The interface to expose to JavaScript

Since:

0.1.0

Method Detail

dummy

public static void dummy()

Forces static libraries to load

Since:

0.1.0

sync

public void sync(java.lang.Runnable runnable)

async

public void async(java.lang.Runnable runnable)

isOnThread

public java.lang.Boolean isOnThread()

getJSCContext

public long getJSCContext()

setExceptionHandler

public void setExceptionHandler(JSContext.IJSExceptionHandler handler)

Sets the JS exception handler for this context. Any thrown JSException in this context will call the 'handle' method on this object. The calling function will return with an undefined value.

Parameters:

handler - An object that implements 'IJSExceptionHandler'

Since:

0.1.0

clearExceptionHandler

public void clearExceptionHandler()

Clears a previously set exception handler.

Since:

0.1.0

throwJSException

public void throwJSException(JSException exception)

If an exception handler is set, calls the exception handler, otherwise throws the JSException.

Parameters:

exception - The JSException to be thrown

Since:

0.1.0

getGroup

public JSContextGroup getGroup()

Gets the context group to which this context belongs.

Returns:

The context group to which this context belongs

ctxRef

public java.lang.Long ctxRef()

Gets the JavaScriptCore context reference

Returns:

the JavaScriptCore context reference

Since:

0.1.0

evaluateScript

public JSValue evaluateScript(@NonNull
                              java.lang.String script,
                              java.lang.String sourceURL,
                              int startingLineNumber)

Executes a the JavaScript code in 'script' in this context

Parameters:

script - The code to execute

sourceURL - The URI of the source file, only used for reporting in stack trace (optional)

startingLineNumber - The beginning line number, only used for reporting in stack trace (optional)

Returns:

The return value returned by 'script'

Since:

0.1.0

evaluateScript

public JSValue evaluateScript(java.lang.String script)

Executes a the JavaScript code in 'script' in this context

Parameters:

script - The code to execute

Returns:

The return value returned by 'script'

Since:

0.1.0