ObjectUtils (GigaSpaces 15.8.0 API)

java.lang.Object
- com.gigaspaces.internal.utils.ObjectUtils

```
public abstract class ObjectUtils
extends Object
```
Miscellaneous object utility methods. Mainly for internal use within the framework; consider Jakarta's Commons Lang for a more comprehensive suite of object utilities.

Author:

kimchy

Constructor Summary

Constructors
Constructor and Description

ObjectUtils()

Constructors
Constructor and Description
`ObjectUtils()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static <T> T[]`	`addObjectToArray(T[] array, T obj)` Append the given Object to the given array, returning a new array consisting of the input array contents plus the given Object.
`static <T> T`	`assertArgumentNotNull(T argument, String argumentName)` Throws an IllegalArgumentException if the provided argument is null.
`static boolean`	`equals(Object o1, Object o2)`
`static Object`	`getDefaultValue(Class<?> type)` Returns null for reference types and a boxed default value for primitive types
`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 Class<?>`	`getPrimitive(String typeName)` Gets the class represeting the primitive type denoted by 'name' if 'name' denotes a primitive and null otherwise.
`static int`	`hashCode(boolean bool)` Return the same value as `Boolean.hashCode()`.
`static int`	`hashCode(double dbl)` Return the same value as `Double.hashCode()`.
`static int`	`hashCode(float flt)` Return the same value as `Float.hashCode()`.
`static int`	`hashCode(long lng)` Return the same value as `Long.hashCode()`.
`static int`	`hashCode(Object o)`
`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 boolean`	`isPrimitive(String typeName)` Returns whether the specified type name is of primitive type
`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 `Object.hashCode()`.
`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.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ObjectUtils
```
public ObjectUtils()
```
- Method Detail
  - isCheckedException
```
public static boolean isCheckedException(Throwable ex)
```
    Return whether the given throwable is a checked exception: that is, neither a RuntimeException nor an Error.
    
    Parameters:
    
    ex - the throwable to check
    
    Returns:
    
    whether the throwable is a checked exception
    
    See Also:
    
    Exception, RuntimeException, Error
  - isCompatibleWithThrowsClause
```
public static boolean isCompatibleWithThrowsClause(Throwable ex,
                                                   Class<?>[] declaredExceptions)
```
    Check whether the given exception is compatible with the exceptions declared in a throws clause.
    
    Parameters:
    
    ex - the exception to checked
    
    declaredExceptions - the exceptions declared in the throws clause
    
    Returns:
    
    whether the given exception is compatible
  - isEmpty
```
public static boolean isEmpty(Object[] array)
```
    Return whether the given array is empty: that is, null or of zero length.
    
    Parameters:
    
    array - the array to check
  - addObjectToArray
```
public static <T> T[] addObjectToArray(T[] array,
                                       T obj)
```
    Append the given Object to the given array, returning a new array consisting of the input array contents plus the given Object.
    
    Parameters:
    
    array - the array to append to (can be null)
    
    obj - the Object to append
    
    Returns:
    
    the new array (of the same component type; never null)
  - hashCode
```
public static int hashCode(Object o)
```
  - equals
```
public static boolean equals(Object o1,
                             Object o2)
```
  - 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
    
    See Also:
    
    Arrays.equals(long[], long[])
  - 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.
    
    See Also:
    
    nullSafeHashCode(Object[]), nullSafeHashCode(boolean[]), nullSafeHashCode(byte[]), nullSafeHashCode(char[]), nullSafeHashCode(double[]), nullSafeHashCode(float[]), nullSafeHashCode(int[]), nullSafeHashCode(long[]), nullSafeHashCode(short[])
  - 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.
  - 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.
  - 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.
  - 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.
  - 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.
  - 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.
  - 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.
  - 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.
  - 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.
  - hashCode
```
public static int hashCode(boolean bool)
```
    Return the same value as Boolean.hashCode().
    
    See Also:
    
    Boolean.hashCode()
  - hashCode
```
public static int hashCode(double dbl)
```
    Return the same value as Double.hashCode().
    
    See Also:
    
    Double.hashCode()
  - hashCode
```
public static int hashCode(float flt)
```
    Return the same value as Float.hashCode().
    
    See Also:
    
    Float.hashCode()
  - hashCode
```
public static int hashCode(long lng)
```
    Return the same value as Long.hashCode().
    
    See Also:
    
    Long.hashCode()
  - nullSafeToString
```
public static String nullSafeToString(Object obj)
```
    Return a String representation of the specified Object.
    Returns the String 'null' if obj is null.
    
    Parameters:
    
    obj - the object whose String representation to return
    
    Returns:
    
    a String representation of obj
  - nullSafeToString
```
public static String nullSafeToString(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 "null" if array is null.
    
    Parameters:
    
    array - the array whose String representation to return
    
    Returns:
    
    a String representation of array
  - nullSafeToString
```
public static String nullSafeToString(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 "null" if array is null.
    
    Parameters:
    
    array - the array whose String representation to return
    
    Returns:
    
    a String representation of array
  - nullSafeToString
```
public static String nullSafeToString(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 "null" if array is null.
    
    Parameters:
    
    array - the array whose String representation to return
    
    Returns:
    
    a String representation of array
  - nullSafeToString
```
public static String nullSafeToString(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 "null" if array is null.
    
    Parameters:
    
    array - the array whose String representation to return
    
    Returns:
    
    a String representation of array
  - nullSafeToString
```
public static String nullSafeToString(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 "null" if array is null.
    
    Parameters:
    
    array - the array whose String representation to return
    
    Returns:
    
    a String representation of array
  - nullSafeToString
```
public static String nullSafeToString(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 "null" if array is null.
    
    Parameters:
    
    array - the array whose String representation to return
    
    Returns:
    
    a String representation of array
  - nullSafeToString
```
public static String nullSafeToString(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 "null" if array is null.
    
    Parameters:
    
    array - the array whose String representation to return
    
    Returns:
    
    a String representation of array
  - nullSafeToString
```
public static String nullSafeToString(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 "null" if array is null.
    
    Parameters:
    
    array - the array whose String representation to return
    
    Returns:
    
    a String representation of array
  - nullSafeToString
```
public static String nullSafeToString(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 "null" if array is null.
    
    Parameters:
    
    array - the array whose String representation to return
    
    Returns:
    
    a String representation of array
  - identityToString
```
public static String identityToString(Object obj)
```
    Return a String representation of an object's overall identity.
    
    Parameters:
    
    obj - the object (may be null)
    
    Returns:
    
    the object's identity as String representation, or null if the object was null
  - getIdentityHexString
```
public static String getIdentityHexString(Object obj)
```
    Return a hex String form of an object's identity hash code.
    
    Parameters:
    
    obj - the object
    
    Returns:
    
    the object's identity code in hex notation
  - getDisplayString
```
public static String getDisplayString(Object obj)
```
    Return a content-based String representation if obj is not null; otherwise returns an empty String.
    Differs from nullSafeToString in that it returns an empty String rather than "null" for a null value.
    
    See Also:
    
    nullSafeToString(Object)
  - isPrimitive
```
public static boolean isPrimitive(String typeName)
```
    Returns whether the specified type name is of primitive type
  - getPrimitive
```
public static Class<?> getPrimitive(String typeName)
```
    Gets the class represeting the primitive type denoted by 'name' if 'name' denotes a primitive and null otherwise.
  - getDefaultValue
```
public static Object getDefaultValue(Class<?> type)
```
    Returns null for reference types and a boxed default value for primitive types
  - assertArgumentNotNull
```
public static <T> T assertArgumentNotNull(T argument,
                                          String argumentName)
```
    Throws an IllegalArgumentException if the provided argument is null.
    
    Type Parameters:
    
    T - The argument type.
    
    Parameters:
    
    argument - The argument instance to check.
    
    argumentName - The argument name (for thrown Exception message).
    
    Returns:
    
    Returns the provided argument if exception wasn't thrown

Class ObjectUtils

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ObjectUtils

Method Detail

isCheckedException

isCompatibleWithThrowsClause

isEmpty

addObjectToArray

hashCode

equals

nullSafeEquals

nullSafeHashCode

nullSafeHashCode

nullSafeHashCode

nullSafeHashCode

nullSafeHashCode

nullSafeHashCode

nullSafeHashCode

nullSafeHashCode

nullSafeHashCode

nullSafeHashCode

hashCode

hashCode

hashCode

hashCode

nullSafeToString

nullSafeToString

nullSafeToString

nullSafeToString

nullSafeToString

nullSafeToString

nullSafeToString

nullSafeToString

nullSafeToString

nullSafeToString

identityToString

getIdentityHexString

getDisplayString

isPrimitive

getPrimitive

getDefaultValue

assertArgumentNotNull