クラス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です。

    インタフェースで宣言されたフィールド ScriptEngine

    ARGV, ENGINE, ENGINE_VERSION, FILENAME, LANGUAGE, LANGUAGE_VERSION, NAME
    修飾子と型
    フィールド
    説明
    static final String
    ARGV
    位置引数の配列をスクリプトに渡す名前付き値の予約済みキーです。
    static final String
    ENGINE
    ScriptEngine実装の名前である名前付き値の予約済みキーです。
    static final String
    ENGINE_VERSION
    ScriptEngine実装のバージョンを識別する名前付き値の予約済みキーです。
    static final String
    FILENAME
    実行中のファイルの名前である名前付き値の予約済みキーです。
    static final String
    LANGUAGE
    実装がサポートするスクリプト言語の完全な名前である名前付き値の予約済みキーです。
    static final String
    LANGUAGE_VERSION
    実装がサポートするスクリプト言語のバージョンを識別する名前付き値の予約済みキーです。
    static final String
    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に設定します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

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

    createBindings, eval, eval, getFactory
    修飾子と型
    メソッド
    説明
    Bindings
    createBindings()
    初期化されていないBindingsを返します。
    Object
    eval(Reader reader, ScriptContext context)
    スクリプトのソースがReaderから読み込まれる場合、eval(String, ScriptContext)と同じです。
    Object
    eval(String script, ScriptContext context)
    ソースが1番目の引数として渡されたStringであるスクリプトをただちに実行します。
    ScriptEngineFactory
    getFactory()
    このScriptEngineが属するクラスのScriptEngineFactoryを返します。

  • フィールド詳細

    • 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