Класс 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`.

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

ARGV, ENGINE, ENGINE_VERSION, FILENAME, LANGUAGE, LANGUAGE_VERSION, 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)`	Устанавливает значение защищённого поля `context` на указанное значение `ScriptContext`.

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

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

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

createBindings, eval, eval, getFactory

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

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)

Устанавливает значение защищённого поля context на указанное значение ScriptContext.

Определено в:: 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 - если значение области видимости некорректно для типа защищённого поля context.

setBindings

public void setBindings(Bindings bindings, int scope)

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

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

put

public void put(String key, Object value)

Устанавливает указанное значение с указанным ключом в ENGINE_SCOPE Bindings защищённого поля context.

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

get

public Object get(String key)

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

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

eval

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

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

Specified by:: eval в интерфейсе ScriptEngine
Parameters:: reader - Reader, содержащий исходный текст скрипта.; bindings - Bindings, используемый для ENGINE_SCOPE во время выполнения скрипта.
Returns:: Значение возвращаемое eval(Reader, ScriptContext)
Throws:: ScriptException - если произошла ошибка в скрипте.; NullPointerException - если любой из параметров равен null.

eval

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

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

Specified by:: eval в интерфейсе ScriptEngine
Parameters:: script - String, содержащий исходный текст скрипта.; bindings - Bindings, используемый как ENGINE_SCOPE во время выполнения скрипта.
Returns:: Значение, возвращаемое eval(String, ScriptContext)
Throws:: ScriptException - если произошла ошибка в скрипте.; NullPointerException - если любой из параметров равен null.

eval

public Object eval(Reader reader) throws ScriptException

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

Specified by:: eval в интерфейсе ScriptEngine
Parameters:: reader - Reader, содержащий исходный текст скрипта.
Returns:: Значение, возвращаемое eval(Reader, ScriptContext)
Throws:: ScriptException - если произошла ошибка в скрипте.; NullPointerException - если любой из параметров равен null.

eval

public Object eval(String script) throws ScriptException

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

Specified by:: eval в интерфейсе ScriptEngine
Parameters:: script - String, содержащий исходный текст скрипта.
Returns:: Значение, возвращаемое eval(String, ScriptContext)
Throws:: 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).

Parameters:: nn - Bindings для использования в ENGINE_SCOPE
Returns:: 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.scripting/javax/script/AbstractScriptEngine.html