com.google.code.scriptengines.js.javascript

Class RhinoScriptEngine

java.lang.Object

javax.script.AbstractScriptEngine

com.google.code.scriptengines.js.javascript.RhinoScriptEngine

All Implemented Interfaces:

javax.script.Compilable, javax.script.Invocable, javax.script.ScriptEngine

Direct Known Subclasses:

EmbeddedRhinoScriptEngine

public class RhinoScriptEngine
extends javax.script.AbstractScriptEngine
implements javax.script.Invocable, javax.script.Compilable

Implementation of ScriptEngine using the Mozilla Rhino interpreter.

Since:

1.6 Modified for phobos to remove some of the restrictions. Modified to allow subclassing and preprocessing of script source code. Modified to avoid using the RhinoTopLevel class, since that introduces a circularity that prevents objects from being garbage collected.

Version:

1.0

Author:

Mike Grogan, A. Sundararajan, Roberto Chinnici

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEBUG

Fields inherited from class javax.script.AbstractScriptEngine

context

Fields inherited from interface javax.script.ScriptEngine

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

Constructor Summary

Constructors

Constructor and Description
RhinoScriptEngine() Creates a new instance of RhinoScriptEngine

Method Summary

Methods

Modifier and Type	Method and Description
static Object	bindings(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable thisObj, Object[] args, org.mozilla.javascript.Function funObj) The bindings function takes a JavaScript scope object of type ExternalScriptable and returns the underlying Bindings instance.
javax.script.CompiledScript	compile(Reader script)
javax.script.CompiledScript	compile(String script)
javax.script.Bindings	createBindings()
Object	eval(Reader reader, javax.script.ScriptContext ctxt)
Object	eval(String script, javax.script.ScriptContext ctxt)
javax.script.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)
static void	main(String[] args)
protected Reader	preProcessScriptSource(Reader reader)
protected void	processAllTopLevelScripts(org.mozilla.javascript.Context cx)
protected void	processTopLevelScript(String scriptName, org.mozilla.javascript.Context cx)
static Object	scope(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable thisObj, Object[] args, org.mozilla.javascript.Function funObj) The scope function creates a new JavaScript scope object with given Bindings object as backing store.
static Object	sync(org.mozilla.javascript.Context cx, org.mozilla.javascript.Scriptable thisObj, Object[] args, org.mozilla.javascript.Function funObj) The sync function creates a synchronized function (in the sense of a Java synchronized method) from an existing function.

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 Detail

DEBUG

public static final boolean DEBUG

See Also:

Constant Field Values

Constructor Detail

RhinoScriptEngine

public RhinoScriptEngine()

Creates a new instance of RhinoScriptEngine

Method Detail

eval

public Object eval(Reader reader,
          javax.script.ScriptContext ctxt)
            throws javax.script.ScriptException

Specified by:

eval in interface javax.script.ScriptEngine

Throws:

javax.script.ScriptException

eval

public Object eval(String script,
          javax.script.ScriptContext ctxt)
            throws javax.script.ScriptException

Specified by:

eval in interface javax.script.ScriptEngine

Throws:

javax.script.ScriptException

getFactory

public javax.script.ScriptEngineFactory getFactory()

Specified by:

getFactory in interface javax.script.ScriptEngine

createBindings

public javax.script.Bindings createBindings()

Specified by:

createBindings in interface javax.script.ScriptEngine

invokeFunction

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

Specified by:

invokeFunction in interface javax.script.Invocable

Throws:

javax.script.ScriptException

NoSuchMethodException

invokeMethod

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

Specified by:

invokeMethod in interface javax.script.Invocable

Throws:

javax.script.ScriptException

NoSuchMethodException

getInterface

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

Specified by:

getInterface in interface javax.script.Invocable

getInterface

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

Specified by:

getInterface in interface javax.script.Invocable

compile

public javax.script.CompiledScript compile(String script)
                                    throws javax.script.ScriptException

Specified by:

compile in interface javax.script.Compilable

Throws:

javax.script.ScriptException

compile

public javax.script.CompiledScript compile(Reader script)
                                    throws javax.script.ScriptException

Specified by:

compile in interface javax.script.Compilable

Throws:

javax.script.ScriptException

preProcessScriptSource

protected Reader preProcessScriptSource(Reader reader)
                                 throws javax.script.ScriptException

Throws:

javax.script.ScriptException

processAllTopLevelScripts

protected void processAllTopLevelScripts(org.mozilla.javascript.Context cx)

processTopLevelScript

protected void processTopLevelScript(String scriptName,
                         org.mozilla.javascript.Context cx)

bindings

public static Object bindings(org.mozilla.javascript.Context cx,
              org.mozilla.javascript.Scriptable thisObj,
              Object[] args,
              org.mozilla.javascript.Function funObj)

The bindings function takes a JavaScript scope object of type ExternalScriptable and returns the underlying Bindings instance. var page = scope(pageBindings); with (page) { // code that uses page scope } var b = bindings(page); // operate on bindings here.

scope

public static Object scope(org.mozilla.javascript.Context cx,
           org.mozilla.javascript.Scriptable thisObj,
           Object[] args,
           org.mozilla.javascript.Function funObj)

The scope function creates a new JavaScript scope object with given Bindings object as backing store. This can be used to create a script scope based on arbitrary Bindings instance. For example, in webapp scenario, a 'page' level Bindings instance may be wrapped as a scope and code can be run in JavaScripe 'with' statement: var page = scope(pageBindings); with (page) { // code that uses page scope }

sync

public static Object sync(org.mozilla.javascript.Context cx,
          org.mozilla.javascript.Scriptable thisObj,
          Object[] args,
          org.mozilla.javascript.Function funObj)

The sync function creates a synchronized function (in the sense of a Java synchronized method) from an existing function. The new function synchronizes on the this object of its invocation. js> var o = { f : sync(function(x) { print("entry"); Packages.java.lang.Thread.sleep(x*1000); print("exit"); })}; js> thread(function() {o.f(5);}); entry js> thread(function() {o.f(5);}); js> exit entry exit

main

public static void main(String[] args)
                 throws Exception

Throws:

Exception