Package com.aspectran.utils

Class ObjectUtils

java.lang.Object

com.aspectran.utils.ObjectUtils

public abstract class ObjectUtils
extends Object

This class is a clone of org.springframework.util.ObjectUtils

Miscellaneous object utility methods.

Constructor Summary

Constructors

Constructor	Description
ObjectUtils()

Method Summary

Modifier and Type	Method	Description
static String	getDisplayString(Object obj)	Return a content-based String representation if obj is not null; otherwise returns an empty String.
static boolean	isArray(Object obj)	Determine whether the given object is an array: either an Object array or a primitive array.
static boolean	isEmpty(Object obj)	Determine whether the given object is empty.
static boolean	isEmpty(Object[] array)	Determine whether the given array is empty: i.e.
static String	nullSafeClassName(Object obj)	Determine the class name for the given object.
static boolean	nullSafeEquals(Object o1, Object o2)	Determine if the given objects are equal, returning true if both are null or false if only one is null.
static int	nullSafeHashCode(boolean[] array)	Return a hash code based on the contents of the specified array.
static int	nullSafeHashCode(byte[] array)	Return a hash code based on the contents of the specified array.
static int	nullSafeHashCode(char[] array)	Return a hash code based on the contents of the specified array.
static int	nullSafeHashCode(double[] array)	Return a hash code based on the contents of the specified array.
static int	nullSafeHashCode(float[] array)	Return a hash code based on the contents of the specified array.
static int	nullSafeHashCode(int[] array)	Return a hash code based on the contents of the specified array.
static int	nullSafeHashCode(long[] array)	Return a hash code based on the contents of the specified array.
static int	nullSafeHashCode(short[] array)	Return a hash code based on the contents of the specified array.
static int	nullSafeHashCode(Object obj)	Return as hash code for the given object; typically the value of Object#hashCode()}.
static int	nullSafeHashCode(Object[] array)	Return a hash code based on the contents of the specified array.
static String	nullSafeToString(boolean[] array)	Return a String representation of the contents of the specified array.
static String	nullSafeToString(byte[] array)	Return a String representation of the contents of the specified array.
static String	nullSafeToString(char[] array)	Return a String representation of the contents of the specified array.
static String	nullSafeToString(double[] array)	Return a String representation of the contents of the specified array.
static String	nullSafeToString(float[] array)	Return a String representation of the contents of the specified array.
static String	nullSafeToString(int[] array)	Return a String representation of the contents of the specified array.
static String	nullSafeToString(long[] array)	Return a String representation of the contents of the specified array.
static String	nullSafeToString(short[] array)	Return a String representation of the contents of the specified array.
static String	nullSafeToString(Object obj)	Return a String representation of the specified Object.
static String	nullSafeToString(Object[] array)	Return a String representation of the contents of the specified array.
static Object[]	toObjectArray(Object source)	Convert the given array (which may be a primitive array) to an object array (if necessary of primitive wrapper objects).

Methods inherited from class java.lang.Object

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

Constructor Details

ObjectUtils

public ObjectUtils()

Method Details

isArray

public static boolean isArray(@Nullable
 Object obj)

Determine whether the given object is an array: either an Object array or a primitive array.

Parameters:

obj - the object to check

isEmpty

public static boolean isEmpty(@Nullable
 Object[] array)

Determine whether the given array is empty: i.e. null or of zero length.

Parameters:

array - the array to check

See Also:

• isEmpty(Object)

isEmpty

public static boolean isEmpty(@Nullable
 Object obj)

Determine whether the given object is empty.

This method supports the following object types.

• Optional: considered empty if Optional.empty()
• Array: considered empty if its length is zero
• CharSequence: considered empty if its length is zero
• Collection: delegates to Collection.isEmpty()
• Map: delegates to Map.isEmpty()

If the given object is non-null and not one of the aforementioned supported types, this method returns false.

Parameters:

obj - the object to check

Returns:

true if the object is null or empty

See Also:

• Optional.isPresent()
• isEmpty(Object[])
• StringUtils.hasLength(CharSequence)

toObjectArray

public static Object[] toObjectArray(@Nullable
 Object source)

Convert the given array (which may be a primitive array) to an object array (if necessary of primitive wrapper objects).

A null source value will be converted to an empty Object array.

Parameters:

source - the (potentially primitive) array

Returns:

the corresponding object array (never null)

Throws:

IllegalArgumentException - if the parameter is not an array

nullSafeEquals

public static boolean nullSafeEquals(Object o1,
 Object o2)

Determine if the given objects are equal, returning true if both are null or false if only one is null.

Compares arrays with Arrays.equals, performing an equality check based on the array elements rather than the array reference.

Parameters:

o1 - first Object to compare

o2 - second Object to compare

Returns:

whether the given objects are equal

nullSafeHashCode

public static int nullSafeHashCode(Object obj)

Return as hash code for the given object; typically the value of Object#hashCode()}. If the object is an array, this method will delegate to any of the nullSafeHashCode methods for arrays in this class. If the object is null, this method returns 0.

Parameters:

obj - the given object

Returns:

a hash code value

nullSafeHashCode

public static int nullSafeHashCode(Object[] array)

Return a hash code based on the contents of the specified array. If array is null, this method returns 0.

Parameters:

array - the specified array

Returns:

a hash code value

nullSafeHashCode

public static int nullSafeHashCode(boolean[] array)

Return a hash code based on the contents of the specified array. If array is null, this method returns 0.

Parameters:

array - the specified array

Returns:

a hash code value

nullSafeHashCode

public static int nullSafeHashCode(byte[] array)

Return a hash code based on the contents of the specified array. If array is null, this method returns 0.

Parameters:

array - the specified array

Returns:

a hash code value

nullSafeHashCode

public static int nullSafeHashCode(char[] array)

Return a hash code based on the contents of the specified array. If array is null, this method returns 0.

Parameters:

array - the specified array

Returns:

a hash code value

nullSafeHashCode

public static int nullSafeHashCode(double[] array)

Return a hash code based on the contents of the specified array. If array is null, this method returns 0.

Parameters:

array - the specified array

Returns:

a hash code value

nullSafeHashCode

public static int nullSafeHashCode(float[] array)

Return a hash code based on the contents of the specified array. If array is null, this method returns 0.

Parameters:

array - the specified array

Returns:

a hash code value

nullSafeHashCode

public static int nullSafeHashCode(int[] array)

Return a hash code based on the contents of the specified array. If array is null, this method returns 0.

Parameters:

array - the specified array

Returns:

a hash code value

nullSafeHashCode

public static int nullSafeHashCode(long[] array)

Return a hash code based on the contents of the specified array. If array is null, this method returns 0.

Parameters:

array - the specified array

Returns:

a hash code value

nullSafeHashCode

public static int nullSafeHashCode(short[] array)

Return a hash code based on the contents of the specified array. If array is null, this method returns 0.

Parameters:

array - the specified array

Returns:

a hash code value

getDisplayString

public static String getDisplayString(@Nullable
 Object obj)

Return a content-based String representation if obj is not null; otherwise returns an empty String.

Differs from nullSafeToString(Object) in that it returns an empty String rather than "null" for a null value.

Parameters:

obj - the object to build a display String for

Returns:

a display String representation of obj

See Also:

• nullSafeToString(Object)

nullSafeClassName

public static String nullSafeClassName(@Nullable
 Object obj)

Determine the class name for the given object.

Returns a "null" String if obj is null.

Parameters:

obj - the object to introspect (may be null)

Returns:

the corresponding class name

nullSafeToString

public static String nullSafeToString(@Nullable
 Object obj)

Return a String representation of the specified Object.

Builds a String representation of the contents in case of an array. Returns a "null" String if obj is null.

Parameters:

obj - the object to build a String representation for

Returns:

a String representation of obj

nullSafeToString

public static String nullSafeToString(@Nullable
 Object[] array)

Return a String representation of the contents of the specified array.

The String representation consists of a list of the array's elements, enclosed in curly braces ("{}"). Adjacent elements are separated by the characters ", " (a comma followed by a space). Returns a "null" String if array is null.

Parameters:

array - the array to build a String representation for

Returns:

a String representation of array

nullSafeToString

public static String nullSafeToString(@Nullable
 boolean[] array)

Return a String representation of the contents of the specified array.

The String representation consists of a list of the array's elements, enclosed in curly braces ("{}"). Adjacent elements are separated by the characters ", " (a comma followed by a space). Returns a "null" String if array is null.

Parameters:

array - the array to build a String representation for

Returns:

a String representation of array

nullSafeToString

public static String nullSafeToString(@Nullable
 byte[] array)

Return a String representation of the contents of the specified array.

The String representation consists of a list of the array's elements, enclosed in curly braces ("{}"). Adjacent elements are separated by the characters ", " (a comma followed by a space). Returns a "null" String if array is null.

Parameters:

array - the array to build a String representation for

Returns:

a String representation of array

nullSafeToString

public static String nullSafeToString(@Nullable
 char[] array)

Return a String representation of the contents of the specified array.

The String representation consists of a list of the array's elements, enclosed in curly braces ("{}"). Adjacent elements are separated by the characters ", " (a comma followed by a space). Returns a "null" String if array is null.

Parameters:

array - the array to build a String representation for

Returns:

a String representation of array

nullSafeToString

public static String nullSafeToString(@Nullable
 double[] array)

Return a String representation of the contents of the specified array.

The String representation consists of a list of the array's elements, enclosed in curly braces ("{}"). Adjacent elements are separated by the characters ", " (a comma followed by a space). Returns a "null" String if array is null.

Parameters:

array - the array to build a String representation for

Returns:

a String representation of array

nullSafeToString

public static String nullSafeToString(@Nullable
 float[] array)

Return a String representation of the contents of the specified array.

The String representation consists of a list of the array's elements, enclosed in curly braces ("{}"). Adjacent elements are separated by the characters ", " (a comma followed by a space). Returns a "null" String if array is null.

Parameters:

array - the array to build a String representation for

Returns:

a String representation of array

nullSafeToString

public static String nullSafeToString(@Nullable
 int[] array)

Return a String representation of the contents of the specified array.

The String representation consists of a list of the array's elements, enclosed in curly braces ("{}"). Adjacent elements are separated by the characters ", " (a comma followed by a space). Returns a "null" String if array is null.

Parameters:

array - the array to build a String representation for

Returns:

a String representation of array

nullSafeToString

public static String nullSafeToString(@Nullable
 long[] array)

Return a String representation of the contents of the specified array.

The String representation consists of a list of the array's elements, enclosed in curly braces ("{}"). Adjacent elements are separated by the characters ", " (a comma followed by a space). Returns a "null" String if array is null.

Parameters:

array - the array to build a String representation for

Returns:

a String representation of array

nullSafeToString

public static String nullSafeToString(@Nullable
 short[] array)

Return a String representation of the contents of the specified array.

The String representation consists of a list of the array's elements, enclosed in curly braces ("{}"). Adjacent elements are separated by the characters ", " (a comma followed by a space). Returns a "null" String if array is null.

Parameters:

array - the array to build a String representation for

Returns:

a String representation of array