org.liquidplayer.webkit.javascriptcore

Class JSContext

java.lang.Object

org.liquidplayer.webkit.javascriptcore.JSValue

org.liquidplayer.webkit.javascriptcore.JSObject

org.liquidplayer.webkit.javascriptcore.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.

Field Summary

Fields

Modifier and Type	Field and Description
java.lang.Object	mMutex

Fields inherited from class org.liquidplayer.webkit.javascriptcore.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	clearExceptionHandler() Clears a previously set exception handler.
java.lang.Long	ctxRef() Gets the JavaScriptCore context reference
JSValue	evaluateScript(java.lang.String script) Executes a the JavaScript code in 'script' in this context
JSValue	evaluateScript(java.lang.String script, JSObject thiz) Executes a the JavaScript code in 'script' in this context
JSValue	evaluateScript(java.lang.String script, JSObject thiz, java.lang.String sourceURL, int startingLineNumber) Executes a the JavaScript code in 'script' in this context
void	garbageCollect() Forces JavaScript garbage collection on this context
JSContextGroup	getGroup() Gets the context group to which this context belongs.
void	setExceptionHandler(JSContext.IJSExceptionHandler handler) Sets the JS exception handler for this context.
void	throwJSException(JSException exception) If an exception handler is set, calls the exception handler, otherwise throws the JSException.

Methods inherited from class org.liquidplayer.webkit.javascriptcore.JSObject

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

Methods inherited from class org.liquidplayer.webkit.javascriptcore.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

Field Detail

mMutex

public final java.lang.Object mMutex

Constructor Detail

JSContext

public JSContext()

Creates a new JavaScript context

Since:

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:

1.0

JSContext

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

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

Throws:

JSException

Since:

1.0

JSContext

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

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

Throws:

JSException

Since:

1.0

Method Detail

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:

2.1

clearExceptionHandler

public void clearExceptionHandler()

Clears a previously set exception handler.

Since:

2.1

throwJSException

public void throwJSException(JSException exception)
                      throws JSException

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

Parameters:

exception - The JSException to be thrown

Throws:

JSException

Since:

2.1

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

evaluateScript

public JSValue evaluateScript(java.lang.String script,
                              JSObject thiz,
                              java.lang.String sourceURL,
                              int startingLineNumber)
                       throws JSException

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

Parameters:

script - The code to execute

thiz - The 'this' object

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'

Throws:

JSException

Since:

1.0

evaluateScript

public JSValue evaluateScript(java.lang.String script,
                              JSObject thiz)
                       throws JSException

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

Parameters:

script - The code to execute

thiz - The 'this' object

Returns:

The return value returned by 'script'

Throws:

JSException

Since:

1.0

evaluateScript

public JSValue evaluateScript(java.lang.String script)
                       throws JSException

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

Parameters:

script - The code to execute

Returns:

The return value returned by 'script'

Throws:

JSException

Since:

1.0

garbageCollect

public void garbageCollect()

Forces JavaScript garbage collection on this context

Since:

1.0