Package com.gigaspaces.internal.utils

Class ObjectUtils

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	Description
ObjectUtils()

Method Summary

Modifier and Type	Method	Description
static <T> T	assertArgumentNotNull(T argument, String argumentName)	Throws an IllegalArgumentException if the provided argument is null.
static <T> T	defaultIfNull(T object, T defaultValue)	Returns default object if the requested one is null
static <T> T	defaultIfNullDeferred(T object, java.util.function.Supplier<T> defaultValueSupplier)
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 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 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(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.

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

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()

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

defaultIfNull

public static <T> T defaultIfNull(T object,
 T defaultValue)

Returns default object if the requested one is null

defaultIfNullDeferred

public static <T> T defaultIfNullDeferred(T object,
 java.util.function.Supplier<T> defaultValueSupplier)

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