Интерфейс ScriptContext

public interface ScriptContext

Поля

ENGINE_SCOPE

static final int ENGINE_SCOPE

Атрибуты EngineScope видны в течение жизни одного ScriptEngine и набор атрибутов поддерживается для каждого движка.

См. также:

Значения константных полей

GLOBAL_SCOPE

static final int GLOBAL_SCOPE

Атрибуты GlobalScope видны всем движкам, созданным одной ScriptEngineFactory.

См. также:

Значения константных полей

Методы

setBindings

void setBindings(Bindings bindings,
                 int scope)

Связывает экземпляр Bindings с конкретным scope в данном ScriptContext. Вызовы методов getAttribute и setAttribute должны соответствовать методам get и put экземпляра Bindings для указанного scope.

Параметры:

bindings - Bindings для связывания с заданным scope

scope - Scope

Исключения:

IllegalArgumentException - Если для указанного значения scope в ScriptContexts данного типа не определён Bindings.

NullPointerException - если значение scope равно ENGINE_SCOPE и указанный Bindings равен null.

getBindings

Bindings getBindings(int scope)

Получает Bindings, связанный с данным scope в данном ScriptContext.

Параметры:

scope - Scope

Возвращает:

Связанный Bindings. Возвращает null, если он не задан.

Исключения:

IllegalArgumentException - Если для указанного значения scope в ScriptContexts данного типа не определён Bindings.

setAttribute

void setAttribute(String name,
                  Object value,
                  int scope)

Устанавливает значение атрибута в заданном scope.

Параметры:

name - Имя атрибута для установки

value - Значение атрибута

scope - Scope для установки атрибута

Исключения:

IllegalArgumentException - если имя пустое или scope недопустимое.

NullPointerException - если имя null.

getAttribute

Object getAttribute(String name,
                    int scope)

Получает значение атрибута в заданном scope.

Параметры:

name - Имя атрибута для получения.

scope - Scope для получения атрибута.

Возвращает:

Значение атрибута. Возвращает null, если имя не существует в данном scope.

Исключения:

IllegalArgumentException - если имя пустое или значение scope недопустимое.

NullPointerException - если имя null.

removeAttribute

Object removeAttribute(String name,
                       int scope)

Удаляет атрибут в заданном scope.

Параметры:

name - Имя атрибута для удаления

scope - Scope для удаления атрибута

Возвращает:

Удалённое значение.

Исключения:

IllegalArgumentException - если имя пустое или scope недопустимое.

NullPointerException - если имя null.

getAttribute

Object getAttribute(String name)

Получает значение атрибута с заданным именем в scope, который встречается раньше в порядке поиска. Порядок определяется числовым значением параметра scope (наименьшие значения scope сначала).

Параметры:

name - Имя атрибута для получения.

Возвращает:

Значение атрибута в самом низком scope, в котором определён атрибут с данным именем. Возвращает null, если атрибут с данным именем не существует ни в одном scope.

Исключения:

NullPointerException - если имя null.

IllegalArgumentException - если имя пустое.

getAttributesScope

int getAttributesScope(String name)

Получает самый низкий scope, в котором определён атрибут.

Параметры:

name - Имя атрибута.

Возвращает:

Самый низкий scope. Возвращает -1, если атрибут с данным именем не определён ни в одном scope.

Исключения:

NullPointerException - если имя null.

IllegalArgumentException - если имя пустое.

getWriter

Writer getWriter()

Возвращает Writer для использования скриптом при отображении вывода.

Возвращает:

Writer.

getErrorWriter

Writer getErrorWriter()

Возвращает Writer для отображения сообщений об ошибках.

Возвращает:

Writer

setWriter

void setWriter(Writer writer)

Устанавливает Writer для использования скриптом при отображении вывода.

Параметры:

writer - Новый Writer.

setErrorWriter

void setErrorWriter(Writer writer)

Устанавливает Writer для отображения сообщений об ошибках.

Параметры:

writer - Writer.

getReader

Reader getReader()

Возвращает Reader для чтения данных скриптом.

Возвращает:

Reader.

setReader

void setReader(Reader reader)

Устанавливает Reader для чтения данных скриптом.

Параметры:

reader - Новый Reader.

getScopes

List<Integer> getScopes()

Возвращает неизменяемый List всех допустимых значений scope в ScriptContext.

Возвращает:

Список значений scope