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)

上記は次の abstract メソッドを使用して実装されます。

eval(Reader,ScriptContext) または eval(String, ScriptContext)

その際、SimpleScriptContext を指定します。

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) 抽象メソッドを呼び出します。
Object	eval(Reader reader, Bindings bindings) eval(Reader, Bindings) は eval(Reader, ScriptContext) 抽象メソッドを呼び出します。
Object	eval(String script) eval(Reader) と同じです。
Object	eval(String script, Bindings bindings) 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) 保護された 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 に設定します。

定義:

インタフェース ScriptEngine 内の setContext

パラメータ:

ctxt - 指定された ScriptContext。

例外:

NullPointerException - ctxt が null の場合。

getContext

public ScriptContext getContext()

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

定義:

インタフェース ScriptEngine 内の getContext

戻り値:

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

getBindings

public Bindings getBindings(int scope)

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

定義:

インタフェース ScriptEngine 内の getBindings

パラメータ:

scope - 指定されたスコープ

戻り値:

対応する Bindings。

例外:

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

setBindings

public void setBindings(Bindings bindings,
                        int scope)

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

定義:

インタフェース ScriptEngine 内の setBindings

パラメータ:

bindings - 指定された Bindings。

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

例外:

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

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

put

public void put(String key,
                Object value)

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

定義:

インタフェース ScriptEngine 内の put

パラメータ:

key - 指定されたキー。

value - 指定された値。

例外:

NullPointerException - key が null の場合。

IllegalArgumentException - key が空の場合。

get

public Object get(String key)

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

定義:

インタフェース ScriptEngine 内の get

パラメータ:

key - 値が返されるキー

戻り値:

指定されたキーの値。

例外:

NullPointerException - key が 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 を受け渡します。context フィールドの ENGINE_SCOPE Bindings ではなく、指定された Bindings が使用されます。

定義:

インタフェース ScriptEngine 内の eval

パラメータ:

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

bindings - スクリプトの実行時に ENGINE_SCOPE のために使用する Bindings。

戻り値:

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

例外:

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

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

eval

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

eval(Reader, Bindings) と同じです。ただし、eval(String, ScriptContext) 抽象メソッドが使用される点が異なります。

定義:

インタフェース ScriptEngine 内の eval

パラメータ:

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 フィールドの値を渡します。

定義:

インタフェース ScriptEngine 内の eval

パラメータ:

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

戻り値:

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

例外:

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

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

eval

public Object eval(String script)
            throws ScriptException

eval(Reader) と同じです。ただし、eval(String, ScriptContext) 抽象メソッドが使用される点が異なります。

定義:

インタフェース ScriptEngine 内の eval

パラメータ:

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

戻り値:

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

例外:

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

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

getScriptContext

protected ScriptContext getScriptContext(Bindings nn)

SimpleScriptContext を返します。SimpleScriptContext は次のものを使用します。

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

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

パラメータ:

nn - ENGINE_SCOPE に使用する Bindings

戻り値:

SimpleScriptContext