Package org.mozilla.javascript.engine

Class RhinoScriptEngine

java.lang.Object

javax.script.AbstractScriptEngine

org.mozilla.javascript.engine.RhinoScriptEngine

All Implemented Interfaces:

Compilable, Invocable, ScriptEngine

public class RhinoScriptEngine
extends AbstractScriptEngine
implements Compilable, Invocable

This is the implementation of the standard ScriptEngine interface for Rhino.

An instance of the Rhino ScriptEngine is fully self-contained. Bindings at the GLOBAL_SCOPE may be set, but there is nothing special about them -- if both global and ENGINE_SCOPE bindings are set then the "engine" bindings override the global ones.

The Rhino engine is not thread safe. Rhino does no synchronization of ScriptEngine instances and no synchronization of Bindings instances. It is up to the caller to ensure that the ScriptEngine and all its Bindings are used by a single thread at a time.

The Rhino script engine includes some top-level built-in functions. See the Builtins class for more documentation.

The engine supports a few configuration parameters that may be set at the "engine scope". Both are numbers that may be set to a String or Number object.

• javax.script.language_version: The version of the JavaScript language supported, which is an integer defined in the Context class. The default is the latest "ES6" version, defined as 200.
• org.mozilla.javascript.optimization_level: The level of optimization Rhino performs on the generated bytecode. Default is 9, which is the most. Set to -1 to use interpreted mode.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	OPTIMIZATION_LEVEL	Reserved key for the Rhino optimization level.

Fields inherited from class javax.script.AbstractScriptEngine

context

Fields inherited from interface javax.script.ScriptEngine

ARGV, ENGINE, ENGINE_VERSION, FILENAME, LANGUAGE, LANGUAGE_VERSION, NAME

Method Summary

Modifier and Type	Method	Description
CompiledScript	compile(Reader script)
CompiledScript	compile(String script)
Bindings	createBindings()
Object	eval(Reader reader, ScriptContext context)
Object	eval(String script, ScriptContext context)
ScriptEngineFactory	getFactory()
<T> T	getInterface(Class<T> clasz)
<T> T	getInterface(Object thiz, Class<T> clasz)
Object	invokeFunction(String name, Object... args)
Object	invokeMethod(Object thiz, String name, Object... args)

Methods inherited from class javax.script.AbstractScriptEngine

eval, eval, eval, eval, get, getBindings, getContext, getScriptContext, put, setBindings, setContext

Methods inherited from class java.lang.Object

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

Field Details

OPTIMIZATION_LEVEL

public static final String OPTIMIZATION_LEVEL

Reserved key for the Rhino optimization level. Default is "9," for optimized and compiled code. Set this to "-1" to run Rhino in interpreted mode -- this is much much slower but the only option on platforms like Android that don't support class files.

See Also:

• Constant Field Values

Method Details

eval

public Object eval(String script,
 ScriptContext context)
            throws ScriptException

Specified by:

eval in interface ScriptEngine

Throws:

ScriptException

eval

public Object eval(Reader reader,
 ScriptContext context)
            throws ScriptException

Specified by:

eval in interface ScriptEngine

Throws:

ScriptException

compile

public CompiledScript compile(String script)
                       throws ScriptException

Specified by:

compile in interface Compilable

Throws:

ScriptException

compile

public CompiledScript compile(Reader script)
                       throws ScriptException

Specified by:

compile in interface Compilable

Throws:

ScriptException

invokeFunction

public Object invokeFunction(String name,
 Object... args)
                      throws ScriptException,
NoSuchMethodException

Specified by:

invokeFunction in interface Invocable

Throws:

ScriptException

NoSuchMethodException

invokeMethod

public Object invokeMethod(Object thiz,
 String name,
 Object... args)
                    throws ScriptException,
NoSuchMethodException

Specified by:

invokeMethod in interface Invocable

Throws:

ScriptException

NoSuchMethodException

getInterface

public <T> T getInterface(Class<T> clasz)

Specified by:

getInterface in interface Invocable

getInterface

public <T> T getInterface(Object thiz,
 Class<T> clasz)

Specified by:

getInterface in interface Invocable

createBindings

public Bindings createBindings()

Specified by:

createBindings in interface ScriptEngine

getFactory

public ScriptEngineFactory getFactory()

Specified by:

getFactory in interface ScriptEngine