Интерфейс ScriptContext

Все известные классы-реализации:: SimpleScriptContext

public interface ScriptContext

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

Начиная с версии:: 1.6

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

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

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

Модификатор и тип	Метод	Описание
`Object`	`getAttribute(String name)`	Получает значение атрибута с указанным именем в области видимости, которая первой встречается в порядке поиска.
`Object`	`getAttribute(String name, int scope)`	Получает значение атрибута в указанной области видимости.
`int`	`getAttributesScope(String name)`	Получает область видимости с наименьшим значением, в которой определен атрибут.
`Bindings`	`getBindings(int scope)`	Получает `Bindings`, связанную с указанной областью видимости в этом `ScriptContext`.
`Writer`	`getErrorWriter()`	Возвращает `Writer`, используемый для вывода сообщений об ошибках.
`Reader`	`getReader()`	Возвращает `Reader`, используемый сценарием для чтения входных данных.
`List<Integer>`	`getScopes()`	Возвращает неизменяемый `List` всех допустимых значений областей видимости в ScriptContext.
`Writer`	`getWriter()`	Возвращает `Writer`, который сценарии могут использовать для вывода данных.
`Object`	`removeAttribute(String name, int scope)`	Удаляет атрибут в указанной области видимости.
`void`	`setAttribute(String name, Object value, int scope)`	Задает значение атрибута в указанной области видимости.
`void`	`setBindings(Bindings bindings, int scope)`	Связывает экземпляр `Bindings` с определенной областью видимости в этом `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 - Если для указанного значения области видимости в ScriptContext этого типа не определен 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 и для GLOBAL_SCOPE не задан Bindings, вызов 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)

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

Параметры:: 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.

Возвращает:: список значений областей видимости

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.scripting/javax/script/ScriptContext.html