モジュール java.scripting

パッケージ javax.script

クラスAbstractScriptEngine

java.lang.Object

javax.script.AbstractScriptEngine

すべての実装されたインタフェース:

ScriptEngine

public abstract class AbstractScriptEngine extends Object implements ScriptEngine

evalメソッドの複数のバリアントに対する標準の実装を提供します。

eval(Reader)

eval(String)

eval(String, Bindings)

eval(Reader, Bindings)

は、抽象メソッド

eval(Reader,ScriptContext)またはSimpleScriptContextを使用してeval(String, ScriptContext)

で実装されます。

SimpleScriptContextは、AbstractScriptEngineのデフォルトのScriptContextとして使用されます。

導入されたバージョン:

1.6

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
protected ScriptContext	context	このAbstractScriptEngineのデフォルトのScriptContextです。

インタフェースjavax.script.ScriptEngineで宣言されているフィールド

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

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
AbstractScriptEngine()	SimpleScriptContextをデフォルトのScriptContextとして使用して、AbstractScriptEngineの新しいインスタンスを作成します。
AbstractScriptEngine(Bindings n)	指定されたBindingsを、保護されたcontextフィールド内のENGINE_SCOPE Bindingsとして使用して、新しいインスタンスを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
Object	eval(Reader reader)	eval(Reader)は、eval(Reader, ScriptContext)抽象メソッドを呼び出します。その際、contextフィールドの値を渡します。
Object	eval(Reader reader, Bindings bindings)	eval(Reader, Bindings)はeval(Reader, ScriptContext)抽象メソッドを呼び出します。その際、ENGINE_SCOPEではなくReader、Writers、およびBindingsが、保護されたcontextフィールドのメンバーと等しいScriptContextを受け渡します。
Object	eval(String script)	abstract eval(String, ScriptContext)が使用される点を除けば、eval(Reader)と同じです。
Object	eval(String script, Bindings bindings)	abstract eval(String, ScriptContext)が使用される点を除けば、eval(Reader, Bindings)と同じです。
Object	get(String key)	保護されたcontextフィールドのENGINE_SCOPE内に指定されたキーを持つ値を取得します。
Bindings	getBindings(int scope)	保護されたcontextフィールド内に指定されたスコープ値を持つBindingsを返します。
ScriptContext	getContext()	保護されたcontextフィールドの値を返します。
protected ScriptContext	getScriptContext(Bindings nn)	SimpleScriptContextを返します。
void	put(String key, Object value)	protected contextフィールドのENGINE_SCOPE Bindings内で、指定されたキーの指定された値を設定します。
void	setBindings(Bindings bindings, int scope)	contextフィールド内に対応するスコープ値を持つBindingsを設定します。
void	setContext(ScriptContext ctxt)	保護されたcontextフィールドの値を、指定されたScriptContextに設定します。

クラスjava.lang.Objectで宣言されたメソッド

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

インタフェースjavax.script.ScriptEngineで宣言されたメソッド

createBindings, eval, eval, getFactory

フィールド詳細

context

protected ScriptContext context

このAbstractScriptEngineのデフォルトのScriptContextです。

コンストラクタの詳細

AbstractScriptEngine

public AbstractScriptEngine()

SimpleScriptContextをデフォルトのScriptContextとして使用して、AbstractScriptEngineの新しいインスタンスを作成します。

AbstractScriptEngine

public AbstractScriptEngine(Bindings n)

指定されたBindingsを、保護されたcontextフィールド内のENGINE_SCOPE Bindingsとして使用して、新しいインスタンスを作成します。

パラメータ:

n - 指定されたBindings。

例外:

NullPointerException - nがnullの場合。

メソッドの詳細

setContext

public void setContext(ScriptContext ctxt)

保護されたcontextフィールドの値を、指定されたScriptContextに設定します。

定義:

setContext、インタフェースScriptEngine

パラメータ:

ctxt - 指定されたScriptContext。

例外:

NullPointerException - ctxtがnullの場合。

getContext

public ScriptContext getContext()

保護されたcontextフィールドの値を返します。

定義:

getContext、インタフェースScriptEngine

戻り値:

保護されたcontextフィールドの値。

getBindings

public Bindings getBindings(int scope)

保護されたcontextフィールド内に指定されたスコープ値を持つBindingsを返します。

定義:

getBindings、インタフェースScriptEngine

パラメータ:

scope - 指定されたスコープ

戻り値:

対応するBindings。

例外:

IllegalArgumentException - スコープの値が、保護されたcontextフィールドの型に対して無効な場合。

setBindings

public void setBindings(Bindings bindings, int scope)

contextフィールド内に対応するスコープ値を持つBindingsを設定します。

定義:

setBindings、インタフェースScriptEngine

パラメータ:

bindings - 指定されたBindings。

scope - 指定されたスコープ。

例外:

IllegalArgumentException - スコープの値が、contextフィールドの型に対して無効な場合。

NullPointerException - bindingsがnullで、スコープがScriptContext.ENGINE_SCOPEである場合

put

public void put(String key, Object value)

protected contextフィールドのENGINE_SCOPE Bindings内で、指定されたキーの指定された値を設定します。

定義:

put、インタフェースScriptEngine

パラメータ:

key - 指定されたキー。

value - 指定された値。

例外:

NullPointerException - キーがnullの場合。

IllegalArgumentException - keyが空の場合。

get

public Object get(String key)

保護されたcontextフィールドのENGINE_SCOPE内に指定されたキーを持つ値を取得します。

定義:

get、インタフェースScriptEngine

パラメータ:

key - 値が返されるキー

戻り値:

指定されたキーの値。

例外:

NullPointerException - キーがnullの場合。

IllegalArgumentException - keyが空の場合。

eval

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

eval(Reader, Bindings)はeval(Reader, ScriptContext)抽象メソッドを呼び出します。その際、ENGINE_SCOPEではなくReader、Writers、およびBindingsが、保護されたcontextフィールドのメンバーと等しいScriptContextを受け渡します。 ENGINE_SCOPEの代わりに、指定されたBindingsが使用されますcontextフィールドのBindings。

定義:

eval、インタフェースScriptEngine

パラメータ:

reader - スクリプトのソースを格納するReader。

bindings - スクリプトの実行時にENGINE_SCOPEとして使用するBindings。

戻り値:

eval(Reader, ScriptContext)からの戻り値

例外:

ScriptException - スクリプトでエラーが発生した場合。

NullPointerException - パラメータのいずれかがnullの場合。

eval

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

abstract eval(String, ScriptContext)が使用される点を除けば、eval(Reader, Bindings)と同じです。

定義:

eval、インタフェースScriptEngine

パラメータ:

script - スクリプトのソースを格納するString。

bindings - スクリプトの実行時にENGINE_SCOPEとして使用するBindings。

戻り値:

eval(String, ScriptContext)からの戻り値

例外:

ScriptException - スクリプトでエラーが発生した場合。

NullPointerException - パラメータのいずれかがnullの場合。

eval

public Object eval(Reader reader) throws ScriptException

eval(Reader)は、eval(Reader, ScriptContext)抽象メソッドを呼び出します。その際、contextフィールドの値を渡します。

定義:

eval、インタフェースScriptEngine

パラメータ:

reader - スクリプトのソースを格納するReader。

戻り値:

eval(Reader, ScriptContext)からの戻り値

例外:

ScriptException - スクリプトでエラーが発生した場合。

NullPointerException - パラメータのいずれかがnullの場合。

eval

public Object eval(String script) throws ScriptException

abstract eval(String, ScriptContext)が使用される点を除けば、eval(Reader)と同じです。

定義:

eval、インタフェースScriptEngine

パラメータ:

script - スクリプトのソースを格納するString。

戻り値:

eval(String, ScriptContext)からの戻り値

例外:

ScriptException - スクリプトでエラーが発生した場合。

NullPointerException - パラメータのいずれかがnullの場合。

getScriptContext

protected ScriptContext getScriptContext(Bindings nn)

SimpleScriptContextを返します。 SimpleScriptContext:

• そのENGINE_SCOPEとして指定されたBindingsを使用する
• GLOBAL_SCOPEとしてgetGlobalScope抽象メソッドによって返されるBindingsを使用する
• このScriptEngineのデフォルトのScriptContext内にあるReaderおよびWriterを使用する

このメソッドによって返されるSimpleScriptContextは、eval(Reader,Bindings)およびeval(String,Bindings)の抽象バージョンを使用して、evalメソッドを実装するのに使用されます。

パラメータ:

nn - ENGINE_SCOPEに使用するBindings。

戻り値:

SimpleScriptContext