Spec-Zone .ru
спецификации, руководства, описания, API
|
public interface ScriptEngine
ScriptEngine
фундаментальный интерфейс, методы которого должны быть полностью функциональными в каждой реализации этой спецификации. Модификатор и Тип | Поле и Описание |
---|---|
static String |
ARGV
Зарезервированный ключ для именованного значения, которое передает массив позиционных параметров к сценарию.
|
static String |
МЕХАНИЗМ
Зарезервированный ключ для именованного значения, которое является именем
ScriptEngine реализация. |
static String |
ENGINE_VERSION
Зарезервированный ключ для именованного значения, которое идентифицирует версию
ScriptEngine реализация. |
static String |
ИМЯ ФАЙЛА
Зарезервированный ключ для именованного значения, которое является именем выполняемого файла.
|
static String |
ЯЗЫК
Зарезервированный ключ для именованного значения, которое является полным именем Языка сценариев, поддерживаемого реализацией.
|
static String |
LANGUAGE_VERSION
Зарезервированный ключ для именованного значения, которое идентифицирует версию языка сценариев, поддерживаемого реализацией.
|
static String |
ИМЯ
Зарезервированный ключ для именованного значения, которое идентифицирует краткое название языка сценариев.
|
Модификатор и Тип | Метод и Описание |
---|---|
Привязка |
createBindings()
Возвращает неинициализированное
Bindings . |
Объект |
eval(Reader reader)
То же самое как
eval(String) за исключением того, что источник сценария обеспечивается как a Reader |
Объект |
eval(Reader reader, Bindings n)
То же самое как
eval(String, Bindings) за исключением того, что источник сценария обеспечивается как a Reader . |
Объект |
eval(Reader reader, ScriptContext context)
То же самое как
eval(String, ScriptContext) где источник сценария читается из a Reader . |
Объект |
eval(String script)
Выполняет указанный сценарий.
|
Объект |
eval(String script, Bindings n)
Выполняет сценарий, используя
Bindings параметр как ENGINE_SCOPE
Bindings из ScriptEngine во время выполнения сценария. |
Объект |
eval(String script, ScriptContext context)
Вызывает непосредственное выполнение сценария, источником которого является Строка, которую передают как первый параметр.
|
Объект |
get(String key)
Получает набор значений в состоянии этого механизма.
|
Привязка |
getBindings(int scope)
Возвращает контекст именованных значений.
|
ScriptContext |
getContext()
Возвращает значение по умолчанию
ScriptContext из ScriptEngine чья Привязка, Читатель и Писатели используются для выполнения сценария когда нет ScriptContext определяется. |
ScriptEngineFactory |
getFactory()
Возвраты a
ScriptEngineFactory для того, class, к который это ScriptEngine принадлежит. |
void |
put(String key, Object value)
Устанавливает пару ключ/значение в состоянии ScriptEngine, который может или создать Привязку к языку Java, которая будет использоваться в выполнении сценариев, или использоваться некоторым другим способом, в зависимости от того, резервируется ли ключ.
|
void |
setBindings(Bindings bindings, int scope)
Устанавливает контекст именованных значений, которые будут использоваться сценариями.
|
void |
setContext(ScriptContext context)
Устанавливает значение по умолчанию
ScriptContext из ScriptEngine чья Привязка, Читатель и Писатели используются для выполнения сценария когда нет ScriptContext определяется. |
static final String ARGV
static final String FILENAME
static final String ENGINE
ScriptEngine
реализация.static final String ENGINE_VERSION
ScriptEngine
реализация.static final String NAME
ScriptEngineManager
определять местоположение a ScriptEngine
с именем в getEngineByName
метод.static final String LANGUAGE
static final String LANGUAGE_VERSION
Object eval(String script, ScriptContext context) throws ScriptException
script
- Сценарий, который будет выполнен механизмом выполнения сценария.context
- A ScriptContext
представление наборов атрибутов в различных контекстах. Значения контекстов ScriptContext.GLOBAL_SCOPE
, и ScriptContext.ENGINE_SCOPE
определяются в спецификации. ENGINE_SCOPE
Bindings
из ScriptContext
содержит привязку сценариев переменных к объектам приложения, которые будут использоваться во время этого выполнения сценария.ScriptException
- если ошибка occurrs в сценарии. ScriptEngines должен создать и бросить ScriptException
обертки для проверенных Исключений, выданных базовыми реализациями сценариев.NullPointerException
- если любым параметром является нуль.Object eval(Reader reader, ScriptContext context) throws ScriptException
eval(String, ScriptContext)
где источник сценария читается из a Reader
.reader
- Источник сценария, который будет выполнен механизмом выполнения сценария.context
- ScriptContext
переданный к механизму выполнения сценария.ScriptException
- если ошибка occurrs в сценарии.NullPointerException
- если любым параметром является нуль.Object eval(String script) throws ScriptException
ScriptContext
для ScriptEngine
используется.script
- Источник языка сценария, который будет выполнен.ScriptException
- если ошибка occurrs в сценарии.NullPointerException
- если параметром является нуль.Object eval(Reader reader) throws ScriptException
eval(String)
за исключением того, что источник сценария обеспечивается как a Reader
reader
- Источник сценария.ScriptException
- если ошибка occurrs в сценарии.NullPointerException
- если параметром является нуль.Object eval(String script, Bindings n) throws ScriptException
Bindings
параметр как ENGINE_SCOPE
Bindings
из ScriptEngine
во время выполнения сценария. Reader
, Writer
и не -ENGINE_SCOPE
Bindings
из значения по умолчанию ScriptContext
используются. ENGINE_SCOPE
Bindings
из ScriptEngine
не изменяется, и его отображения неизменны выполнением сценария.script
- Источник для сценария.n
- Bindings
из атрибутов, которые будут использоваться для выполнения сценария.ScriptException
- если ошибка occurrs в сценарии.NullPointerException
- если любым параметром является нуль.Object eval(Reader reader, Bindings n) throws ScriptException
eval(String, Bindings)
за исключением того, что источник сценария обеспечивается как a Reader
.reader
- Источник сценария.n
- Bindings
из атрибутов.ScriptException
- если ошибка occurrs.NullPointerException
- если любым параметром является нуль.void put(String key, Object value)
getBindings(ScriptContext.ENGINE_SCOPE).put
.key
- Имя именованного значения, чтобы добавитьvalue
- Значение именованного значения, чтобы добавить.NullPointerException
- если ключ является нулем.IllegalArgumentException
- если ключ пуст.Object get(String key)
setValue
или некоторое другое значение в состоянии ScriptEngine
, В зависимости от реализации. Должен иметь тот же самый эффект как getBindings(ScriptContext.ENGINE_SCOPE).get
key
- Ключ, значение которого должно быть возвращеноNullPointerException
- если ключ является нулем.IllegalArgumentException
- если ключ пуст.Bindings getBindings(int scope)
ScriptContext.GLOBAL_SCOPE
- Набор именованных значений, представляющих глобальную область видимости. Если это ScriptEngine
создается a ScriptEngineManager
, тогда менеджер устанавливает привязку глобальной области видимости. Это может быть null
если никакая глобальная область видимости не связывается с этим ScriptEngine
ScriptContext.ENGINE_SCOPE
- Набор именованных значений, представляющих состояние этого ScriptEngine
. Значения обычно видимы в сценариях, используя связанные ключи в качестве имен переменной.ScriptContext
из ScriptEngine
. Bindings
экземпляры, которые возвращаются, должны быть идентичными возвращенным getBindings
метод ScriptContext
вызванный с соответствующими параметрами на значении по умолчанию ScriptContext
из ScriptEngine
.scope
- Также ScriptContext.ENGINE_SCOPE
или ScriptContext.GLOBAL_SCOPE
который определяет Bindings
возвратиться. Реализации ScriptContext
может определить дополнительные контексты. Если значение по умолчанию ScriptContext
из ScriptEngine
определяет дополнительные контексты, любого из них можно передать, чтобы получить соответствие Bindings
.Bindings
с указанным контекстом.IllegalArgumentException
- если определенный контекст недопустимvoid setBindings(Bindings bindings, int scope)
ScriptContext.ENGINE_SCOPE
- Указанное Bindings
заменяет контекст механизма ScriptEngine
. ScriptContext.GLOBAL_SCOPE
- Указанное Bindings
должно быть видимым как GLOBAL_SCOPE
. ScriptContext
из ScriptEngine
. setBindings
метод ScriptContext
с соответствующим значением scope
на значении по умолчанию ScriptContext
из ScriptEngine
.bindings
- Bindings
для указанного контекста.scope
- Указанный контекст. Также ScriptContext.ENGINE_SCOPE
, ScriptContext.GLOBAL_SCOPE
, или любое другое допустимое значение контекста.IllegalArgumentException
- если контекст недопустимNullPointerException
- если привязка является нулем, и контекст ScriptContext.ENGINE_SCOPE
Bindings createBindings()
Bindings
.Bindings
это может использоваться, чтобы заменить состояние этого ScriptEngine
.ScriptContext getContext()
ScriptContext
из ScriptEngine
чья Привязка, Читатель и Писатели используются для выполнения сценария когда нет ScriptContext
определяется.ScriptContext
из ScriptEngine
.void setContext(ScriptContext context)
ScriptContext
из ScriptEngine
чья Привязка, Читатель и Писатели используются для выполнения сценария когда нет ScriptContext
определяется.context
- A ScriptContext
это заменит значение по умолчанию ScriptContext
в ScriptEngine
.NullPointerException
- если контекст является нулем.ScriptEngineFactory getFactory()
ScriptEngineFactory
для того, class, к который это ScriptEngine
принадлежит.ScriptEngineFactory
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92