org.liquidplayer.javascript

Class JSContextGroup

java.lang.Object

org.liquidplayer.javascript.JSContextGroup

public class JSContextGroup
extends java.lang.Object

A JSContextGroup associates JavaScript contexts with one another. Contexts in the same group may share and exchange JavaScript objects. Sharing and/or exchanging JavaScript objects between contexts in different groups will produce undefined behavior. When objects from the same context group are used in multiple threads, explicit synchronization is required.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	JSContextGroup.LoopPreserver

Constructor Summary

Constructors

Constructor and Description
JSContextGroup() Creates a new context group
JSContextGroup(java.io.File snapshot) Creates a new context group for which all contexts created in it will start from a snapshot.

Method Summary

Modifier and Type	Method and Description
static java.io.File	createSnapshot(java.lang.String script, java.io.File snapshotToWrite) Creates a snapshot of JavaScript code that can be used by the JSContextGroup(File) constructor to speed up startup of new contexts.
boolean	equals(java.lang.Object other) Checks if two JSContextGroups refer to the same JS context group
long	groupHash()
org.liquidplayer.javascript.JNIJSContextGroup	groupRef() Gets the JNI context group reference
JSContextGroup.LoopPreserver	keepAlive()

Methods inherited from class java.lang.Object

getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JSContextGroup

public JSContextGroup()

Creates a new context group

Since:

0.1.0

JSContextGroup

public JSContextGroup(java.io.File snapshot)

Creates a new context group for which all contexts created in it will start from a snapshot. If snapshot file load files, this constructor will fail silently and use the default snapshot.

Parameters:

snapshot - File generated from previous call to createSnapshot()

Method Detail

createSnapshot

public static java.io.File createSnapshot(java.lang.String script,
                                          java.io.File snapshotToWrite)
                                   throws java.io.IOException

Creates a snapshot of JavaScript code that can be used by the JSContextGroup(File) constructor to speed up startup of new contexts.

Parameters:

script - Script to create snapshot from

snapshotToWrite - File to write (will be overwritten if exists)

Returns:

The written file

Throws:

java.io.IOException - thrown if taking snapshot or writing to the file fails; check message

groupRef

public org.liquidplayer.javascript.JNIJSContextGroup groupRef()

Gets the JNI context group reference

Returns:

the JNI context group reference

Since:

0.1.0

groupHash

public long groupHash()

keepAlive

public JSContextGroup.LoopPreserver keepAlive()

equals

public boolean equals(java.lang.Object other)

Checks if two JSContextGroups refer to the same JS context group

Overrides:

equals in class java.lang.Object

Parameters:

other - the other object to compare

Returns:

true if refer to same context group, false otherwise

Since:

0.1.0