| java.lang.Object
 org.apache.bsf.util.EngineUtils
| EngineUtils | | public class EngineUtils (Code) | | This class contains utilities that language integrators can use
when implementing the BSFEngine interface.
author:
Sanjiva Weerawarana
author:
Sam Ruby
author:
Rony G. Flatscher (added addEventListenerReturningEventInfos) |
| Method Summary | |
| public static void | addEventListener(Object bean, String eventSetName, String filter, BSFEngine engine, BSFManager manager, String source, int lineNo, int columnNo, Object script)
Add a script as a listener to some event coming out of an object. | | public static void | addEventListenerReturningEventInfos(Object bean, String eventSetName, String filter, BSFEngine engine, BSFManager manager, String source, int lineNo, int columnNo, Object script, Object dataFromScriptingEngine)
Add a script as a listener to some event coming out of an object. | | public static Object | callBeanMethod(Object bean, String methodName, Object[] args)
Finds and invokes a method with the given signature on the given
bean. | | public static Object | createBean(String className, Object args)
Creates a new bean. | | public static String | getTypeSignatureString(Class cl)
Given a class return the type signature string fragment for it.
That is, return "I" for int, "J" for long, ... | | public static Class | loadClass(BSFManager mgr, String name)
Load a class using the class loader of given manager. |
| bMethodHasSetAccessible | | static boolean bMethodHasSetAccessible(Code) | | |
| addEventListener | | public static void addEventListener(Object bean, String eventSetName, String filter, BSFEngine engine, BSFManager manager, String source, int lineNo, int columnNo, Object script) throws BSFException(Code) | | Add a script as a listener to some event coming out of an object. The
first two args identify the src of the event and the event set
and the rest identify the script which should be run when the event
fires.
Parameters:
bean - event source
Parameters:
eventSetName - name of event set from event src to bind to
Parameters:
filter - filter for events
Parameters:
engine - BSFEngine which can run this script
Parameters:
manager - BSFManager of the above engine
Parameters:
source - (context info) the source of this expression(e.g., filename)
Parameters:
lineNo - (context info) the line number in source for expr
Parameters:
columnNo - (context info) the column number in source for expr
Parameters:
script - the script to execute when the event occurs
exception:
BSFException - if anything goes wrong while running the script |
| addEventListenerReturningEventInfos | | public static void addEventListenerReturningEventInfos(Object bean, String eventSetName, String filter, BSFEngine engine, BSFManager manager, String source, int lineNo, int columnNo, Object script, Object dataFromScriptingEngine) throws BSFException(Code) | | Add a script as a listener to some event coming out of an object. The
first two args identify the src of the event and the event set
and the rest identify the script which should be run when the event
fires. The processing will use the engine's apply() method.
Parameters:
bean - event source
Parameters:
eventSetName - name of event set from event src to bind to
Parameters:
filter - filter for events
Parameters:
engine - BSFEngine which can run this script
Parameters:
manager - BSFManager of the above engine
Parameters:
source - (context info) the source of this expression (e.g., filename)
Parameters:
lineNo - (context info) the line number in source for expr
Parameters:
columnNo - (context info) the column number in source for expr
Parameters:
script - the script to execute when the event occurs
Parameters:
dataFromScriptingEngine - this contains any object supplied by the scripting engine and gets sentback with the supplied script, if the event occurs.This could be used e.g. for indicating to the scripting engine whichscripting engine object/routine/function/procedureshould be ultimately informed of the event occurrence.
exception:
BSFException - if anything goes wrong while running the script |
| callBeanMethod | | public static Object callBeanMethod(Object bean, String methodName, Object[] args) throws BSFException(Code) | | Finds and invokes a method with the given signature on the given
bean. The signature of the method that's invoked is first taken
as the types of the args, but if that fails, this tries to convert
any primitive wrapper type args to their primitive counterparts
to see whether a method exists that way. If it does, done.
Parameters:
bean - the object on which to invoke the method
Parameters:
methodName - name of the method
Parameters:
args - arguments to be given to the method the result of invoking the method, if any
exception:
BSFException - if something goes wrong |
| createBean | | public static Object createBean(String className, Object args) throws BSFException(Code) | | Creates a new bean. The signature of the constructor that's invoked
is first taken as the types of the args, but if that fails, this tries
to convert any primitive wrapper type args to their primitive
counterparts to see whether a method exists that way. If it does, done.
Parameters:
className - fully qualified name of class to instantiate
Parameters:
args - array of constructor args (or null if none) the created bean
exception:
BSFException - if something goes wrong (@seeorg.apache.cs.util.MethodUtils for the realexceptions that can occur). |
| getTypeSignatureString | | public static String getTypeSignatureString(Class cl)(Code) | | Given a class return the type signature string fragment for it.
That is, return "I" for int, "J" for long, ... etc..
Parameters:
cl - class object for whom the signature fragment is needed. the string representing the type signature |
| loadClass | | public static Class loadClass(BSFManager mgr, String name) throws BSFException(Code) | | Load a class using the class loader of given manager. If that fails
try using a class loader that loads from the tempdir of the manager.
Parameters:
mgr - BSFManager who's classLoader and tempDir props areconsulted
Parameters:
name - name of the class to load the loaded class
exception:
BSFException - if something goes wrong. |
|
|