Spec-Zone.ru › OpenJDK 8

Пакет javax.script

API для скриптов состоит из интерфейсов и классов, которые определяют Java TM движки для скриптов и предоставляют фреймворк для их использования в приложениях Java.

См.: Описание

Интерфейс Описание
Bindings

Сопоставление пар ключ/значение, все ключи которых являются Strings.

Compilable

Необязательный интерфейс, реализуемый ScriptEngines, методы которого компилируют скрипты в форму, которую можно выполнять повторно без повторной компиляции.

Invocable

Необязательный интерфейс, реализуемый ScriptEngines, методы которого позволяют вызывать процедуры в скриптах, которые были ранее выполнены.

ScriptContext

Интерфейс, реализующие классы которого используются для подключения Script Engines к объектам, таким как scoped Bindings, в приложениях-хостах.

ScriptEngine

ScriptEngine — это основной интерфейс, методы которого должны быть полностью функциональными в каждой реализации данного спецификации.

ScriptEngineFactory

ScriptEngineFactory используется для описания и создания ScriptEngines.

Класс Описание
AbstractScriptEngine

Предоставляет стандартную реализацию для нескольких вариантов метода eval.

CompiledScript

Расширяется классами, которые хранят результаты компиляции.

ScriptEngineManager

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

SimpleBindings

Простая реализация Bindings, основанная на HashMap или какой-либо другой указанной Map.

SimpleScriptContext

Простая реализация ScriptContext.

Исключение Описание
ScriptException

Общий класс Exception для API для скриптов.

Описание пакета javax.script

API для скриптов состоит из интерфейсов и классов, которые определяют Java TM движки для скриптов и предоставляют фреймворк для их использования в приложениях Java. Этот API предназначен для использования программистами приложений, которые хотят выполнять программы, написанные на языках сценариев, в своих приложениях Java. Программы на языке сценариев обычно предоставляются конечными пользователями приложений.

Основные функциональные области пакета javax.script включают:

  1. Выполнение скриптов: Скрипты представляют собой потоки символов, используемые в качестве источников программ, выполняемых движками скриптов. Выполнение скриптов использует метод eval класса ScriptEngine и методы интерфейса Invocable.

  2. Связывание: Эта возможность позволяет предоставлять доступ к объектам Java программам на языке сценариев в виде именованных переменных. Для этой цели используются классы Bindings и ScriptContext.

  3. Компиляция: Эта функциональность позволяет сохранить промежуточный код, генерируемый передней частью движка скриптов, и выполнять его повторно. Это выгодно для приложений, которые выполняют один и тот же скрипт несколько раз. Эти приложения могут получить эффективность, поскольку передние части движков должны выполнять скрипт только один раз на скрипт, а не один раз на каждое выполнение скрипта. Обратите внимание, что эта функциональность является необязательной, и движки скриптов могут ее не реализовывать. Звонящие должны проверять доступность интерфейса Compilable с помощью проверки instanceof.

  4. Вызов: Эта функциональность позволяет повторно использовать промежуточный код, сгенерированный передней частью движка скриптов. В то время как компиляция позволяет повторно выполнять целые скрипты, представленные промежуточным кодом, функциональность вызова позволяет повторно выполнять отдельные процедуры/методы в скриптах. Как и в случае с компиляцией, не все движки скриптов обязаны предоставлять эту возможность. Звонящий должен проверить доступность Invocable.

  5. Обнаружение движка скриптов и метаданные: Приложения, написанные для API для скриптов, могут иметь особые требования к движкам скриптов. Некоторые могут потребовать определенный язык сценариев и/или версию, в то время как другие могут потребовать определенный движок реализации и/или версию. Движки скриптов упаковываются определенным образом, чтобы движки можно было обнаружить во время выполнения и получить информацию о них. Механизм обнаружения движка основан на механизме обнаружения служб, описанном в спецификации файлов JAR. Классы, реализующие движок скриптов, упаковываются в файлы JAR, которые включают текстовый ресурс под названием META-INF/services/javax.script.ScriptEngineFactory. Этот ресурс должен содержать строку для каждого ScriptEngineFactory, который упакован в файле JAR. ScriptEngineManager включает метод getEngineFactories для получения всех экземпляров ScriptEngineFactory, обнаруженных с помощью этого механизма. ScriptEngineFactory имеет методы для запроса атрибутов движка скриптов.

С момента:
1.6

© 1993, 2020, 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API