JavaTM Platform
Standard Ed. 6

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 は次のものを使用します。



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

パラメータ:
nn - ENGINE_SCOPE に使用する Bindings
戻り値:
SimpleScriptContext

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。