モジュール 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