bsh

Class This

java.lang.Object

bsh.This

All Implemented Interfaces:

java.io.Serializable, java.lang.Runnable

public final class This
extends java.lang.Object
implements java.io.Serializable, java.lang.Runnable

'This' is the type of bsh scripted objects. A 'This' object is a bsh scripted object context. It holds a namespace reference and implements event listeners and various other interfaces. This holds a reference to the declaring interpreter for callbacks from outside of bsh.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	This.ConstructorArgs A ConstructorArgs object holds evaluated arguments for a constructor call as well as the index of a possible alternate selector to invoke.

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.Map<java.lang.String,NameSpace>	contextStore

Method Summary

Modifier and Type	Method and Description
static void	bind(This ths, NameSpace namespace, Interpreter declaringInterpreter) Bind a This reference to a parent's namespace with the specified declaring interpreter.
java.lang.Object[]	enumValues() Delegate method to return enum values array.
static This.ConstructorArgs	getConstructorArgs(java.lang.Class<?> superClass, This classStaticThis, java.lang.Object[] consArgs, int index) This method is called by the **generated class** during construction.
java.lang.Object	getInterface(java.lang.Class<?> clas) Get dynamic proxy for interface, caching those it creates.
java.lang.Object	getInterface(java.lang.Class<?>[] ca) Get dynamic proxy for interface, caching those it creates.
NameSpace	getNameSpace()
static void	initInstance(GeneratedClass instance, java.lang.Class<?> genClass, java.lang.Object[] args) Initialize an instance of the class.
static void	initStatic(java.lang.Class<?> genClass) Lazy initialize static context implementation.
java.lang.Object	invokeMethod(java.lang.String methodName, java.lang.Class<?>[] paramTypes, java.lang.Object[] args, boolean declaredOnly) Class generated method stub entry that selects the scripted method by the stub's own parameter types rather than the argument values.
java.lang.Object	invokeMethod(java.lang.String name, java.lang.Object[] args) Invoke specified method as from outside java code, using the declaring interpreter and current namespace.
java.lang.Object	invokeMethod(java.lang.String methodName, java.lang.Object[] args, boolean declaredOnly) Simplified method for class generated method stubs.
java.lang.Object	invokeMethod(java.lang.String methodName, java.lang.Object[] args, Interpreter interpreter, CallStack callstack, Node callerInfo, boolean declaredOnly) Invoke a method in this namespace with the specified args, interpreter reference, callstack, and caller info.
static This	pullBshStatic(java.lang.String uuid) Pull provider for class static This.
void	run()
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

contextStore

public static final java.util.Map<java.lang.String,NameSpace> contextStore

Method Detail

getInterface

public java.lang.Object getInterface(java.lang.Class<?> clas)

Get dynamic proxy for interface, caching those it creates.

getInterface

public java.lang.Object getInterface(java.lang.Class<?>[] ca)

Get dynamic proxy for interface, caching those it creates.

getNameSpace

public NameSpace getNameSpace()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

run

public void run()

Specified by:

run in interface java.lang.Runnable

invokeMethod

public java.lang.Object invokeMethod(java.lang.String name,
                                     java.lang.Object[] args)
                              throws EvalError

Invoke specified method as from outside java code, using the declaring interpreter and current namespace. The call stack will indicate that the method is being invoked from outside of bsh in native java code. Note: you must still wrap/unwrap args/return values using Primitive/Primitive.unwrap() for use outside of BeanShell.

Throws:

EvalError

See Also:

Primitive

invokeMethod

public java.lang.Object invokeMethod(java.lang.String methodName,
                                     java.lang.Object[] args,
                                     boolean declaredOnly)
                              throws EvalError

Simplified method for class generated method stubs. Uses This.namespace and declaringInterpreter and retains callerInfo from namespace.getNode(). Also unwraps Primitives for convenience.

Throws:

EvalError

invokeMethod

public java.lang.Object invokeMethod(java.lang.String methodName,
                                     java.lang.Class<?>[] paramTypes,
                                     java.lang.Object[] args,
                                     boolean declaredOnly)
                              throws EvalError

Class generated method stub entry that selects the scripted method by the stub's own parameter types rather than the argument values.

Throws:

EvalError

invokeMethod

public java.lang.Object invokeMethod(java.lang.String methodName,
                                     java.lang.Object[] args,
                                     Interpreter interpreter,
                                     CallStack callstack,
                                     Node callerInfo,
                                     boolean declaredOnly)
                              throws EvalError

Invoke a method in this namespace with the specified args, interpreter reference, callstack, and caller info.

Note: If you use this method outside of the bsh package and wish to use variables with primitive values you will have to wrap them using bsh.Primitive. Consider using This getInterface() to make a true Java interface for invoking your scripted methods.

This method also implements the default object protocol of toString(), hashCode() and equals() and the invoke() meta-method handling as a last resort.

Note: The invoke() meta-method will not catch the Object protocol methods (toString(), hashCode()...). If you want to override them you have to script them directly.

Parameters:

callstack - if callStack is null a new CallStack will be created and initialized with this namespace.

declaredOnly - if true then only methods declared directly in the namespace will be visible - no inherited or imported methods will be visible.

Throws:

EvalError

See Also:

invokeMethod(String, Object[], Interpreter, CallStack, Node, boolean), Primitive

enumValues

public java.lang.Object[] enumValues()

Delegate method to return enum values array.

Returns:

array of enum values

bind

public static void bind(This ths,
                        NameSpace namespace,
                        Interpreter declaringInterpreter)

Bind a This reference to a parent's namespace with the specified declaring interpreter. Also re-init the callstack. It's necessary to bind a This reference before it can be used after deserialization. This is used by the bsh load() command.

This is a static utility method because it's used by a bsh command bind() and the interpreter doesn't currently allow access to direct methods of This objects (small hack)

getConstructorArgs

public static This.ConstructorArgs getConstructorArgs(java.lang.Class<?> superClass,
                                                      This classStaticThis,
                                                      java.lang.Object[] consArgs,
                                                      int index)

This method is called by the **generated class** during construction. Evaluate the arguments (if any) for the constructor specified by the constructor index. Return the ConstructorArgs object which contains the actual arguments to the alternate constructor and also the index of that constructor for the constructor switch.

Parameters:

consArgs - the arguments to the constructor. These are necessary in the evaluation of the alt constructor args. e.g. Foo(a) { super(a); }

Returns:

the ConstructorArgs object containing a constructor selector and evaluated arguments for the alternate constructor

initInstance

public static void initInstance(GeneratedClass instance,
                                java.lang.Class<?> genClass,
                                java.lang.Object[] args)

Initialize an instance of the class. This method is called from the generated class constructor to evaluate the instance initializer and scripted constructor in the instance namespace.

initStatic

public static void initStatic(java.lang.Class<?> genClass)
                       throws UtilEvalError

Lazy initialize static context implementation. Called from after static This was populated we will now proceed to evaluate the static block node.

Parameters:

genClass - the generated class.

className - name of the class.

Throws:

UtilEvalError - combined exceptions.

pullBshStatic

public static This pullBshStatic(java.lang.String uuid)

Pull provider for class static This. Called from to initialize class BSHSTATIC.

Parameters:

uuid - the class unique id.

Returns:

This from static namespace.