Класс AbstractScriptEngine

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.

Поля

context

protected ScriptContext context

Значение по умолчанию для этого 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 со значением указанного scope в защищённом поле context.

Переопределяет:

getBindings в интерфейсе ScriptEngine

Параметры:

scope - Указанное scope

Возвращает:

Соответствующее Bindings.

Исключения:

IllegalArgumentException - если значение scope некорректно для типа защищённого поля context.

setBindings

public void setBindings(Bindings bindings,
                        int scope)

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

Переопределяет:

setBindings в интерфейсе ScriptEngine

Параметры:

bindings - Указанные Bindings.

scope - Указанное scope.

Исключения:

IllegalArgumentException - если значение scope некорректно для типа поля context.

NullPointerException - если bindings равно null и scope равно 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 для scope, отличных от 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

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

Параметры:

nn - Bindings для использования в ENGINE_SCOPE

Возвращает:

Возвращаемое значение