パッケージ javax.script

スクリプト API は、Java ^TM スクリプトエンジンを定義するインタフェースとクラスで構成され、それらを Java アプリケーションで使用するためのフレームワークを提供します。

参照先:
説明

インタフェースの概要

Bindings	キーが Strings であるすべてのキーと値のペアのマッピングです。
Compilable	再コンパイルを行わずに繰り返し実行可能なフォームにスクリプトをコンパイルするメソッドを持つ ScriptEngines によって実装されるオプションのインタフェースです。
Invocable	以前に実行されたスクリプト内の手続きの呼び出しを許可するメソッドを持つ ScriptEngines によって実装されるオプションのインタフェースです。
ScriptContext	このインタフェースを実装するクラスは、アプリケーションでスクリプトエンジンと、スコープ設定された Bindings などのオブジェクトとを接続するために使用されます。
ScriptEngine	ScriptEngine は、この仕様のすべての実装で完全に機能することが必要なメソッドを持つ基本インタフェースです。
ScriptEngineFactory	ScriptEngineFactory は、ScriptEngines の説明およびインスタンス化に使用されます。

クラスの概要

AbstractScriptEngine	eval メソッドの複数のバリアントに対する標準の実装を提供します。
CompiledScript	コンパイルの結果を格納するクラスによって拡張されます。
ScriptEngineManager	ScriptEngineManager は、ScriptEngine クラスの検出およびインスタンス化機構を実装します。
SimpleBindings	HashMap または指定されたほかの Map によって補助される Bindings の単純な実装です。
SimpleScriptContext	ScriptContext の単純な実装です。

例外の概要

ScriptException

スクリプト API の総称 Exception クラスです。

パッケージ javax.script の説明

スクリプト API は、Java ^TM スクリプトエンジンを定義するインタフェースとクラスで構成され、それらを Java アプリケーションで使用するためのフレームワークを提供します。この API は、スクリプト言語で記述されたプログラムを Java アプリケーション内で実行するアプリケーションプログラマを対象としています。通常、スクリプト言語のプログラムは、アプリケーションのエンドユーザーによって提供されます。

javax.script パッケージの主な機能は次のとおりです。

1. スクリプトの実行: スクリプトとは、スクリプトエンジンによって実行されるプログラムのソースとして使用される文字のストリームです。スクリプトの実行では、ScriptEngine の eval メソッドと Invocable インタフェースのメソッドが使用されます。

2. バインディング: この機能によって、Java オブジェクトを名前付き変数としてスクリプトプログラムに公開できます。Bindings および ScriptContext の各クラスは、この目的で使用されます。

3. コンパイル: この機能によって、スクリプトエンジンのフロントエンドによって生成された中間コードを格納し、繰り返し実行することができます。これは、同じスクリプトを複数回実行するアプリケーションの場合に便利です。エンジンのフロントエンドはスクリプト実行のたびにではなく、スクリプトごとに 1 回だけ実行すればよいので、これらのアプリケーションの効率を向上させることができます。この機能はオプションであり、スクリプトエンジンが実装しない可能性があることに注意してください。呼び出し側で、instanceof チェックを使用して、Compilable インタフェースが利用可能かどうかをチェックする必要があります。

4. 呼び出し: この機能によって、スクリプトエンジンのフロントエンドによって生成された中間コードを再利用することができます。コンパイルでは中間コードによって表されるスクリプト全体の再実行が可能になるのに対して、呼び出しの機能ではスクリプト内の個々の手続き/メソッドが再実行可能になります。コンパイルの場合にはあることですが、すべてのスクリプトエンジンでこの機能が提供される必要はありません。呼び出し側で、Invocable が利用可能かどうかをチェックする必要があります。

5. スクリプトエンジンの検出とメタデータ: スクリプト API に記述されたアプリケーションは、スクリプトエンジンに対して固有の要件を持つ可能性があります。固有のスクリプト言語またはバージョン、あるいはその両方を必要とするものがある一方で、固有の実装エンジンまたはバージョン、あるいはその両方を必要とするものもあります。スクリプトエンジンは、実行時の検出と属性の照会が可能となるように、指定された方法でパッケージ化されます。エンジンの検出機構は、「Jar ファイルの概要」に説明されるサービスの検出機構に基づいています。スクリプトエンジンの実装クラスは、META-INF/services/javax.script.ScriptEngineFactory というテキストリソースを含む jar ファイルにパッケージ化されます。このリソースには、jar ファイルにパッケージ化されている ScriptEngineFactory ごとに 1 行ずつが含まれている必要があります。ScriptEngineManager には、この機構を使用してすべての ScriptEngineFactory インスタンスが検出されるようにするために、getEngineFactories メソッドが含まれます。ScriptEngineFactory には、スクリプトエンジンに関する属性を照会するためのメソッドが含まれます。

導入されたバージョン:

1.6