io.opsit.explang.jsr223

Class ExplangScriptEngine

java.lang.Object

io.opsit.explang.jsr223.ExplangScriptEngine

All Implemented Interfaces:

Invocable, ScriptEngine

public class ExplangScriptEngine
extends Object
implements ScriptEngine, Invocable

Field Summary

Fields

Modifier and Type	Field and Description
protected Compiler	comp
protected ScriptContext	defScriptContext
protected ScriptEngineFactory	factory

Fields inherited from interface javax.script.ScriptEngine

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

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ExplangScriptEngine()
protected	ExplangScriptEngine(Bindings bindings)
protected	ExplangScriptEngine(ScriptEngineFactory factory)

Method Summary

Modifier and Type	Method and Description
Bindings	createBindings()
Object	eval(Reader reader)
Object	eval(Reader reader, Bindings bindings) eval(Reader, Bindings) calls the abstract eval(Reader, ScriptContext) method, passing it a ScriptContext whose Reader, Writers and Bindings for scopes other that ENGINE_SCOPE are identical to those members of the protected context field.
Object	eval(Reader reader, ScriptContext context)
Object	eval(String script)
Object	eval(String script, Bindings bindings)
Object	eval(String script, ScriptContext context)
Object	get(String key) Gets the value for the specified key in the ENGINE_SCOPE of the protected context field.
Bindings	getBindings(int scope) Returns the Bindings with the specified scope value in the protected context field.
ScriptContext	getContext()
ScriptEngineFactory	getFactory()
<T> T	getInterface(Class<T> clasz)
<T> T	getInterface(Object thiz, Class<T> clasz)
protected ScriptContext	getScriptContext(Bindings nn) Returns a SimpleScriptContext.
Object	invokeFunction(String name, Object... args)
Object	invokeMethod(Object thiz, String name, Object... args)
protected Compiler.ICtx	makeCtx(ScriptContext sc)
void	put(String key, Object value)
void	setBindings(Bindings bindings, int scope)
void	setContext(ScriptContext ctxt) Sets the value of the protected context field to the specified ScriptContext .

Methods inherited from class java.lang.Object

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

Field Detail

factory

protected final ScriptEngineFactory factory

defScriptContext

protected ScriptContext defScriptContext

comp

protected Compiler comp

Constructor Detail

ExplangScriptEngine

protected ExplangScriptEngine(Bindings bindings)

ExplangScriptEngine

protected ExplangScriptEngine()

ExplangScriptEngine

protected ExplangScriptEngine(ScriptEngineFactory factory)

Method Detail

makeCtx

protected Compiler.ICtx makeCtx(ScriptContext sc)

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

eval

public Object eval(String script)
            throws ScriptException

Specified by:

eval in interface ScriptEngine

Throws:

ScriptException

eval

public Object eval(Reader reader)
            throws ScriptException

Specified by:

eval in interface ScriptEngine

Throws:

ScriptException

eval

public Object eval(String script,
                   Bindings bindings)
            throws ScriptException

Specified by:

eval in interface ScriptEngine

Throws:

ScriptException

eval

public Object eval(Reader reader,
                   Bindings bindings)
            throws ScriptException

eval(Reader, Bindings) calls the abstract eval(Reader, ScriptContext) method, passing it a ScriptContext whose Reader, Writers and Bindings for scopes other that ENGINE_SCOPE are identical to those members of the protected context field. The specified Bindings is used instead of the ENGINE_SCOPE Bindings of the context field.

Specified by:

eval in interface ScriptEngine

Parameters:

reader - A Reader containing the source of the script.

bindings - A Bindings to use for the ENGINE_SCOPE while the script executes.

Returns:

The return value from eval(Reader, ScriptContext)

Throws:

ScriptException - if an error occurs in script.

NullPointerException - if any of the parameters is null.

put

public void put(String key,
                Object value)

Specified by:

put in interface ScriptEngine

get

public Object get(String key)

Gets the value for the specified key in the ENGINE_SCOPE of the protected context field.

Specified by:

get in interface ScriptEngine

Returns:

The value for the specified key.

Throws:

NullPointerException - if key is null.

IllegalArgumentException - if key is empty.

getBindings

public Bindings getBindings(int scope)

Returns the Bindings with the specified scope value in the protected context field.

Specified by:

getBindings in interface ScriptEngine

Parameters:

scope - The specified scope

Returns:

The corresponding Bindings.

Throws:

IllegalArgumentException - if the value of scope is invalid for the type the protected context field.

setBindings

public void setBindings(Bindings bindings,
                        int scope)

Specified by:

setBindings in interface ScriptEngine

createBindings

public Bindings createBindings()

Specified by:

createBindings in interface ScriptEngine

getContext

public ScriptContext getContext()

Specified by:

getContext in interface ScriptEngine

setContext

public void setContext(ScriptContext ctxt)

Sets the value of the protected context field to the specified ScriptContext .

Specified by:

setContext in interface ScriptEngine

Parameters:

ctxt - The specified ScriptContext.

Throws:

NullPointerException - if ctxt is null.

getFactory

public ScriptEngineFactory getFactory()

Specified by:

getFactory in interface ScriptEngine

getScriptContext

protected ScriptContext getScriptContext(Bindings nn)

Returns a SimpleScriptContext. The SimpleScriptContext:

• Uses the specified Bindings for its ENGINE_SCOPE
• Uses the Bindings returned by the abstract getGlobalScope method as its GLOBAL_SCOPE
• Uses the Reader and Writer in the default ScriptContext of this ScriptEngine

A SimpleScriptContext returned by this method is used to implement eval methods using the abstract eval(Reader,Bindings) and eval(String,Bindings) versions.

Parameters:

nn - Bindings to use for the ENGINE_SCOPE

Returns:

The SimpleScriptContext

invokeMethod

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

Specified by:

invokeMethod in interface Invocable

Throws:

ScriptException

NoSuchMethodException

invokeFunction

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

Specified by:

invokeFunction 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