java.lang.Object
javax.script.ScriptEngineManager
public class ScriptEngineManager extends Object
ScriptEngineManager
は、ScriptEngine
クラスの検出およびインスタンス化メカニズムを実装します。また、Managerが作成したすべてのエンジンで共有される状態を格納するキーと値のペアのコレクションを維持します。 このクラスは、ScriptEngineFactory
のすべての実装を列挙するために、ServiceLoader
クラスに記述されているサービス・プロバイダ・メカニズムを使用します。 ScriptEngineManager
は、言語名、ファイル拡張子、およびMIMEタイプに基づいてファクトリを検索するユーティリティ・メソッドと、これらすべてのファクトリのリストを返すメソッドを提供します。
マネージャによって管理され、「グローバル・スコープ」として参照されるキーと値のペアのBindings
は、ScriptEngineManager
が作成したScriptEngine
のすべてのインスタンスで利用可能です。 通常、Bindings
の値は、すべてのスクリプトに公開されます。
- 導入されたバージョン:
- 1.6
-
コンストラクタのサマリー
コンストラクタ説明このコンストラクタの呼出しの効果は、ScriptEngineManager(Thread.currentThread().getContextClassLoader())
を呼び出した場合と同じになります。ScriptEngineManager
(ClassLoader loader) このコンストラクタは、サービス・プロバイダ・メカニズムを使用して、指定されたClassLoader
に可視のScriptEngineFactory
の実装をロードします。
ローダーがnull
の場合、プラットフォームにバンドルされているスクリプト・エンジン・ファクトリがロードされます。 -
メソッドのサマリー
修飾子と型メソッド説明グローバル・スコープ内の指定されたキーに対する値を取得します。getBindings
は、globalScope
フィールドの値を返します。getEngineByExtension
(String extension) 指定された拡張子のScriptEngine
を検索および作成します。getEngineByMimeType
(String mimeType) 指定されたMIMEタイプのScriptEngine
を検索および作成します。getEngineByName
(String shortName) 指定された名前のScriptEngine
を検索および作成します。検索メカニズムによって見つかったすべてのScriptEngineFactory
クラスのインスタンスが要素であるリストを返します。void
グローバル・スコープに、指定されたキーと値のペアを設定します。void
registerEngineExtension
(String extension, ScriptEngineFactory factory) 拡張子を処理するためのScriptEngineFactory
を登録します。void
registerEngineMimeType
(String type, ScriptEngineFactory factory) MIMEタイプを処理するためのScriptEngineFactory
を登録します。void
registerEngineName
(String name, ScriptEngineFactory factory) 言語名を処理するためのScriptEngineFactory
を登録します。void
setBindings
(Bindings bindings) setBindings
は、globalScope
フィールド内に指定されたBindings
を格納します。
-
コンストラクタの詳細
-
ScriptEngineManager
public ScriptEngineManager()このコンストラクタの呼出しの効果は、ScriptEngineManager(Thread.currentThread().getContextClassLoader())
を呼び出した場合と同じになります。 -
ScriptEngineManager
public ScriptEngineManager(ClassLoader loader) このコンストラクタは、サービス・プロバイダ・メカニズムを使用して、指定されたClassLoader
に可視のScriptEngineFactory
の実装をロードします。
ローダーがnull
の場合、プラットフォームにバンドルされているスクリプト・エンジン・ファクトリがロードされます。
- パラメータ:
loader
- スクリプト・エンジン・ファクトリの検出に使用するClassLoader。
-
-
メソッドの詳細
-
setBindings
public void setBindings(Bindings bindings) setBindings
は、globalScope
フィールド内に指定されたBindings
を格納します。 ScriptEngineManagerは、このBindings
を、生成したScriptEngine
オブジェクトのグローバル・バインディングとして設定します。- パラメータ:
bindings
- 指定されたBindings
- 例外:
IllegalArgumentException
- バインディングがnullの場合。
-
getBindings
public Bindings getBindings()getBindings
は、globalScope
フィールドの値を返します。 ScriptEngineManagerは、このBindings
を、生成したScriptEngine
オブジェクトのグローバル・バインディングとして設定します。- 戻り値:
- globalScopeフィールド。
-
put
グローバル・スコープに、指定されたキーと値のペアを設定します。- パラメータ:
key
- 設定するキーvalue
- 設定する値。- 例外:
NullPointerException
- キーがnullの場合。IllegalArgumentException
- キーが空の文字列である場合。
-
get
グローバル・スコープ内の指定されたキーに対する値を取得します。- パラメータ:
key
- 値が返されるキー。- 戻り値:
- 指定されたキーの値。
-
getEngineByName
public ScriptEngine getEngineByName(String shortName) 指定された名前のScriptEngine
を検索および作成します。 このアルゴリズムは最初に、registerEngineName
メソッドを使用して、指定された名前のハンドラとして登録されているScriptEngineFactory
を検索します。
見つからない場合は、指定された名前のハンドラのコンストラクタによって格納された一連のScriptEngineFactory
インスタンスを検索します。 いずれかのメソッドによってScriptEngineFactory
が見つかった場合、ScriptEngine
のインスタンスを作成するために使用されます。- パラメータ:
shortName
-ScriptEngineFactory
のgetNames
メソッドによって返されるScriptEngine
実装の短い名前。- 戻り値:
- 検索で見つかったファクトリによって作成された
ScriptEngine
。 このようなファクトリが見つからなかった場合はnull。ScriptEngineManager
は、自身のglobalScope
Bindings
を、新しく作成されたScriptEngine
のGLOBAL_SCOPE
Bindings
として設定する。 - 例外:
NullPointerException
- shortNameがnullの場合。
-
getEngineByExtension
public ScriptEngine getEngineByExtension(String extension) 指定された拡張子のScriptEngine
を検索および作成します。getEngineByName
によって使用されているアルゴリズムを使用します。ただし、指定された拡張子を処理するためにregisterEngineExtension
を使用して登録されたScriptEngineFactory
が最初に検索されます。- パラメータ:
extension
- 指定された拡張子- 戻り値:
- この拡張子を持つスクリプトを処理するエンジン。 見つからない場合は
null
。 - 例外:
NullPointerException
- extensionがnullの場合。
-
getEngineByMimeType
public ScriptEngine getEngineByMimeType(String mimeType) 指定されたMIMEタイプのScriptEngine
を検索および作成します。getEngineByName
によって使用されているアルゴリズムを使用します。ただし、指定されたMIMEタイプを処理するためにregisterEngineMimeType
を使用して登録されたScriptEngineFactory
が最初に検索されます。- パラメータ:
mimeType
- 指定されたMIMEタイプ- 戻り値:
- このMIMEタイプを持つスクリプトを処理するエンジン。 見つからない場合は
null
。 - 例外:
NullPointerException
- mimeTypeがnullの場合。
-
getEngineFactories
public List<ScriptEngineFactory> getEngineFactories()検索メカニズムによって見つかったすべてのScriptEngineFactory
クラスのインスタンスが要素であるリストを返します。- 戻り値:
- 検出されたすべての
ScriptEngineFactory
のリスト。
-
registerEngineName
public void registerEngineName(String name, ScriptEngineFactory factory) 言語名を処理するためのScriptEngineFactory
を登録します。 検出メカニズムを使用して見つかったすべての関連付けをオーバーライドします。- パラメータ:
name
-ScriptEngineFactory
に関連付けられる名前。factory
- 指定された名前に関連付けるクラス。- 例外:
NullPointerException
- パラメータのいずれかがnullの場合。
-
registerEngineMimeType
public void registerEngineMimeType(String type, ScriptEngineFactory factory) MIMEタイプを処理するためのScriptEngineFactory
を登録します。 検出メカニズムを使用して見つかったすべての関連付けをオーバーライドします。- パラメータ:
type
-ScriptEngineFactory
に関連付けられるMIMEタイプ。factory
- 指定されたMIMEタイプに関連付けるクラス。- 例外:
NullPointerException
- パラメータのいずれかがnullの場合。
-
registerEngineExtension
public void registerEngineExtension(String extension, ScriptEngineFactory factory) 拡張子を処理するためのScriptEngineFactory
を登録します。 検出メカニズムを使用して見つかったすべての関連付けをオーバーライドします。- パラメータ:
extension
-ScriptEngineFactory
に関連付けられる拡張子。factory
- 指定された拡張子に関連付けるクラス。- 例外:
NullPointerException
- パラメータのいずれかがnullの場合。
-