- java.lang.Object
-
- javax.script.AbstractScriptEngine
-
- jdk.nashorn.api.scripting.NashornScriptEngine
-
- すべての実装されたインタフェース:
Compilable,Invocable,ScriptEngine
public final class NashornScriptEngine extends AbstractScriptEngine implements Compilable, Invocable
NashornのJSR-223準拠スクリプト・エンジン。 インスタンスは直接作成されず、NashornScriptEngineFactory.getScriptEngine()から返されます。 このエンジンはCompilableおよびInvocableインタフェースを実装し、スクリプトの効率的なプリコンパイルと繰り返し実行を可能にします。- 導入されたバージョン:
- 1.8u40
- 関連項目:
NashornScriptEngineFactory
-
-
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 static StringNASHORN_GLOBAL任意のBindingsインスタンスにNashornグローバル・オブジェクト・ミラーを関連付けるためのキー。-
クラスjavax.script.AbstractScriptEngineから継承されたフィールド
context
-
インタフェース javax.script.ScriptEngineから継承されたフィールド
ARGV, ENGINE, ENGINE_VERSION, FILENAME, LANGUAGE, LANGUAGE_VERSION, NAME
-
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 CompiledScriptcompile(Reader reader)あとで実行するために、スクリプト(Readerから読み込まれるソース)をコンパイルします。CompiledScriptcompile(String str)あとで実行するために、スクリプト(Stringとして表されるソース)をコンパイルします。BindingscreateBindings()初期化されていないBindingsを返します。Objecteval(Reader reader, ScriptContext ctxt)スクリプトのソースがReaderから読み込まれる場合、eval(String, ScriptContext)と同じです。Objecteval(String script, ScriptContext ctxt)ソースが1番目の引数として渡されたStringであるスクリプトをただちに実行します。ScriptEngineFactorygetFactory()このScriptEngineが属するクラスのScriptEngineFactoryを返します。<T> TgetInterface(Class<T> clazz)インタプリタでコンパイルされた関数を使用して、インタフェースの実装を返します。<T> TgetInterface(Object thiz, Class<T> clazz)インタプリタでコンパイルされたスクリプト・オブジェクトのメンバー関数を使用して、インタフェースの実装を返します。ObjectinvokeFunction(String name, Object... args)スクリプト内で定義されたトップ・レベルの手続きと関数を呼び出すために使用されます。ObjectinvokeMethod(Object thiz, String name, Object... args)ScriptEngineの状態に保持されている、以前のスクリプトの実行中にコンパイルされたスクリプト・オブジェクト上のメソッドを呼び出します。-
クラスjavax.script.AbstractScriptEngineから継承されたメソッド
eval, eval, eval, eval, get, getBindings, getContext, getScriptContext, put, setBindings, setContext
-
-
-
-
メソッドの詳細
-
eval
public Object eval(Reader reader, ScriptContext ctxt) throws ScriptException
インタフェースからコピーされた説明:ScriptEngineスクリプトのソースがReaderから読み込まれる場合、eval(String, ScriptContext)と同じです。- 定義:
eval、インタフェース:ScriptEngine- パラメータ:
reader- スクリプト・エンジンによって実行されるスクリプトのソース。ctxt- スクリプト・エンジンに渡されるScriptContext。- 戻り値:
- スクリプトの実行によって返される値。
- 例外:
ScriptException- スクリプトでエラーが発生した場合。 ScriptEnginesは、基本となるスクリプトの実装によってスローされたチェック例外のScriptExceptionラッパーを作成およびスローする必要があります。
-
eval
public Object eval(String script, ScriptContext ctxt) throws ScriptException
インタフェースからコピーされた説明:ScriptEngineソースが1番目の引数として渡されたStringであるスクリプトをただちに実行します。 スクリプトは、実行前に再解析または再コンパイルされる可能性があります。 変数値およびコンパイル済み手続きを含む、以前の実行でエンジンに残された状態は、この実行中に可視である可能性があります。- 定義:
eval、インタフェース:ScriptEngine- パラメータ:
script- スクリプト・エンジンによって実行されるスクリプト。ctxt- 異なるスコープ内の属性セットを公開するScriptContext。 スコープScriptContext.ENGINE_SCOPEおよびScriptContext.GLOBAL_SCOPEの意味は、仕様で定義されている。ScriptContextのENGINE_SCOPEBindingsには、このスクリプトの実行中に使用される、アプリケーション・オブジェクトへのスクリプト変数のバインディングが含まれます。- 戻り値:
- スクリプトの実行によって返される値。
- 例外:
ScriptException- スクリプトでエラーが発生した場合。 ScriptEnginesは、基本となるスクリプトの実装によってスローされたチェック例外のScriptExceptionラッパーを作成およびスローする必要があります。
-
getFactory
public ScriptEngineFactory getFactory()
インタフェースからコピーされた説明:ScriptEngineこのScriptEngineが属するクラスのScriptEngineFactoryを返します。- 定義:
- インタフェース
ScriptEngineのgetFactory - 戻り値:
ScriptEngineFactory
-
createBindings
public Bindings createBindings()
インタフェースからコピーされた説明:ScriptEngine初期化されていないBindingsを返します。- 定義:
- インタフェース
ScriptEngineのcreateBindings - 戻り値:
- この
ScriptEngineの状態を置換するために使用可能なBindings。
-
compile
public CompiledScript compile(Reader reader) throws ScriptException
インタフェースからコピーされた説明:Compilableあとで実行するために、スクリプト(Readerから読み込まれるソース)をコンパイルします。 ソースが渡される方法を除いて、機能はcompile(String)と同じです。- 定義:
- インタフェース
Compilableのcompile - パラメータ:
reader- スクリプト・ソースの取得元となるリーダー。- 戻り値:
CompiledScriptのevalメソッドのいずれかを使用して後で実行されるCompiledScriptのサブクラスのインスタンス。- 例外:
ScriptException- コンパイルに失敗した場合。
-
compile
public CompiledScript compile(String str) throws ScriptException
インタフェースからコピーされた説明:Compilableあとで実行するために、スクリプト(Stringとして表されるソース)をコンパイルします。- 定義:
- インタフェース
Compilableのcompile - パラメータ:
str-Stringとして表されるスクリプトのソース。- 戻り値:
CompiledScriptのevalメソッドのいずれかを使用して後で実行されるCompiledScriptのサブクラスのインスタンス。- 例外:
ScriptException- コンパイルに失敗した場合。
-
invokeFunction
public Object invokeFunction(String name, Object... args) throws ScriptException, NoSuchMethodException
インタフェースからコピーされた説明:Invocableスクリプト内で定義されたトップ・レベルの手続きと関数を呼び出すために使用されます。- 定義:
- インタフェース
InvocableのinvokeFunction - パラメータ:
name- 呼び出す手続きまたは関数の名前args- 手続きまたは関数に渡される引数- 戻り値:
- 手続きまたは関数によって返される値
- 例外:
ScriptException- メソッドの呼出し中にエラーが発生した場合。NoSuchMethodException- 指定された名前またはマッチングの引数型を持つメソッドが見つからない場合。
-
invokeMethod
public Object invokeMethod(Object thiz, String name, Object... args) throws ScriptException, NoSuchMethodException
インタフェースからコピーされた説明:InvocableScriptEngineの状態に保持されている、以前のスクリプトの実行中にコンパイルされたスクリプト・オブジェクト上のメソッドを呼び出します。- 定義:
- インタフェース
InvocableのinvokeMethod - パラメータ:
thiz- 手続きがスクリプト内で定義されたクラスのメンバーであり、thizが以前の実行または呼出しによって返されたクラスのインスタンスである場合は、そのインスタンスを使用して名前付きメソッドが呼び出される。name- 呼び出される手続きの名前。args- 手続きに渡される引数。 引数をスクリプト変数に変換する規則は、実装により固有。- 戻り値:
- 手続きによって返される値。 スクリプト・メソッドにより返されたスクリプト変数をJavaオブジェクトに変換する規則は、実装により固有。
- 例外:
ScriptException- メソッドの呼出し中にエラーが発生した場合。NoSuchMethodException- 指定された名前またはマッチングの引数型を持つメソッドが見つからない場合。
-
getInterface
public <T> T getInterface(Class<T> clazz)
インタフェースからコピーされた説明:Invocableインタプリタでコンパイルされた関数を使用して、インタフェースの実装を返します。 インタフェースのメソッドは、invokeFunctionメソッドを使用して実装することができます。- 定義:
- インタフェース
InvocableのgetInterface - 型パラメータ:
T- 返すインタフェースの型- パラメータ:
clazz- 返すインタフェースのClassオブジェクト。- 戻り値:
- 要求されたインタフェースのインスタンス。要求されたインタフェースが見つからない場合、すなわち
ScriptEngine内でコンパイル済み関数が、要求されたインタフェース内のどの関数とも一致しない場合はnull。
-
getInterface
public <T> T getInterface(Object thiz, Class<T> clazz)
インタフェースからコピーされた説明:Invocableインタプリタでコンパイルされたスクリプト・オブジェクトのメンバー関数を使用して、インタフェースの実装を返します。 インタフェースのメソッドは、invokeMethodメソッドを使用して実装することができます。- 定義:
- インタフェース
InvocableのgetInterface - 型パラメータ:
T- 返すインタフェースの型- パラメータ:
thiz- インタフェースのメソッドを実装するために使用されるメンバー関数を持つスクリプト・オブジェクト。clazz- 返すインタフェースのClassオブジェクト。- 戻り値:
- 要求されたインタフェースのインスタンス。要求されたインタフェースが見つからない場合、すなわち
ScriptEngine内のコンパイル済みメソッドが、要求されたインタフェース内のどのメソッドとも一致しない場合はnull。
-
-