com.viaoa.util

Class OAReflect

java.lang.Object

com.viaoa.util.OAReflect

Direct Known Subclasses:

ClassModifier

public class OAReflect
extends Object

Used for Reflection services.

Author:

vincevia

See Also:

for storing "extra" properties and setting primitive properties to null., for getting "extra" properties and getting primitive properties as null.

Constructor Summary

Constructors

Constructor and Description
OAReflect()

Method Summary

Modifier and Type	Method and Description
static Object	convertParameterFromString(Class clazz, String value) Convert a String value to a different value of Class clazz.
static Object	convertParameterFromString(Class c, String value, String format) Convert a String value to a different value of Class clazz.
static Object	convertParameterFromString(Method method, String value) Convert String to required object needed as a parameter to Method.
static Object	convertParameterFromString(Method method, String value, String format) Convert String to required object needed as a parameter to Method.
static Object	executeMethod(Object object, Method[] method) Run the following methods from a starting Object.
static Object	executeMethod(Object object, String path) Run the following methods based on a property path from a starting Object.
static Class	getClass(Method m) If a "get" method, will find type of class to send method, else will find the type of return class.
static String[]	getClasses(String packageName) Get name of all classes in a package.
static String	getClassPath(Class clazz) Finds the class path used to be able to load a class.
static Class	getClassWrapper(Class clazz)
static Object	getEmptyPrimitive(Class c)
static Method	getMethod(Class clazz, String methodName)
static Method	getMethod(Class clazz, String methodName, Class classParam)
static Method	getMethod(Class clazz, String methodName, int paramCount) Finds a Method in a class.
static Method	getMethod(Class clazz, String methodName, int paramCount, Object[] args) 20121028
static Method	getMethod(Class clazz, String methodName, Object[] args)
static Method[]	getMethods(Class clazz, String propertyPath) Get the methods for a property path.
static Method[]	getMethods(Class clazz, String propertyPath, boolean bThrowException)
static Method[]	getMethods(Class clazz, String propertyPath, Class substituteClass, boolean bThrowException) Get the methods for a property path.
static Class	getPrimitiveClassWrapper(Class classPrimitive) Returns Class used to wrap a primitive Class.
static Object	getPrimitiveClassWrapperObject(Class clazz) Returns an Object that is of a wrapper class for a primitive type.
static Object	getPropertyValue(Object object, Method method) Uses reflection to get returned value of a method.
static Object	getPropertyValue(Object object, Method[] method) This method will walk through the methods starting with the object supplied and then using the returned object.
static Object	getPropertyValue(Object object, Method[] method, int amt)
static String	getPropertyValueAsString(Object object, Method method) Convert the returned object of a method call to a String value.
static String	getPropertyValueAsString(Object object, Method[] method) Convert the returned object to a String value.
static String	getPropertyValueAsString(Object object, Method[] method, String format) Convert the returned object, from an array of method calls, to a String value.
static String	getPropertyValueAsString(Object object, Method method, String format)
static String	getPropertyValueAsString(Object object, Method method, String format, String nullValue)
static boolean	isEqualEvenIfWrapper(Class c1, Class c2)
static boolean	isFloat(Class clazz) Determines if a class is a Float.
static boolean	isInteger(Class clazz) Determines if a class is a Integer.
static boolean	isNumber(Class clazz) Determines if a class is a Number.
static boolean	isPrimitiveClassWrapper(Class clazz)
static void	main(String[] args)
static void	setPropertyValue(Object object, Method method, Object newValue) Invokes method for an Object using an object value.
static void	setPropertyValue(Object object, Method method, String value) Converts a String object to object type required by method and invokes method
static void	setPropertyValue(Object object, Method method, String value, String format) Converts a String object to object type required by method and invokes method

Methods inherited from class java.lang.Object

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

Constructor Detail

OAReflect

public OAReflect()

Method Detail

getMethod

public static Method getMethod(Class clazz,
                               String methodName)

getMethod

public static Method getMethod(Class clazz,
                               String methodName,
                               int paramCount)

Finds a Method in a class.

Parameters:

clazz - is the Class to use to find method name.

methodName - is case insensitive name of method.
Example: Employee.class, "getLastName")

Returns:

method in clazz that matches methodName.

getMethod

public static Method getMethod(Class clazz,
                               String methodName,
                               Object[] args)

getMethod

public static Method getMethod(Class clazz,
                               String methodName,
                               int paramCount,
                               Object[] args)

20121028

Parameters:

args - list of arguments used in method call

getMethod

public static Method getMethod(Class clazz,
                               String methodName,
                               Class classParam)

getMethods

public static Method[] getMethods(Class clazz,
                                  String propertyPath)

Get the methods for a property path.

Parameters:

clazz - beginning Class object to start with.

propertyPath - is dot "." separated list (case insensitive).
Example: getMethods(Order.class, "employee.department.region.name") will retrieve the following methods: Order.getEmployee(), Employee.getDepartment(), Department.getRegion(), Region.getName()

Note: if any of the propertyNames is a Hub, then it will use the Hub's activeObject when retrieving the property.

Returns:

array of "get' methods that can be used to retrieve a value from an object of type clazz.

See Also:

getPropertyValue(Object,Method), getMethods(Class,String,boolean)

getMethods

public static Method[] getMethods(Class clazz,
                                  String propertyPath,
                                  boolean bThrowException)

getMethods

public static Method[] getMethods(Class clazz,
                                  String propertyPath,
                                  Class substituteClass,
                                  boolean bThrowException)

Get the methods for a property path.

Parameters:

clazz - beginning Class object to start with.

propertyPath - is dot "." separated list (case insensitive).
Example: getMethods(Order.class, "employee.department.region.name") will retrieve the following methods: Order.getEmployee(), Employee.getDepartment(), Department.getRegion(), Region.getName()

Note: if any of the propertyNames is a Hub, then it will use the Hub's activeObject when retrieving the property.

bThrowException - flag to know if an exception should be thrown if methods are not found.

substituteClass - class to use if a link property is of type OAObject.class

Returns:

array of "get' methods that can be used to retrieve a value from an object of type clazz. If the a method can not be found then null is returned.

See Also:

throws OAException if methods can not be found and bThrowException is true. also can use newer OAPropertyPath, which has more info, including the methods

convertParameterFromString

public static Object convertParameterFromString(Method method,
                                                String value)

Convert String to required object needed as a parameter to Method. This will call OAConverter to do the conversion.

Parameters:

method - is Method that value will be sent to.

value - is String that needs to be converted so that it can be used with method.

Returns:

Object that is converted from String value.

See Also:

OAConverter

convertParameterFromString

public static Object convertParameterFromString(Method method,
                                                String value,
                                                String format)

Convert String to required object needed as a parameter to Method. This will call OAConverter to do the conversion.

Parameters:

method - is Method that value will be sent to.

value - is String that needs to be converted so that it can be used with method.

format - is text format used for String.

Returns:

Object that is converted from String value.

See Also:

OAConverter

convertParameterFromString

public static Object convertParameterFromString(Class clazz,
                                                String value)

Convert a String value to a different value of Class clazz. This will call OAConverter to do the conversion.

Parameters:

clazz - Class to convert String value to.

value - is String to convert.

Returns:

Object that is converted from String value.

See Also:

OAConverter

convertParameterFromString

public static Object convertParameterFromString(Class c,
                                                String value,
                                                String format)

Convert a String value to a different value of Class clazz. This will call OAConverter to do the conversion. param clazz Class to convert String value to.

Parameters:

value - is String to convert.

format - is text format used for String.

Returns:

Object that is converted from String value.

See Also:

OAConverter

getPropertyValueAsString

public static String getPropertyValueAsString(Object object,
                                              Method[] method)

Convert the returned object to a String value.

Parameters:

object - beginning object to use when calling methods.

method - array of methods to call. Will use object for the first method, then will follow using the returned object for each method.

Returns:

If any method call returns a null, then null will be returned, else the string value of the last method call.

See Also:

getMethods(java.lang.Class, java.lang.String), getPropertyValue(java.lang.Object, java.lang.reflect.Method[])

getPropertyValueAsString

public static String getPropertyValueAsString(Object object,
                                              Method[] method,
                                              String format)

Convert the returned object, from an array of method calls, to a String value.

Parameters:

object - beginning object to use when calling methods.

method - array of methods to call. Will use object for the first method, then will follow using the returned object for each method.

format - text format to use for conversion to string value.

Returns:

If any method call returns a null, then null will be returned, else the string value of the last method call.

See Also:

getMethods(java.lang.Class, java.lang.String), getPropertyValue(java.lang.Object, java.lang.reflect.Method[])

getPropertyValueAsString

public static String getPropertyValueAsString(Object object,
                                              Method method)

Convert the returned object of a method call to a String value.

Parameters:

object - beginning object to use when calling methods.

method - array of methods to call. Will use object for the first method, then will follow using the returned object for each method. param format text format to use for conversion to string value.

Returns:

If any method call returns a null, then null will be returned, else the string value of the last method call.

See Also:

getMethods(java.lang.Class, java.lang.String), getPropertyValue(java.lang.Object, java.lang.reflect.Method[])

getPropertyValueAsString

public static String getPropertyValueAsString(Object object,
                                              Method method,
                                              String format)

Returns:

if null then "", else formated string, using OAConverter.toString(value, format)

See Also:

getPropertyValueAsString(Object,Method[])

getPropertyValueAsString

public static String getPropertyValueAsString(Object object,
                                              Method method,
                                              String format,
                                              String nullValue)

Returns:

if null then nullValue, else formated string, using OAConverter.toString(value, format)

See Also:

getPropertyValueAsString(Object,Method[])

executeMethod

public static Object executeMethod(Object object,
                                   Method[] method)

Run the following methods from a starting Object.

executeMethod

public static Object executeMethod(Object object,
                                   String path)

Run the following methods based on a property path from a starting Object.

getPropertyValue

public static Object getPropertyValue(Object object,
                                      Method[] method)

This method will walk through the methods starting with the object supplied and then using the returned object. It will

Parameters:

object - beginning object to use

method[] - methods of property path

See Also:

getMethods(java.lang.Class, java.lang.String), getPropertyValueAsString(java.lang.Object, java.lang.reflect.Method[])

getPropertyValue

public static Object getPropertyValue(Object object,
                                      Method[] method,
                                      int amt)

getPropertyValue

public static Object getPropertyValue(Object object,
                                      Method method)

Uses reflection to get returned value of a method. If object is an OAObject, then object.isNull(...) will be checked.

setPropertyValue

public static void setPropertyValue(Object object,
                                    Method method,
                                    String value)

Converts a String object to object type required by method and invokes method

Parameters:

value - String value to use with method

See Also:

convertParameterFromString(java.lang.reflect.Method, java.lang.String)

setPropertyValue

public static void setPropertyValue(Object object,
                                    Method method,
                                    String value,
                                    String format)

Converts a String object to object type required by method and invokes method

Parameters:

value - String value to use with method

format - is format used for value.

See Also:

convertParameterFromString(java.lang.reflect.Method, java.lang.String)

setPropertyValue

public static void setPropertyValue(Object object,
                                    Method method,
                                    Object newValue)

Invokes method for an Object using an object value.

getClass

public static Class getClass(Method m)

If a "get" method, will find type of class to send method, else will find the type of return class.

isNumber

public static boolean isNumber(Class clazz)

Determines if a class is a Number.

isInteger

public static boolean isInteger(Class clazz)

Determines if a class is a Integer.

isFloat

public static boolean isFloat(Class clazz)

Determines if a class is a Float.

getClassWrapper

public static Class getClassWrapper(Class clazz)

getPrimitiveClassWrapper

public static Class getPrimitiveClassWrapper(Class classPrimitive)

Returns Class used to wrap a primitive Class.

isPrimitiveClassWrapper

public static boolean isPrimitiveClassWrapper(Class clazz)

isEqualEvenIfWrapper

public static boolean isEqualEvenIfWrapper(Class c1,
                                           Class c2)

getPrimitiveClassWrapperObject

public static Object getPrimitiveClassWrapperObject(Class clazz)

Returns an Object that is of a wrapper class for a primitive type.

getEmptyPrimitive

public static Object getEmptyPrimitive(Class c)

getClasses

public static String[] getClasses(String packageName)
                           throws ClassNotFoundException,
                                  IOException

Get name of all classes in a package. Example: String[] cs = getClasses("com.viaoa.scheduler.oa"); output: Item SalesOrder Customer etc ...

Parameters:

packageName -

Returns:

String array of class names, without the package prefix or '.class' suffix.

Throws:

ClassNotFoundException

IOException

getClassPath

public static String getClassPath(Class clazz)

Finds the class path used to be able to load a class.

Returns:

the full pathname to the .class file or the .jar file.

main

public static void main(String[] args)
                 throws Exception

Throws:

Exception