Класс ScriptEngineManager

public class ScriptEngineManager
extends Object

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

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

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

Конструкторы

ScriptEngineManager

public ScriptEngineManager()

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

См. также:

Thread.getContextClassLoader()

ScriptEngineManager

public ScriptEngineManager(ClassLoader loader)

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

Если загрузчик - null, то фабрики движков скриптов, входящие в платформу и находящиеся в обычных каталогах расширений (установленные расширения), будут загружены.

Параметры:

loader - Загрузчик классов, используемый для обнаружения фабрик движков скриптов.

Методы

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.