Класс ScriptEngineManager

java.lang.Object

javax.script.ScriptEngineManager

public class ScriptEngineManager extends Object

Класс ScriptEngineManager реализует механизм обнаружения и создания экземпляров классов ScriptEngine, а также поддерживает коллекцию пар "ключ-значение", хранящих состояние, общее для всех движков, созданных менеджером. Этот класс использует механизм поставщиков услуг, описанный в классе ServiceLoader, для перечисления всех реализаций ScriptEngineFactory.

Класс ScriptEngineManager предоставляет метод для возврата списка всех этих фабрик, а также вспомогательные методы для поиска фабрик по имени языка, расширению файла и типу MIME.

Коллекция пар "ключ-значение", называемая "Глобальной областью", поддерживаемая менеджером, доступна всем экземплярам ScriptEngine, созданным классом ScriptEngineManager. Значения в Bindings обычно доступны во всех скриптах.

Since:: 1.6

Краткое описание конструкторов

Конструктор	Описание
`ScriptEngineManager()`	Эффект вызова этого конструктора такой же, как вызов `ScriptEngineManager(Thread.currentThread().getContextClassLoader())`.
`ScriptEngineManager(ClassLoader loader)`	Этот конструктор загружает реализации `ScriptEngineFactory`, видимые для данного `ClassLoader`, используя механизм поставщиков услуг. Если loader равен `null`, загружаются фабрики движков скриптов, поставляемые платформой.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Object`	`get(String key)`	Возвращает значение для указанного ключа в Глобальной области
`Bindings`	`getBindings()`	`getBindings` возвращает значение поля `globalScope`.
`ScriptEngine`	`getEngineByExtension(String extension)`	Поиск и создание `ScriptEngine` для данного расширения.
`ScriptEngine`	`getEngineByMimeType(String mimeType)`	Поиск и создание `ScriptEngine` для данного типа MIME.
`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)`	Регистрирует `ScriptEngineFactory` для обработки типа MIME.
`void`	`registerEngineName(String name, ScriptEngineFactory factory)`	Регистрирует `ScriptEngineFactory` для обработки имени языка.
`void`	`setBindings(Bindings bindings)`	`setBindings` хранит указанный `Bindings` в поле `globalScope`.

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

ScriptEngineManager

public ScriptEngineManager()

Эффект вызова этого конструктора такой же, как и вызов ScriptEngineManager(Thread.currentThread().getContextClassLoader()).

См. также:

ScriptEngineManager

public ScriptEngineManager(ClassLoader loader)

Этот конструктор загружает реализации ScriptEngineFactory, видимые для данного ClassLoader, с использованием механизма поставщиков сервисов.

Если loader равен null, то загрузятся фабрики движков сценариев, которые входят в состав платформы.

Параметры:: loader - ClassLoader, используемый для обнаружения фабрик движков сценариев.

Подробное описание методов

setBindings

public void setBindings(Bindings bindings)

setBindings сохраняет указанные Bindings в поле globalScope. ScriptEngineManager устанавливает эти Bindings в качестве глобальных связей для ScriptEngine объектов, созданных им.

Параметры:: bindings - Указанные Bindings
Исключения:: IllegalArgumentException - если bindings равно 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 для заданного имени. Алгоритм сначала ищет ScriptEngineFactory, который был зарегистрирован как обработчик для указанного имени с помощью метода registerEngineName.

Если такой не найден, он ищет среди набора ScriptEngineFactory экземпляров, сохраненных конструктором, экземпляр с заданным именем. Если ScriptEngineFactory найден любым из этих способов, он используется для создания экземпляра ScriptEngine.

Параметры:: shortName - Короткое имя реализации ScriptEngine, возвращаемое методом getNames его ScriptEngineFactory.
Возвращает:: ScriptEngine, созданный фабрикой, найденной в результате поиска. Возвращает null, если такая фабрика не найдена. ScriptEngineManager устанавливает свой собственный globalScope Bindings в качестве GLOBAL_SCOPE Bindings вновь созданного ScriptEngine.
Исключения:: NullPointerException - если shortName равно null.

getEngineByExtension

public ScriptEngine getEngineByExtension(String extension)

Поиск и создание ScriptEngine для заданного расширения. Алгоритм, используемый getEngineByName, используется, за исключением того, что поиск начинается с поиска ScriptEngineFactory, зарегистрированного для обработки данного расширения с помощью registerEngineExtension.

Параметры:: extension - Заданное расширение
Возвращает:: Движок для обработки сценариев с этим расширением. Возвращает null, если не найден.
Исключения:: NullPointerException - если extension равно null.

getEngineByMimeType

public ScriptEngine getEngineByMimeType(String mimeType)

Поиск и создание ScriptEngine для заданного типа MIME. Алгоритм, используемый getEngineByName, используется, за исключением того, что поиск начинается с поиска ScriptEngineFactory, зарегистрированного для обработки данного типа MIME с помощью registerEngineMimeType.

Параметры:: 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)

Регистрирует ScriptEngineFactory для обработки типа MIME. Перезаписывает любое такое ассоциацию, найденную с помощью механизма обнаружения.

Параметры:: type - Тип MIME, который нужно ассоциировать с ScriptEngineFactory.; factory - Класс, который нужно ассоциировать с данным типом MIME.
Исключения:: NullPointerException - если любой из параметров равен null.

registerEngineExtension

public void registerEngineExtension(String extension, ScriptEngineFactory factory)

Регистрирует ScriptEngineFactory для обработки расширения. Перезаписывает любое такое ассоциацию, найденную с помощью механизма обнаружения.

Параметры:: extension - Тип расширения, который нужно ассоциировать с ScriptEngineFactory.; factory - Класс, который нужно ассоциировать с данным расширением.
Исключения:: NullPointerException - если любой из параметров равен null.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.scripting/javax/script/ScriptEngineManager.html