ScriptEngineManager (Java Platform SE 8)

java.lang.Object
- javax.script.ScriptEngineManager

```
public class ScriptEngineManager
extends Object
```
ScriptEngineManagerは、ScriptEngineクラスの検出およびインスタンス化メカニズムを実装します。また、Managerが作成したすべてのエンジンで共有される状態を格納するキーと値のペアのコレクションを維持します。このクラスは、サービス・プロバイダのメカニズムを使用して、ScriptEngineFactoryのすべての実装を列挙します。

ScriptEngineManagerは、言語名、ファイル拡張子、およびMIMEタイプに基づいてファクトリを検索するユーティリティ・メソッドと、これらすべてのファクトリのリストを返すメソッドを提供します。
マネージャによって管理され、「グローバル・スコープ」として参照されるキーと値のペアのBindingsは、ScriptEngineManagerが作成したScriptEngineのすべてのインスタンスで利用可能です。通常、Bindingsの値は、すべてのスクリプトに公開されます。

導入されたバージョン:

1.6

コンストラクタのサマリー

コンストラクタ
コンストラクタ	説明
`ScriptEngineManager()`	このコンストラクタの呼出しの効果は、`ScriptEngineManager(Thread.currentThread().getContextClassLoader())`を呼び出した場合と同じになります。
`ScriptEngineManager(ClassLoader loader)`	このコンストラクタは、サービス・プロバイダ・メカニズムを使用して、指定された`ClassLoader`に可視の`ScriptEngineFactory`の実装をロードします。 loaderが`null`の場合、プラットフォームにバンドルされ、通常の拡張ディレクトリ(インストール型拡張機能)に存在するスクリプト・エンジン・ファクトリがロードされます。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッド	説明
`Object`	`get(String key)`	グローバル・スコープ内の指定されたキーに対する値を取得します。
`Bindings`	`getBindings()`	`getBindings`は、`globalScope`フィールドの値を返します。
`ScriptEngine`	`getEngineByExtension(String extension)`	指定された拡張子の`ScriptEngine`を検索および作成します。
`ScriptEngine`	`getEngineByMimeType(String mimeType)`	指定されたMIMEタイプの`ScriptEngine`を検索および作成します。
`ScriptEngine`	`getEngineByName(String shortName)`	指定された名前の`ScriptEngine`を検索および作成します。
`List<ScriptEngineFactory>`	`getEngineFactories()`	検索メカニズムによって見つかったすべての`ScriptEngineFactory`クラスのインスタンスが要素であるリストを返します。
`void`	`put(String key, Object value)`	グローバル・スコープに、指定されたキーと値のペアを設定します。
`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`を格納します。

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - ScriptEngineManager
```
public ScriptEngineManager()
```
    このコンストラクタの呼出しの効果は、ScriptEngineManager(Thread.currentThread().getContextClassLoader())を呼び出した場合と同じになります。
    
    関連項目:
    
    Thread.getContextClassLoader()
  - ScriptEngineManager
```
public ScriptEngineManager(ClassLoader loader)
```
    このコンストラクタは、サービス・プロバイダ・メカニズムを使用して、指定されたClassLoaderに可視のScriptEngineFactoryの実装をロードします。
    
    loaderが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
```
public void put(String key,
                Object value)
```
    グローバル・スコープに、指定されたキーと値のペアを設定します。
    
    パラメータ:
    
    key - 設定するキー
    
    value - 設定する値。
    
    例外:
    
    NullPointerException - キーがnullの場合。
    
    IllegalArgumentException - キーが空の文字列である場合。
  - get
```
public Object get(String key)
```
    グローバル・スコープ内の指定されたキーに対する値を取得します。
    
    パラメータ:
    
    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の場合。

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスScriptEngineManager

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

ScriptEngineManager

ScriptEngineManager

メソッドの詳細

setBindings

getBindings

put

get

getEngineByName

getEngineByExtension

getEngineByMimeType

getEngineFactories

registerEngineName

registerEngineMimeType

registerEngineExtension