Класс AbstractScriptEngine

java.lang.Object

javax.script.AbstractScriptEngine

Все реализованные интерфейсы:: ScriptEngine

public abstract class AbstractScriptEngine extends Object implements ScriptEngine

Предоставляет стандартную реализацию для нескольких вариантов метода eval.

eval(Reader)

eval(String)

eval(String, Bindings)

eval(Reader, Bindings)

реализуются с использованием абстрактных методов

eval(Reader,ScriptContext) или eval(String, ScriptContext)

с помощью SimpleScriptContext.

SimpleScriptContext используется в качестве ScriptContext по умолчанию для AbstractScriptEngine..

Начиная с:: 1.6

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

Модификатор и тип	Поле	Описание
`protected ScriptContext`	`context`	`ScriptContext` по умолчанию для этого `AbstractScriptEngine`.

Поля, объявленные в интерфейсе ScriptEngine

ARGV, ENGINE, ENGINE_VERSION, FILENAME, LANGUAGE, LANGUAGE_VERSION, NAME

Модификатор и тип	Поле	Описание
`static final String`	`ARGV`	Зарезервированный ключ для именованного значения, передающего скрипту массив позиционных аргументов.
`static final String`	`ENGINE`	Зарезервированный ключ для именованного значения, содержащего имя реализации `ScriptEngine`.
`static final String`	`ENGINE_VERSION`	Зарезервированный ключ для именованного значения, определяющего версию реализации `ScriptEngine`.
`static final String`	`FILENAME`	Зарезервированный ключ для именованного значения, содержащего имя исполняемого файла.
`static final String`	`LANGUAGE`	Зарезервированный ключ для именованного значения, содержащего полное название языка сценариев, поддерживаемого реализацией.
`static final String`	`LANGUAGE_VERSION`	Зарезервированный ключ для именованного значения, определяющего версию языка сценариев, поддерживаемого реализацией.
`static final String`	`NAME`	Зарезервированный ключ для именованного значения, определяющего краткое название языка сценариев.

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

Конструктор	Описание
`AbstractScriptEngine()`	Создает новый экземпляр AbstractScriptEngine, используя `SimpleScriptContext` в качестве `ScriptContext` по умолчанию.
`AbstractScriptEngine(Bindings n)`	Создает новый экземпляр, используя указанный `Bindings` в качестве `ENGINE_SCOPE` `Bindings` в защищенном поле `context`.

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

Модификатор и тип	Метод	Описание
`Object`	`eval(Reader reader)`	`eval(Reader)` вызывает абстрактный метод `eval(Reader, ScriptContext)`, передавая значение поля `context`.
`Object`	`eval(Reader reader, Bindings bindings)`	`eval(Reader, Bindings)` вызывает абстрактный метод `eval(Reader, ScriptContext)`, передавая ему `ScriptContext`, в котором Reader, Writers и Bindings для областей, отличных от `ENGINE_SCOPE`, совпадают с соответствующими членами защищенного поля `context`.
`Object`	`eval(String script)`	То же, что и `eval(Reader)`, за исключением того, что используется абстрактный `eval(String, ScriptContext)`.
`Object`	`eval(String script, Bindings bindings)`	То же, что и `eval(Reader, Bindings)`, за исключением того, что используется абстрактный `eval(String, ScriptContext)`.
`Object`	`get(String key)`	Возвращает значение для указанного ключа в `ENGINE_SCOPE` защищенного поля `context`.
`Bindings`	`getBindings(int scope)`	Возвращает `Bindings` с указанным значением области в защищенном поле `context`.
`ScriptContext`	`getContext()`	Возвращает значение защищенного поля `context`.
`protected ScriptContext`	`getScriptContext(Bindings nn)`	Возвращает `SimpleScriptContext`.
`void`	`put(String key, Object value)`	Задает указанное значение для указанного ключа в `ENGINE_SCOPE` `Bindings` защищенного поля `context`.
`void`	`setBindings(Bindings bindings, int scope)`	Задает `Bindings` с соответствующим значением области в поле `context`.
`void`	`setContext(ScriptContext ctxt)`	Задает указанное `ScriptContext` в защищенном поле `context`.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело и подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения определенного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения определенного промежутка реального времени.

Методы, объявленные в интерфейсе ScriptEngine

createBindings, eval, eval, getFactory

Модификатор и тип	Метод	Описание
`Bindings`	`createBindings()`	Возвращает неинициализированный `Bindings`.
`Object`	`eval(Reader reader, ScriptContext context)`	То же, что и `eval(String, ScriptContext)`, но исходный текст сценария считывается из `Reader`.
`Object`	`eval(String script, ScriptContext context)`	Немедленно выполняет сценарий, исходным текстом которого является строка, переданная в качестве первого аргумента.
`ScriptEngineFactory`	`getFactory()`	Возвращает `ScriptEngineFactory` для класса, к которому принадлежит этот `ScriptEngine`.

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

context

protected ScriptContext context

ScriptContext по умолчанию для этого AbstractScriptEngine.

Подробное описание конструкторов

AbstractScriptEngine

public AbstractScriptEngine()

Создает новый экземпляр AbstractScriptEngine, используя SimpleScriptContext в качестве ScriptContext по умолчанию.

AbstractScriptEngine

public AbstractScriptEngine(Bindings n)

Создает новый экземпляр, используя указанный Bindings в качестве ENGINE_SCOPE Bindings в защищенном поле context.

Параметры:: n — указанный Bindings.
Исключения:: NullPointerException — если n равно null.

Подробное описание методов

setContext

public void setContext(ScriptContext ctxt)

Задает указанное ScriptContext в защищенном поле context.

Определено в:: setContext в интерфейсе ScriptEngine
Параметры:: ctxt — указанное ScriptContext.
Исключения:: NullPointerException — если ctxt равно null.

getContext

public ScriptContext getContext()

Возвращает значение защищенного поля context.

Определено в:: getContext в интерфейсе ScriptEngine
Возвращает:: Значение защищенного поля context.

getBindings

public Bindings getBindings(int scope)

Возвращает Bindings с указанным значением области в защищенном поле context.

Определено в:: getBindings в интерфейсе ScriptEngine
Параметры:: scope — указанная область
Возвращает:: Соответствующий Bindings.
Исключения:: IllegalArgumentException — если значение scope недопустимо для типа защищенного поля context.

setBindings

public void setBindings(Bindings bindings, int scope)

Задает Bindings с соответствующим значением области в поле context.

Определено в:: setBindings в интерфейсе ScriptEngine
Параметры:: bindings — указанный Bindings.; scope — указанная область.
Исключения:: IllegalArgumentException — если значение scope недопустимо для типа поля context.; NullPointerException — если bindings равно null, а область — ScriptContext.ENGINE_SCOPE

put

public void put(String key, Object value)

Задает указанное значение для указанного ключа в ENGINE_SCOPE Bindings защищенного поля context.

Определено в:: put в интерфейсе ScriptEngine
Параметры:: key — указанный ключ.; value — указанное значение.
Исключения:: NullPointerException — если key равно null.; IllegalArgumentException — если key пуст.

get

public Object get(String key)

Получает значение для указанного ключа в ENGINE_SCOPE защищенного поля context.

Определено в:: get в интерфейсе ScriptEngine
Параметры:: key — ключ, значение которого необходимо вернуть
Возвращает:: Значение для указанного ключа.
Исключения:: NullPointerException — если key равно null.; IllegalArgumentException — если key пуст.

eval

public Object eval(Reader reader, Bindings bindings) throws ScriptException

eval(Reader, Bindings) вызывает абстрактный метод eval(Reader, ScriptContext), передавая ему ScriptContext, в котором Reader, Writers и Bindings для областей, отличных от ENGINE_SCOPE, совпадают с соответствующими членами защищенного поля context. Указанный Bindings используется вместо ENGINE_SCOPE Bindings поля context.

Определено в:: eval в интерфейсе ScriptEngine
Параметры:: reader — Reader, содержащий исходный текст сценария.; bindings — Bindings, используемый для ENGINE_SCOPE во время выполнения сценария.
Возвращает:: Возвращаемое значение из eval(Reader, ScriptContext)
Исключения:: ScriptException — если в сценарии произошла ошибка.; NullPointerException — если какой-либо параметр равен null.

eval

public Object eval(String script, Bindings bindings) throws ScriptException

То же, что и eval(Reader, Bindings), за исключением того, что используется абстрактный eval(String, ScriptContext).

Определено в:: eval в интерфейсе ScriptEngine
Параметры:: script — String, содержащий исходный текст сценария.; bindings — Bindings, используемый в качестве ENGINE_SCOPE во время выполнения сценария.
Возвращает:: Возвращаемое значение из eval(String, ScriptContext)
Исключения:: ScriptException — если в сценарии произошла ошибка.; NullPointerException — если какой-либо параметр равен null.

eval

public Object eval(Reader reader) throws ScriptException

eval(Reader) вызывает абстрактный eval(Reader, ScriptContext), передавая значение поля context.

Определено в:: eval в интерфейсе ScriptEngine
Параметры:: reader — Reader, содержащий исходный текст сценария.
Возвращает:: Возвращаемое значение из eval(Reader, ScriptContext)
Исключения:: ScriptException — если в сценарии произошла ошибка.; NullPointerException — если какой-либо параметр равен null.

eval

public Object eval(String script) throws ScriptException

То же, что и eval(Reader), за исключением того, что используется абстрактный eval(String, ScriptContext).

Определено в:: eval в интерфейсе ScriptEngine
Параметры:: script — String, содержащий исходный текст сценария.
Возвращает:: Возвращаемое значение из eval(String, ScriptContext)
Исключения:: ScriptException — если в сценарии произошла ошибка.; NullPointerException — если какой-либо параметр равен null.

getScriptContext

protected ScriptContext getScriptContext(Bindings nn)

Возвращает SimpleScriptContext. SimpleScriptContext:

Использует указанный Bindings для своего ENGINE_SCOPE
Использует Bindings, возвращенный абстрактным методом getGlobalScope, в качестве GLOBAL_SCOPE
Использует Reader и Writer из ScriptContext по умолчанию этого ScriptEngine

SimpleScriptContext, возвращенный этим методом, используется для реализации методов eval с помощью абстрактных версий eval(Reader,Bindings) и eval(String,Bindings).

Параметры:: nn — Bindings, используемые для ENGINE_SCOPE
Возвращает:: SimpleScriptContext

© 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.