com.ibm.bsf.util
Class EngineUtils
java.lang.Object
|
+--com.ibm.bsf.util.EngineUtils
- public class EngineUtils
- extends java.lang.Object
This class contains utilities that language integrators can use
when implementing the BSFEngine interface.
- Author:
- Sanjiva Weerawarana, Sam Ruby
Method Summary |
static void |
addEventListener(java.lang.Object bean,
java.lang.String eventSetName,
java.lang.String filter,
BSFEngine engine,
BSFManager manager,
java.lang.String source,
int lineNo,
int columnNo,
java.lang.Object script)
Add a script as a listener to some event coming out of an object. |
static java.lang.Object |
callBeanMethod(java.lang.Object bean,
java.lang.String methodName,
java.lang.Object[] args)
Finds and invokes a method with the given signature on the given
bean. |
static java.lang.Object |
createBean(java.lang.String className,
java.lang.Object[] args)
Creates a new bean. |
static java.lang.String |
getTypeSignatureString(java.lang.Class cl)
Given a class return the type signature string fragment for it. |
static java.lang.Class |
loadClass(BSFManager mgr,
java.lang.String name)
Load a class using the class loader of given manager. |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
EngineUtils
public EngineUtils()
createBean
public static java.lang.Object createBean(java.lang.String className,
java.lang.Object[] args)
throws BSFException
- Creates a new bean. The signature of teh 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 instantiateargs
- array of constructor args (or null if none)- Returns:
- the created bean
- Throws:
- BSFException - if something goes wrong (@see
com.ibm.cs.util.MethodUtils for the real
exceptions that can occur).
callBeanMethod
public static java.lang.Object callBeanMethod(java.lang.Object bean,
java.lang.String methodName,
java.lang.Object[] args)
throws BSFException
- 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 methodmethodName
- name of the methodargs
- arguments to be given to the method- Returns:
- the result of invoking the method, if any
- Throws:
- BSFException - if something goes wrong
loadClass
public static java.lang.Class loadClass(BSFManager mgr,
java.lang.String name)
throws BSFException
- 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 are
consultedname
- name of the class to load- Returns:
- the loaded class
- Throws:
- BSFException - if something goes wrong.
addEventListener
public static void addEventListener(java.lang.Object bean,
java.lang.String eventSetName,
java.lang.String filter,
BSFEngine engine,
BSFManager manager,
java.lang.String source,
int lineNo,
int columnNo,
java.lang.Object script)
throws BSFException
- 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 sourceeventSetName
- name of event set from event src to bind tofilter
- filter for eventsengine
- BSFEngine which can run this scriptmanager
- BSFManager of the above enginesource
- (context info) the source of this expression
(e.g., filename)lineNo
- (context info) the line number in source for exprcolumnNo
- (context info) the column number in source for exprscript
- the script to execute when the event occurs- Throws:
- BSFException - if anything goes wrong while running the script
getTypeSignatureString
public static java.lang.String getTypeSignatureString(java.lang.Class cl)
- 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.- Returns:
- the string representing the type signature