Интерфейс Invocable
public interface Invocable
Необязательный интерфейс, реализуемый ScriptEngine, методы которого позволяют вызывать процедуры в скриптах, выполненных ранее.
- Начиная с версии:
- 1.6
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
<T> T |
getInterface |
Возвращает реализацию интерфейса с использованием функций, скомпилированных в интерпретаторе. |
<T> T |
getInterface |
Возвращает реализацию интерфейса с использованием функций-членов объекта скрипта, скомпилированного в интерпретаторе. |
Object |
invokeFunction |
Используется для вызова процедур и функций верхнего уровня, определённых в скриптах. |
Object |
invokeMethod |
Вызывает метод объекта скрипта, скомпилированного при предыдущем выполнении скрипта и сохранённого в состоянии ScriptEngine. |
Подробное описание методов
invokeMethod
Object invokeMethod(Object thiz, String name, Object... args) throws ScriptException, NoSuchMethodException
Вызывает метод объекта скрипта, скомпилированного при предыдущем выполнении скрипта и сохранённого в состоянии
ScriptEngine.- Параметры:
-
thiz— если процедура является членом класса, определённого в скрипте, а thiz — экземпляр этого класса, возвращённый при предыдущем выполнении или вызове, именованный метод вызывается через этот экземпляр. -
name— имя вызываемой процедуры. -
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 или не представляет собой объект скрипта.
© 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/Invocable.html