Интерфейс ScriptContext

Все известные реализующие классы:: SimpleScriptContext

public interface ScriptContext

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

С:: 1.6

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`ENGINE_SCOPE`	Атрибуты EngineScope видны в течение жизни одного `ScriptEngine`, и для каждого движка поддерживается набор атрибутов.
`static final int`	`GLOBAL_SCOPE`	Атрибуты GlobalScope видны всем движкам, созданным тем же ScriptEngineFactory.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Object`	`getAttribute(String name)`	Возвращает значение атрибута с заданным именем в scope, который встречается раньше в порядке поиска.
`Object`	`getAttribute(String name, int scope)`	Получает значение атрибута в заданном scope.
`int`	`getAttributesScope(String name)`	Получает самый низкий scope, в котором определен атрибут.
`Bindings`	`getBindings(int scope)`	Получает `Bindings`, связанный с заданным scope в этом `ScriptContext`.
`Writer`	`getErrorWriter()`	Возвращает `Writer`, используемый для отображения выходных данных об ошибках.
`Reader`	`getReader()`	Возвращает `Reader`, который будет использоваться скриптом для чтения входных данных.
`List<Integer>`	`getScopes()`	Возвращает неизменяемый `List` всех допустимых значений для scope в ScriptContext.
`Writer`	`getWriter()`	Возвращает `Writer` для использования скриптами при отображении выходных данных.
`Object`	`removeAttribute(String name, int scope)`	Удаляет атрибут в заданном scope.
`void`	`setAttribute(String name, Object value, int scope)`	Устанавливает значение атрибута в заданном scope.
`void`	`setBindings(Bindings bindings, int scope)`	Связывает экземпляр `Bindings` с определенным scope в этом `ScriptContext`.
`void`	`setErrorWriter(Writer writer)`	Устанавливает `Writer`, используемый для отображения выходных данных об ошибках.
`void`	`setReader(Reader reader)`	Устанавливает `Reader` для чтения входных данных скриптами.
`void`	`setWriter(Writer writer)`	Устанавливает `Writer` для использования скриптами при отображении выходных данных.

Подробное описание полей

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 с конкретным областью в этом ScriptContext. Вызовы методов getAttribute и setAttribute должны соответствовать методам get и put экземпляра Bindings для указанной области.

Параметры:: bindings - Экземпляр Bindings для связывания с данной областью; scope - Область
Исключения:: IllegalArgumentException - Если для указанного значения области в ScriptContexts данного типа не определен Bindings.; NullPointerException - если значение области равно ENGINE_SCOPE, а указанный Bindings равен null.

getBindings

Bindings getBindings(int scope)

Возвращает связанный Bindings с заданной областью в данном ScriptContext.

Параметры:: scope - Область
Возвращает:: Связанный Bindings. Возвращает null, если он не был установлен.
Исключения:: IllegalArgumentException - Если для указанного значения области в ScriptContext данного типа не определен Bindings.

setAttribute

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

Устанавливает значение атрибута в заданной области. Если область равна GLOBAL_SCOPE и Bindings не установлен для GLOBAL_SCOPE, вызов setAttribute игнорируется.

Параметры:: name - Имя атрибута для установки; value - Значение атрибута; scope - Область, в которой нужно установить атрибут
Исключения:: IllegalArgumentException - если имя пустое или область некорректная.; NullPointerException - если имя равно null.

getAttribute

Object getAttribute(String name, int scope)

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

Параметры:: name - Имя атрибута для получения.; scope - Область, в которой нужно получить атрибут.
Возвращает:: Значение атрибута. Возвращает null, если имя не существует в заданной области.
Исключения:: IllegalArgumentException - если имя пустое или значение области некорректное.; NullPointerException - если имя равно null.

removeAttribute

Object removeAttribute(String name, int scope)

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

Параметры:: name - Имя атрибута для удаления; scope - Область, в которой нужно удалить атрибут
Возвращает:: Удаленное значение.
Исключения:: IllegalArgumentException - если имя пустое или область некорректная.; NullPointerException - если имя равно null.

getAttribute

Object getAttribute(String name)

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

Параметры:: name - Имя атрибута для получения.
Возвращает:: Значение атрибута в самой низкой области, в которой определен атрибут с заданным именем. Возвращает null, если атрибут с именем не существует ни в одной области.
Исключения:: NullPointerException - если имя равно null.; IllegalArgumentException - если имя пустое.

getAttributesScope

int getAttributesScope(String name)

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

Параметры:: name - Имя атрибута.
Возвращает:: Самая низкая область. Возвращает -1, если атрибут с заданным именем не определен ни в одной области.
Исключения:: 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 всех допустимых значений для области в ScriptContext.

Возвращает:: список значений scope

© 1993, 2025, 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.scripting/javax/script/ScriptContext.html