Интерфейс Invocable

public interface Invocable

Методы

invokeMethod

Object invokeMethod(Object thiz,
                    String name,
                    Object... args)
             throws ScriptException,
                    NoSuchMethodException

Вызывает метод объекта скрипта, скомпилированного во время предыдущего выполнения скрипта, который сохраняется в состоянии ScriptEngine.

Параметры:

name - Название процедуры, которая должна быть вызвана.

thiz - Если процедура является членом класса, определённого в скрипте, и thiz является экземпляром этого класса, возвращённым предыдущим выполнением или вызовом, указанный метод вызывается через этот экземпляр.

args - Аргументы, передаваемые процедуре. Правила преобразования аргументов в переменные скрипта зависят от реализации.

Возвращает:

Значение, возвращённое процедурой. Правила преобразования переменной скрипта, возвращённой методом скрипта, в объект Java зависят от реализации.

Выбрасывает:

ScriptException - если во время вызова метода произошла ошибка.

NoSuchMethodException - если метод с заданным именем или соответствующими типами аргументов не найден.

NullPointerException - если имя метода равно null.

IllegalArgumentException - если указанный thiz равен null или указанный объект не представляет собой объект скрипта.

invokeFunction

Object invokeFunction(String name,
                      Object... args)
               throws ScriptException,
                      NoSuchMethodException

Используется для вызова процедур и функций верхнего уровня, определённых в скриптах.

Параметры:

name - имя процедуры или функции для вызова

args - Аргументы для передачи процедуре или функции

Возвращает:

Значение, возвращённое процедурой или функцией

Выбрасывает:

ScriptException - если во время вызова метода произошла ошибка.

NoSuchMethodException - если метод с заданным именем или соответствующими типами аргументов не найден.

NullPointerException - если имя метода равно null.

getInterface

<T> T getInterface(Class<T> clasz)

Возвращает реализацию интерфейса, используя функции, скомпилированные в интерпретаторе. Методы интерфейса могут быть реализованы с помощью метода invokeFunction.

Параметры типа:

T - тип возвращаемого интерфейса

Параметры:

clasz - объект Class интерфейса, который нужно вернуть.

Возвращает:

Экземпляр запрошенного интерфейса - null, если запрошенный интерфейс недоступен, т. е. если скомпилированные функции в ScriptEngine не найдены, соответствующие функциям в запрошенном интерфейсе.

Выбрасывает:

IllegalArgumentException - если указанный объект Class равен null или не является интерфейсом.

getInterface

<T> T getInterface(Object thiz,
                   Class<T> clasz)

Возвращает реализацию интерфейса, используя методы члена объекта скрипта, скомпилированные в интерпретаторе. Методы интерфейса могут быть реализованы с помощью метода invokeMethod.

Параметры типа:

T - тип возвращаемого интерфейса

Параметры:

thiz - объект скрипта, члены которого используются для реализации методов интерфейса.

clasz - объект Class интерфейса, который нужно вернуть.

Возвращает:

Экземпляр запрошенного интерфейса - null, если запрошенный интерфейс недоступен, т. е. если скомпилированные методы в ScriptEngine не найдены, соответствующие методам в запрошенном интерфейсе.

Выбрасывает:

IllegalArgumentException - если указанный объект Class равен null или не является интерфейсом, или если указанный объект равен null или не представляет собой объект скрипта.