oracle.jbo.script

Class ExprAbstractScriptEngine

java.lang.Object

oracle.jbo.script.ExprAbstractScriptEngine

All Implemented Interfaces:

javax.script.ScriptEngine

Direct Known Subclasses:

AbstractExprScriptEngine

public abstract class ExprAbstractScriptEngine
extends java.lang.Object
implements javax.script.ScriptEngine

Provides a standard implementation for several of the variants of the eval method.

eval(Reader)

eval(String)

eval(String, Bindings)

eval(Reader, Bindings)

are implemented using the abstract methods

eval(Reader,ScriptContext) or eval(String, ScriptContext)

with a ExprSimpleScriptContext.

A ExprSimpleScriptContext is used as the default ScriptContext of the ExprAbstractScriptEngine..

Since:

1.6

Field Summary

Fields

Modifier and Type	Field and Description
protected javax.script.ScriptContext	context The default ScriptContext of this ExprAbstractScriptEngine.

Fields inherited from interface javax.script.ScriptEngine

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

Constructor Summary

Constructors

Constructor and Description
ExprAbstractScriptEngine() Creates a new instance of ExprAbstractScriptEngine using a ExprSimpleScriptContext as its default ScriptContext.
ExprAbstractScriptEngine(javax.script.Bindings n) Creates a new instance using the specified Bindings as the ENGINE_SCOPE Bindings in the protected context field.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	eval(java.io.Reader reader) eval(Reader) calls the abstract eval(Reader, ScriptContext) passing the value of the context field.
java.lang.Object	eval(java.io.Reader reader, javax.script.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.
java.lang.Object	eval(java.lang.String script) Same as eval(Reader) except that the abstract eval(String, ScriptContext) is used.
java.lang.Object	eval(java.lang.String script, javax.script.Bindings bindings) Same as eval(Reader, Bindings) except that the abstract eval(String, ScriptContext) is used.
java.lang.Object	get(java.lang.String key) Gets the value for the specified key in the ENGINE_SCOPE of the protected context field.
javax.script.Bindings	getBindings(int scope) Returns the Bindings with the specified scope value in the protected context field.
javax.script.ScriptContext	getContext() Returns the value of the protected context field.
protected javax.script.ScriptContext	getScriptContext(javax.script.Bindings nn) Returns a ExprSimpleScriptContext.
void	put(java.lang.String key, java.lang.Object value) Sets the specified value with the specified key in the ENGINE_SCOPE Bindings of the protected context field.
void	setBindings(javax.script.Bindings bindings, int scope) Sets the Bindings with the corresponding scope value in the context field.
void	setContext(javax.script.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

Methods inherited from interface javax.script.ScriptEngine

createBindings, eval, eval, getFactory

Field Detail

context

protected javax.script.ScriptContext context

The default ScriptContext of this ExprAbstractScriptEngine.

Constructor Detail

ExprAbstractScriptEngine

public ExprAbstractScriptEngine()

Creates a new instance of ExprAbstractScriptEngine using a ExprSimpleScriptContext as its default ScriptContext.

ExprAbstractScriptEngine

public ExprAbstractScriptEngine(javax.script.Bindings n)

Creates a new instance using the specified Bindings as the ENGINE_SCOPE Bindings in the protected context field.

Parameters:

n - The specified Bindings.

Throws:

java.lang.NullPointerException - if n is null.

Method Detail

setContext

public void setContext(javax.script.ScriptContext ctxt)

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

Specified by:

setContext in interface javax.script.ScriptEngine

Parameters:

ctxt - The specified ScriptContext.

Throws:

java.lang.NullPointerException - if ctxt is null.

getContext

public javax.script.ScriptContext getContext()

Returns the value of the protected context field.

Specified by:

getContext in interface javax.script.ScriptEngine

Returns:

The value of the protected context field.

getBindings

public javax.script.Bindings getBindings(int scope)

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

Specified by:

getBindings in interface javax.script.ScriptEngine

Parameters:

scope - The specified scope

Returns:

The corresponding Bindings.

Throws:

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

setBindings

public void setBindings(javax.script.Bindings bindings,
                        int scope)

Sets the Bindings with the corresponding scope value in the context field.

Specified by:

setBindings in interface javax.script.ScriptEngine

Parameters:

bindings - The specified Bindings.

scope - The specified scope.

Throws:

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

java.lang.NullPointerException - if the bindings is null and the scope is ScriptContext.ENGINE_SCOPE

put

public void put(java.lang.String key,
                java.lang.Object value)

Sets the specified value with the specified key in the ENGINE_SCOPE Bindings of the protected context field.

Specified by:

put in interface javax.script.ScriptEngine

Parameters:

key - The specified key.

value - The specified value.

Throws:

java.lang.NullPointerException - if key is null.

java.lang.IllegalArgumentException - if key is empty.

get

public java.lang.Object get(java.lang.String key)

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

Specified by:

get in interface javax.script.ScriptEngine

Returns:

The value for the specified key.

Throws:

java.lang.NullPointerException - if key is null.

java.lang.IllegalArgumentException - if key is empty.

eval

public java.lang.Object eval(java.io.Reader reader,
                             javax.script.Bindings bindings)
                      throws javax.script.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 javax.script.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:

javax.script.ScriptException - if an error occurs in script.

java.lang.NullPointerException - if any of the parameters is null.

eval

public java.lang.Object eval(java.lang.String script,
                             javax.script.Bindings bindings)
                      throws javax.script.ScriptException

Same as eval(Reader, Bindings) except that the abstract eval(String, ScriptContext) is used.

Specified by:

eval in interface javax.script.ScriptEngine

Parameters:

script - A String containing the source of the script.

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

Returns:

The return value from eval(String, ScriptContext)

Throws:

javax.script.ScriptException - if an error occurs in script.

java.lang.NullPointerException - if any of the parameters is null.

eval

public java.lang.Object eval(java.io.Reader reader)
                      throws javax.script.ScriptException

eval(Reader) calls the abstract eval(Reader, ScriptContext) passing the value of the context field.

Specified by:

eval in interface javax.script.ScriptEngine

Parameters:

reader - A Reader containing the source of the script.

Returns:

The return value from eval(Reader, ScriptContext)

Throws:

javax.script.ScriptException - if an error occurs in script.

java.lang.NullPointerException - if any of the parameters is null.

eval

public java.lang.Object eval(java.lang.String script)
                      throws javax.script.ScriptException

Same as eval(Reader) except that the abstract eval(String, ScriptContext) is used.

Specified by:

eval in interface javax.script.ScriptEngine

Parameters:

script - A String containing the source of the script.

Returns:

The return value from eval(String, ScriptContext)

Throws:

javax.script.ScriptException - if an error occurrs in script.

java.lang.NullPointerException - if any of the parameters is null.

getScriptContext

protected javax.script.ScriptContext getScriptContext(javax.script.Bindings nn)

Returns a ExprSimpleScriptContext. The ExprSimpleScriptContext:

• 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 ExprSimpleScriptContext 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 ExprSimpleScriptContext