javax.script

インタフェース Invocable

public interface Invocable

以前に実行されたスクリプト内の手続きの呼び出しを許可するメソッドを持つ ScriptEngines によって実装されるオプションのインタフェースです。

導入されたバージョン:

1.6

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
<T> T	getInterface(Class<T> clasz) インタプリタでコンパイルされた関数を使用して、インタフェースの実装を返します。
<T> T	getInterface(Object thiz, Class<T> clasz) インタプリタでコンパイルされたスクリプトオブジェクトのメンバー関数を使用して、インタフェースの実装を返します。
Object	invokeFunction(String name, Object... args) スクリプト内で定義されたトップレベルの手続きと関数を呼び出すために使用されます。
Object	invokeMethod(Object thiz, String name, Object... args) ScriptEngine の状態に保持されている、以前のスクリプトの実行中にコンパイルされたスクリプトオブジェクト上のメソッドを呼び出します。

メソッドの詳細

invokeMethod

Object invokeMethod(Object thiz,
                  String name,
                  Object... args)
                    throws ScriptException,
                           NoSuchMethodException

ScriptEngine の状態に保持されている、以前のスクリプトの実行中にコンパイルされたスクリプトオブジェクト上のメソッドを呼び出します。

パラメータ:

name - 呼び出される手続きの名前。

thiz - 手続きがスクリプト内で定義されたクラスのメンバーであり、thiz が以前の実行または呼び出しによって返されたクラスのインスタンスである場合は、そのインスタンスを使用して名前付きメソッドが呼び出される。

args - 手続きに渡される引数。引数をスクリプト変数に変換する規則は、実装により固有。

戻り値:

手続きによって返される値。スクリプトメソッドにより返されたスクリプト変数を Java オブジェクトに変換する規則は、実装により固有。

例外:

ScriptException - メソッドの呼び出し中にエラーが発生した場合。

NoSuchMethodException - 指定された名前またはマッチングの引数型を持つメソッドが見つからない場合。

NullPointerException - メソッド名が null の場合。

IllegalArgumentException - 指定された thiz が null の場合、または指定されたオブジェクトがスクリプトオブジェクトを表していない場合。

invokeFunction

Object invokeFunction(String name,
                    Object... args)
                      throws ScriptException,
                             NoSuchMethodException

スクリプト内で定義されたトップレベルの手続きと関数を呼び出すために使用されます。

パラメータ:

args - 手続きまたは関数に渡される引数

戻り値:

手続きまたは関数によって返される値

例外:

ScriptException - メソッドの呼び出し中にエラーが発生した場合。

NoSuchMethodException - 指定された名前またはマッチングの引数型を持つメソッドが見つからない場合。

NullPointerException - メソッド名が null の場合。

getInterface

<T> T getInterface(Class<T> clasz)

インタプリタでコンパイルされた関数を使用して、インタフェースの実装を返します。インタフェースのメソッドは、invokeFunction メソッドを使用して実装することができます。

パラメータ:

clasz - 返すインタフェースの Class オブジェクト。

戻り値:

要求されたインタフェースのインスタンス。要求されたインタフェースが見つからない場合、すなわち ScriptEngine 内でコンパイル済み関数が、要求されたインタフェース内のどの関数とも一致しない場合は null。

例外:

IllegalArgumentException - 指定された Class オブジェクトが null の場合、またはインタフェースではない場合。

getInterface

<T> T getInterface(Object thiz,
                 Class<T> clasz)

インタプリタでコンパイルされたスクリプトオブジェクトのメンバー関数を使用して、インタフェースの実装を返します。インタフェースのメソッドは、invokeMethod メソッドを使用して実装することができます。

パラメータ:

thiz - インタフェースのメソッドを実装するために使用されるメンバー関数を持つスクリプトオブジェクト。

clasz - 返すインタフェースの Class オブジェクト。

戻り値:

要求されたインタフェースのインスタンス。要求されたインタフェースが見つからない場合、すなわち ScriptEngine 内のコンパイル済みメソッドが、要求されたインタフェース内のどのメソッドとも一致しない場合は null。

例外:

IllegalArgumentException - 指定された Class オブジェクトが null の場合、またはインタフェースではない場合、あるいは指定されたオブジェクトが null の場合、またはスクリプトオブジェクトを表していない場合。