| javax.script.Invocable
All known Subclasses: bsh.engine.BshScriptEngine,
| Invocable | | public interface Invocable (Code) | | The optional interface implemented by ScriptEngines whose methods allow the invocation of
procedures in scripts that have previously been executed.
version:
1.0
author:
Mike Grogan
author:
A. Sundararajan
since:
1.6 |
| Method Summary | |
| public T | getInterface(Class<T> clasz)
Returns an implementation of an interface using procedures compiled in
the interpreter. | | public T | getInterface(Object thiz, Class<T> clasz)
Returns an implementation of an interface using member functions of
a scripting object compiled in the interpreter. | | public Object | invoke(Object thiz, String name, Object... args)
Calls a procedure compiled during a previous script execution, which is retained in
the state of the ScriptEngine.
Parameters:
name - The name of the procedure to be called.
Parameters:
thiz - If the procedure is a member of a classdefined in the script and thiz is an instance of that classreturned by a previous execution or invocation, the named method is called through that instance.If classes are not supported in the scripting language or if the procedure is not a member function of any class, the argument must be null.
Parameters:
args - Arguments to pass to the procedure. | | public Object | invoke(String name, Object... args)
Same as invoke(Object, String, Object...) with null as the first
argument. |
| getInterface | | public T getInterface(Class<T> clasz)(Code) | | Returns an implementation of an interface using procedures compiled in
the interpreter. The methods of the interface
may be implemented using the invoke method.
Parameters:
clasz - The Class object of the interface to return. An instance of requested interface - null if the requested interface is unavailable, i. e. if compiled methods in the ScriptEngine cannot be found matching the ones in the requested interface.
throws:
IllegalArgumentException - if the specified Class objectdoes not exist or is not an interface. |
| getInterface | | public T getInterface(Object thiz, Class<T> clasz)(Code) | | Returns an implementation of an interface using member functions of
a scripting object compiled in the interpreter. The methods of the
interface may be implemented using invoke(Object, String, Object...)
method.
Parameters:
thiz - The scripting object whose member functions are used to implement the methods of the interface.
Parameters:
clasz - The Class object of the interface to return. An instance of requested interface - null if the requested interface is unavailable, i. e. if compiled methods in the ScriptEngine cannot be found matching the ones in the requested interface.
throws:
IllegalArgumentException - if the specified Class objectdoes not exist or is not an interface, or if the specified Object is null or does not represent a scripting object. |
| invoke | | public Object invoke(Object thiz, String name, Object... args) throws ScriptException, NoSuchMethodException(Code) | | Calls a procedure compiled during a previous script execution, which is retained in
the state of the ScriptEngine.
Parameters:
name - The name of the procedure to be called.
Parameters:
thiz - If the procedure is a member of a classdefined in the script and thiz is an instance of that classreturned by a previous execution or invocation, the named method is called through that instance.If classes are not supported in the scripting language or if the procedure is not a member function of any class, the argument must be null.
Parameters:
args - Arguments to pass to the procedure. The rules for convertingthe arguments to scripting variables are implementation-specific. The value returned by the procedure. The rules for converting the scripting variable returned by the procedure to a Java Object are implementation-specific.
throws:
ScriptException - if an error occurrs during invocation of the method.
throws:
NoSuchMethodException - if method with given name or matching argument types cannot be found.
throws:
NullPointerException - if method name is null. |
|
|