ScriptEngine (Платформа Java SE 7)

Все Известные Классы с реализацией:

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

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

Значения являются парами ключ/значение двух типов. Первый тип пар состоит из тех, ключи которых резервируются и определяются в этой спецификации или отдельными реализациями. Значения в парах с зарезервированными ключами определили значения.

Другой тип пар состоит из тех, которые создают привязки к языку Java, значения обычно представляются в сценариях соответствующими ключами или украшенными формами их.

С тех пор:

1.6

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`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` для того, класса, к который это `ScriptEngine` принадлежит.
`void`	`put(String key, Object value)` Устанавливает пару ключ/значение в состоянии ScriptEngine, который может или создать Привязку к языку Java, которая будет использоваться в выполнении сценариев, или использоваться некоторым другим способом, в зависимости от того, резервируется ли ключ.
`void`	`setBindings(Bindings bindings, int scope)` Устанавливает контекст именованных значений, которые будут использоваться сценариями.
`void`	`setContext(ScriptContext context)` Устанавливает значение по умолчанию `ScriptContext` из `ScriptEngine` чья Привязка, Читатель и Писатели используются для выполнения сценария когда нет `ScriptContext` определяется.

- Полевая Деталь
  - ARGV
```
static final String ARGV
```
    Зарезервированный ключ для именованного значения, которое передает массив позиционных параметров к сценарию.
    
    См. Также:
    Постоянные Значения полей
  - ИМЯ ФАЙЛА
```
static final String FILENAME
```
    Зарезервированный ключ для именованного значения, которое является именем выполняемого файла.
    
    См. Также:
    Постоянные Значения полей
  - МЕХАНИЗМ
```
static final String ENGINE
```
    Зарезервированный ключ для именованного значения, которое является именем ScriptEngine реализация.
    
    См. Также:
    Постоянные Значения полей
  - ENGINE_VERSION
```
static final String ENGINE_VERSION
```
    Зарезервированный ключ для именованного значения, которое идентифицирует версию ScriptEngine реализация.
    
    См. Также:
    Постоянные Значения полей
  - ИМЯ
```
static final String NAME
```
    Зарезервированный ключ для именованного значения, которое идентифицирует краткое название языка сценариев. Имя используется ScriptEngineManager определять местоположение a ScriptEngine с именем в getEngineByName метод.
    
    См. Также:
    Постоянные Значения полей
  - ЯЗЫК
```
static final String LANGUAGE
```
    Зарезервированный ключ для именованного значения, которое является полным именем Языка сценариев, поддерживаемого реализацией.
    
    См. Также:
    Постоянные Значения полей
  - LANGUAGE_VERSION
```
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)
```
    Устанавливает пару ключ/значение в состоянии ScriptEngine, который может или создать Привязку к языку Java, которая будет использоваться в выполнении сценариев, или использоваться некоторым другим способом, в зависимости от того, резервируется ли ключ. Должен иметь тот же самый эффект как getBindings(ScriptContext.ENGINE_SCOPE).put.
    
    Параметры:
    key - Имя именованного значения, чтобы добавить
    value - Значение именованного значения, чтобы добавить.
    
    Броски:
    
    NullPointerException - если ключ является нулем.
    
    IllegalArgumentException - если ключ пуст.
  - добраться
```
Object get(String key)
```
    Получает набор значений в состоянии этого механизма. Значение могло бы быть тем, которое было установлено, используя setValue или некоторое другое значение в состоянии ScriptEngine, В зависимости от реализации. Должен иметь тот же самый эффект как getBindings(ScriptContext.ENGINE_SCOPE).get
    
    Параметры:
    key - Ключ, значение которого должно быть возвращено
    
    Возвраты:
    значение для данного ключа
    
    Броски:
    
    NullPointerException - если ключ является нулем.
    
    IllegalArgumentException - если ключ пуст.
  - getBindings
```
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 - если определенный контекст недопустим
  - setBindings
```
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
  - createBindings
```
Bindings createBindings()
```
    Возвращает неинициализированное Bindings.
    
    Возвраты:
    A Bindings это может использоваться, чтобы заменить состояние этого ScriptEngine.
  - getContext
```
ScriptContext getContext()
```
    Возвращает значение по умолчанию ScriptContext из ScriptEngine чья Привязка, Читатель и Писатели используются для выполнения сценария когда нет ScriptContext определяется.
    
    Возвраты:
    Значение по умолчанию ScriptContext из ScriptEngine.
  - setContext
```
void setContext(ScriptContext context)
```
    Устанавливает значение по умолчанию ScriptContext из ScriptEngine чья Привязка, Читатель и Писатели используются для выполнения сценария когда нет ScriptContext определяется.
    
    Параметры:
    context - A ScriptContext это заменит значение по умолчанию ScriptContext в ScriptEngine.
    
    Броски:
    
    NullPointerException - если контекст является нулем.
  - getFactory
```
ScriptEngineFactory getFactory()
```
    Возвраты a ScriptEngineFactory для того, класса, к который это ScriptEngine принадлежит.
    
    Возвраты:
    ScriptEngineFactory

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Интерфейсный ScriptEngine

Полевая Сводка

Сводка метода

Полевая Деталь

ARGV

ИМЯ ФАЙЛА

МЕХАНИЗМ

ENGINE_VERSION

ИМЯ

ЯЗЫК

LANGUAGE_VERSION

Деталь метода

оценка

оценка

оценка

оценка

оценка

оценка

поместить

добраться

getBindings

setBindings

createBindings

getContext

setContext

getFactory