org.jboss.util
Class Objects

java.lang.Object
  org.jboss.util.Objects

public final class Objects

extends java.lang.Object

A collection of Object utilities.

Objects

public Objects()

getCompatibleConstructor

public static java.lang.reflect.Constructor getCompatibleConstructor(java.lang.Class type,
                                                                     java.lang.Class valueType)

Get a compatible constructor for the given value type

Parameters:

type - Class to look for constructor in

valueType - Argument type for constructor

Returns:

Constructor or null

coerce

public static java.lang.Object coerce(java.lang.Object value,
                                      java.lang.Class type)
                               throws CoercionException (src) 

Coerce the given value into the specified type.

Parameters:

value - Value to coerce.

type - Class type to coerce to.

Returns:

Coerced object.

Primative classes will be translated into their respective wrapper class as needed.

Throws:

NotCoercibleException (src) - Value is not corecible.

CoercionException (src) - Failed to coerce.

coerce

public static java.lang.Object coerce(java.lang.Object[] values,
                                      java.lang.Class type)
                               throws CoercionException (src) 

Coerce the given values into the specified type.

If type is an array, then an array of that type is returned else the first element from values is used.

Coerce will handle primative array types correctly by using the reflection mechanism to unwrap primative values from their wrapper classes.

Parameters:

values - Values to coerce.

type - Class type to coerce object to.

Returns:

Coerced object.

Throws:

NotCoercibleException (src) - Value is not corecible.

CoercionException (src) - Failed to coerce.

java.lang.IllegalArgumentException - Indexed value is null (values contains a null element).

copy

public static java.lang.Object copy(java.io.Serializable obj)
                             throws java.io.IOException,
                                    java.lang.ClassNotFoundException

Copy an serializable object deeply.

Parameters:

obj - Object to copy.

Returns:

Copied object.

Throws:

java.io.IOException

java.lang.ClassCastException

java.lang.ClassNotFoundException

deref

public static java.lang.Object deref(java.lang.Object obj)

Dereference the given object if it is non-null and is an instance of Reference. If the object is null then null is returned. If the object is not an instance of Reference, then the object is returned.

Parameters:

obj - Object to dereference.

Returns:

Dereferenced object.

isArray

public static boolean isArray(java.lang.Object obj)

Check if the given object is an array (primitve or native).

Parameters:

obj - Object to test.

Returns:

True of the object is an array.

toArray

public static java.lang.Object[] toArray(java.lang.Object obj)

Return an Object array for the given object.

Parameters:

obj - Object to convert to an array. Converts primitive arrays to Object arrays consisting of their wrapper classes. If the object is not an array (object or primitve) then a new array of the given type is created and the object is set as the sole element.

equals

public static boolean equals(java.lang.Object[] a,
                             java.lang.Object[] b,
                             boolean deep)

Test the equality of two object arrays.

Parameters:

a - The first array.

b - The second array.

deep - True to traverse elements which are arrays.

Returns:

True if arrays are equal.

equals

public static boolean equals(java.lang.Object[] a,
                             java.lang.Object[] b)

Test the equality of two object arrays.

Parameters:

a - The first array.

b - The second array.

Returns:

True if arrays are equal.