Spec-Zone.ru › OpenJDK 25

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

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

Конструктор Описание
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.

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

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

Методы, объявленные в интерфейсе 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 — если 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

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации Java SE, которая содержит более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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/AbstractScriptEngine.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API