|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.springframework.util.ObjectUtils
public abstract class ObjectUtils
Miscellaneous object utility methods. Mainly for internal use within the framework; consider Jakarta's Commons Lang for a more comprehensive suite of object utilities.
org.apache.commons.lang.ObjectUtils| Constructor Summary | |
|---|---|
ObjectUtils()
|
|
| Method Summary | |
|---|---|
static Object[] |
addObjectToArray(Object[] array,
Object obj)
Append the given Object to the given array, returning a new array consisting of the input array contents plus the given Object. |
static boolean |
containsElement(Object[] array,
Object element)
Check whether the given array contains the given element. |
static String |
getDisplayString(Object obj)
Return a content-based String representation if obj is
not null; otherwise returns an empty String. |
static String |
getIdentityHexString(Object obj)
Return a hex String form of an object's identity hash code. |
static int |
hashCode(boolean bool)
Return the same value as . |
static int |
hashCode(double dbl)
Return the same value as . |
static int |
hashCode(float flt)
Return the same value as . |
static int |
hashCode(long lng)
Return the same value as . |
static String |
identityToString(Object obj)
Return a String representation of an object's overall identity. |
static boolean |
isCheckedException(Throwable ex)
Return whether the given throwable is a checked exception: that is, neither a RuntimeException nor an Error. |
static boolean |
isCompatibleWithThrowsClause(Throwable ex,
Class[] declaredExceptions)
Check whether the given exception is compatible with the exceptions declared in a throws clause. |
static boolean |
isEmpty(Object[] array)
Return whether the given array is empty: that is, null
or of zero length. |
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(Object obj)
Return as hash code for the given object; typically the value of . |
static int |
nullSafeHashCode(Object[] 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 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(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 String |
nullSafeToString(short[] 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 Detail |
|---|
public ObjectUtils()
| Method Detail |
|---|
public static boolean isCheckedException(Throwable ex)
ex - the throwable to check
Exception,
RuntimeException,
Error
public static boolean isCompatibleWithThrowsClause(Throwable ex,
Class[] declaredExceptions)
ex - the exception to checkeddeclaredExceptions - the exceptions declared in the throws clause
public static boolean isEmpty(Object[] array)
null
or of zero length.
array - the array to check
public static boolean containsElement(Object[] array,
Object element)
array - the array to check (may be null,
in which case the return value will always be false)element - the element to check for
public static Object[] addObjectToArray(Object[] array,
Object obj)
array - the array to append to (can be null)obj - the Object to append
null)public static Object[] toObjectArray(Object source)
A null source value will be converted to an
empty Object array.
source - the (potentially primitive) array
null)
IllegalArgumentException - if the parameter is not an array
public static boolean nullSafeEquals(Object o1,
Object o2)
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.
o1 - first Object to compareo2 - second Object to compare
Arrays.equals(long[], long[])public static int nullSafeHashCode(Object obj)
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.
nullSafeHashCode(Object[]),
nullSafeHashCode(boolean[]),
nullSafeHashCode(byte[]),
nullSafeHashCode(char[]),
nullSafeHashCode(double[]),
nullSafeHashCode(float[]),
nullSafeHashCode(int[]),
nullSafeHashCode(long[]),
nullSafeHashCode(short[])public static int nullSafeHashCode(Object[] array)
array is null, this method returns 0.
public static int nullSafeHashCode(boolean[] array)
array is null, this method returns 0.
public static int nullSafeHashCode(byte[] array)
array is null, this method returns 0.
public static int nullSafeHashCode(char[] array)
array is null, this method returns 0.
public static int nullSafeHashCode(double[] array)
array is null, this method returns 0.
public static int nullSafeHashCode(float[] array)
array is null, this method returns 0.
public static int nullSafeHashCode(int[] array)
array is null, this method returns 0.
public static int nullSafeHashCode(long[] array)
array is null, this method returns 0.
public static int nullSafeHashCode(short[] array)
array is null, this method returns 0.
public static int hashCode(boolean bool)
Boolean.hashCode().
Boolean.hashCode()public static int hashCode(double dbl)
Double.hashCode().
Double.hashCode()public static int hashCode(float flt)
Float.hashCode().
Float.hashCode()public static int hashCode(long lng)
Long.hashCode().
Long.hashCode()public static String identityToString(Object obj)
obj - the object (may be null)
nullpublic static String getIdentityHexString(Object obj)
obj - the object
public static String getDisplayString(Object obj)
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.
obj - the object to build a display String for
objnullSafeToString(Object)public static String nullSafeClassName(Object obj)
Returns "null" if obj is null.
obj - the object to introspect (may be null)
public static String nullSafeToString(Object obj)
Builds a String representation of the contents in case of an array.
Returns "null" if obj is null.
obj - the object to build a String representation for
objpublic static String nullSafeToString(Object[] 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
"null" if array is null.
array - the array to build a String representation for
arraypublic static String nullSafeToString(boolean[] 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
"null" if array is null.
array - the array to build a String representation for
arraypublic static String nullSafeToString(byte[] 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
"null" if array is null.
array - the array to build a String representation for
arraypublic static String nullSafeToString(char[] 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
"null" if array is null.
array - the array to build a String representation for
arraypublic static String nullSafeToString(double[] 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
"null" if array is null.
array - the array to build a String representation for
arraypublic static String nullSafeToString(float[] 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
"null" if array is null.
array - the array to build a String representation for
arraypublic static String nullSafeToString(int[] 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
"null" if array is null.
array - the array to build a String representation for
arraypublic static String nullSafeToString(long[] 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
"null" if array is null.
array - the array to build a String representation for
arraypublic static String nullSafeToString(short[] 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
"null" if array is null.
array - the array to build a String representation for
array
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||