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

Определено в:: 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. Особенности:

Использует указанные 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, 2021, 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/17/docs/api/java.scripting/javax/script/AbstractScriptEngine.html