com.scriptbasic.utility

Class ReflectionUtility

java.lang.Object

com.scriptbasic.utility.ReflectionUtility

public class ReflectionUtility
extends Object

Author:

Peter Verhas date Aug 2, 2012

Method Summary

Methods

Modifier and Type	Method and Description
static Object	invoke(String symbolicName, ExtendedInterpreter interpreter, Method method, Object object, List<RightValue> args) Invoke the method on the object using the args.
static void	setField(Class<?> klass, String fieldName, Object value) Set the named static field in the class klass.
static void	setField(Object object, String fieldName, Object value) Set the named field of the object be it either inherited by the object class from its parent or declared in the class of the object.

Methods inherited from class java.lang.Object

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

Method Detail

setField

public static void setField(Object object,
            String fieldName,
            Object value)
                     throws NoSuchFieldException,
                            SecurityException,
                            IllegalArgumentException,
                            IllegalAccessException

Set the named field of the object be it either inherited by the object class from its parent or declared in the class of the object. Note that the accessibility (private, protected or package access) is overridden.

Generally the use of this method is a signal of bad practice. Possible uses are copying values from one bean to another, e.g.: configuration value to bean and using the configuration keys to name the field names. When you design such code bear in mind that accepting the name of the field from some external source usually poses a security risk, you have to trust the source from where you get the field names, since any of the fields can be set using this method, even private fields.

Parameters:

object - the object in which the field has to be set. Note that if the object is a Class<?> then the method setField(Class, String, Object) will be invoked.

fieldName - the name of the field

value - the new value of the field

Throws:

NoSuchFieldException - if the field is not declared in the class of the object and also there is no such field inherited from any parent

SecurityException - if the code is not allowed to execute reflection code controlled by the SecurityManager

IllegalArgumentException - if reflection throws this exception, usually the type of the value is not compatible with the named field

IllegalAccessException - if the field can not be set. This is not expected to be thrown since the code sets the accessibility of the field.

invoke

public static Object invoke(String symbolicName,
            ExtendedInterpreter interpreter,
            Method method,
            Object object,
            List<RightValue> args)
                     throws BasicRuntimeException

Invoke the method on the object using the args.

If object is null then call the static method.

Before the Java method call the hook method beforeCallJavaFunction is called.

After the Java method call the hook methodafterCallJavaFunction is called.

Parameters:

interpreter - the interpreter

method - the method to call

object - the object on which the call is to be performed or null in case the method is static

args - the arguments to the method call

Returns:

the object returned by the Java method if any.

Throws:

BasicRuntimeException

setField

public static void setField(Class<?> klass,
            String fieldName,
            Object value)
                     throws NoSuchFieldException,
                            SecurityException,
                            IllegalArgumentException,
                            IllegalAccessException

Set the named static field in the class klass. This method performs the same function as setField(Object, String, Object) except that it sets static fields.

For more information on the arguments and the exceptions see the documentation of the method setField(Object, String, Object).

Parameters:

klass - the class of which the static field to be set.

fieldName -

value -

Throws:

NoSuchFieldException

SecurityException

IllegalArgumentException

IllegalAccessException