org.jboss.util

Class Objects

java.lang.Object

org.jboss.util.Objects

public final class Objects
extends Object

A collection of Object utilities.

Author:

Jason Dillon, Ales Justin

Constructor Summary

Constructors

Constructor and Description
Objects()

Method Summary

Methods

Modifier and Type	Method and Description
static Object	copy(Serializable obj) Copy an serializable object deeply.
static Object	deref(Object obj) Dereference the given object if it is non-null and is an instance of Reference.
static <T> T	deref(Object obj, Class<T> expected) Dereference an object
static boolean	equals(Object[] a, Object[] b) Test the equality of two object arrays.
static boolean	equals(Object[] a, Object[] b, boolean deep) Test the equality of two object arrays.
static boolean	equals(Object first, Object second) Test the equality of two objects.
static Constructor	getCompatibleConstructor(Class type, Class valueType) Get a compatible constructor for the given value type
static boolean	isArray(Object obj) Check if the given object is an array (primitve or native).
static Object[]	toArray(Object obj)

Methods inherited from class java.lang.Object

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

Constructor Detail

Objects

public Objects()

Method Detail

getCompatibleConstructor

public static Constructor getCompatibleConstructor(Class type,
                                   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

copy

public static Object copy(Serializable obj)
                   throws IOException,
                          ClassNotFoundException

Copy an serializable object deeply.

Parameters:

obj - Object to copy.

Returns:

Copied object.

Throws:

IOException

ClassNotFoundException

deref

public static Object deref(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.

deref

public static <T> T deref(Object obj,
          Class<T> expected)

Dereference an object

Type Parameters:

T - the expected type

Parameters:

obj - the object or reference

expected - the expected type

Returns:

the object or null

isArray

public static boolean isArray(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 Object[] toArray(Object obj)

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.

Returns:

an Object array for the given object.

equals

public static boolean equals(Object[] a,
             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(Object[] a,
             Object[] b)

Test the equality of two object arrays.

Parameters:

a - The first array.

b - The second array.

Returns:

True if arrays are equal.

equals

public static boolean equals(Object first,
             Object second)

Test the equality of two objects. They can be an (multi dimensional) array.

Parameters:

first - the first obejct

second - the second object

Returns:

true if equal, false otherwise