com.partnersoft.data

Class ObjectLib

java.lang.Object

com.partnersoft.data.ObjectLib

All Implemented Interfaces:

Lib

public class ObjectLib
extends java.lang.Object
implements Lib

Functions for dealing with objects. Some handy functions for messing with data.

Author:

Paul Reavis Copyright 2003-2006 Partner Software, Inc.

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	areEqual(java.lang.Object a, java.lang.Object b) Something that it seems like the language should handle...
static <T> T[]	concat(T[] first, T[] second) Concatenates two object arrays
static <T> T[]	concatAll(T[] first, T[]... rest) Concatenates N many object arrays
static java.lang.Object	instantiate(java.lang.Class classy) Tries to create an instance of the given class; throws an IllegalArgumentException if it can't.
static java.lang.Object	instantiate(java.lang.String classname) Tries to create an instance of the named class; throws an IllegalArgumentException if it can't.
static java.lang.Object	invokeMethod(java.lang.Object object, java.lang.String methodName, java.util.List<java.lang.Object> arguments) Basically a simplified way to run methods on objects using introspection.
static java.lang.Object	invokeMethod(java.lang.Object object, java.lang.String methodName, java.lang.Object... arguments) Basically a simplified way to run methods on objects using introspection.
static java.lang.Object	invokeMethodThrowExceptions(java.lang.Object object, java.lang.String methodName, java.util.List<java.lang.Object> arguments) Basically a simplified way to run methods on objects using introspection.
static java.lang.Object	invokeMethodThrowExceptions(java.lang.Object object, java.lang.String methodName, java.lang.Object... arguments) Basically a simplified way to run methods on objects using introspection.

Methods inherited from class java.lang.Object

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

Method Detail

instantiate

public static java.lang.Object instantiate(java.lang.Class classy)

Tries to create an instance of the given class; throws an IllegalArgumentException if it can't. Convenient.

instantiate

public static java.lang.Object instantiate(java.lang.String classname)

Tries to create an instance of the named class; throws an IllegalArgumentException if it can't. Convenient.

areEqual

public static boolean areEqual(java.lang.Object a,
               java.lang.Object b)

Something that it seems like the language should handle... equality testing using identity test, then .equals(), dealing with nulls properly.

Parameters:

a - first object to compare

b - second object to compare

Returns:

true if a and b are both null or if a.equals(b)

invokeMethod

public static java.lang.Object invokeMethod(java.lang.Object object,
                            java.lang.String methodName,
                            java.lang.Object... arguments)

Basically a simplified way to run methods on objects using introspection. Logs any exceptions that may occur and returns null if they do.

invokeMethodThrowExceptions

public static java.lang.Object invokeMethodThrowExceptions(java.lang.Object object,
                                           java.lang.String methodName,
                                           java.lang.Object... arguments)
                                                    throws java.lang.IllegalArgumentException,
                                                           java.lang.IllegalAccessException,
                                                           java.lang.reflect.InvocationTargetException,
                                                           java.lang.SecurityException,
                                                           java.lang.NoSuchMethodException

Basically a simplified way to run methods on objects using introspection. Throws any exceptions that may occur.

Throws:

java.lang.reflect.InvocationTargetException

java.lang.IllegalAccessException

java.lang.IllegalArgumentException

java.lang.NoSuchMethodException

java.lang.SecurityException

invokeMethod

public static java.lang.Object invokeMethod(java.lang.Object object,
                            java.lang.String methodName,
                            java.util.List<java.lang.Object> arguments)

Basically a simplified way to run methods on objects using introspection. Logs any exceptions that may occur and returns null if they do.

invokeMethodThrowExceptions

public static java.lang.Object invokeMethodThrowExceptions(java.lang.Object object,
                                           java.lang.String methodName,
                                           java.util.List<java.lang.Object> arguments)
                                                    throws java.lang.IllegalArgumentException,
                                                           java.lang.IllegalAccessException,
                                                           java.lang.reflect.InvocationTargetException,
                                                           java.lang.SecurityException,
                                                           java.lang.NoSuchMethodException

Basically a simplified way to run methods on objects using introspection. Throws any exceptions that may occur.

Throws:

java.lang.reflect.InvocationTargetException

java.lang.IllegalAccessException

java.lang.IllegalArgumentException

java.lang.NoSuchMethodException

java.lang.SecurityException

concat

public static <T> T[] concat(T[] first,
             T[] second)

Concatenates two object arrays

Type Parameters:

T -

Parameters:

first -

second -

Returns:

concatAll

public static <T> T[] concatAll(T[] first,
                T[]... rest)

Concatenates N many object arrays

Type Parameters:

T -

Parameters:

first -

rest -

Returns: