ObjectUtils (platform/sdk 5.5.1.0-SNAPSHOT API)

java.lang.Object
- com.attivio.util.ObjectUtils

```
public final class ObjectUtils
extends Object
```
Contains utility functions for working with the Object type

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 int`	`binarySearch(double[] array, double key, int startIndex, int endIndex, int missingOffset)` Fastest possible binary search.
`static int`	`binarySearch(float[] array, float key, int startIndex, int endIndex, int missingOffset)` Fastest possible binary search.
`static int`	`binarySearch(int[] array, int key, int startIndex, int endIndex, int missingOffset)` Fastest possible binary search.
`static int`	`binarySearch(long[] array, long key, int startIndex, int endIndex, int missingOffset)` Fastest possible binary search.
`static <T extends Comparable<T>> int`	`binarySearch(T[] array, T key, int startIndex, int endIndex, int missingOffset)` Fastest possible binary search.
`static Date`	`clone(Date value)` Null safe clone of a date.
`static int`	`compareTo(Comparable a, Comparable b)` Return the output of a.compareTo(b) Safe if a or b is null
`static <T> List<T>`	`copyOf(List<T> value)` Null safe copy of a list.
`static boolean`	`equals(double a, double b)` Returns true if a is equivalent to b.
`static boolean`	`equals(float a, float b)` Returns true if a is equivalent to b.
`static boolean`	`equals(List<? extends Throwable> a, List<? extends Throwable> b)` Compares if 2 lists of `Throwable`s are equivalent.
`static boolean`	`equals(Object a, Object b)` Returns true if a is equivalent to b.
`static boolean`	`equals(Throwable a, Throwable b)` Compares equality of 2 `Throwable`s.
`static <T extends Throwable> T`	`getCause(Throwable ex, Class<T> type)` Returns the exception of 'type' if anywhere in the exception's cause tree a class of 'type' is found, null otherwise
`static boolean`	`getDefault(Boolean value, boolean defaultValue)` Returns `defaultValue` if `value` is null, `value` otherwise.
`static double`	`getDefault(Double value, double defaultValue)` Returns `defaultValue` if `value` is null, `value` otherwise.
`static float`	`getDefault(Float value, float defaultValue)` Returns `defaultValue` if `value` is null, `value` otherwise.
`static int`	`getDefault(Integer value, int defaultValue)` Returns `defaultValue` if `value` is null, `value` otherwise.
`static long`	`getDefault(Long value, long defaultValue)` Returns `defaultValue` if `value` is null, `value` otherwise.
`static <T> T`	`getDefault(T value, T defaultValue)` Returns `defaultValue` if `value` is null, `value` otherwise.
`static int`	`hashCode(boolean value)` Compute the hash code of a primitive `boolean`.
`static int`	`hashCode(Class<?> clazz)` Compute the hash code of a Class by using the hashcode of `Class.getName()`.
`static int`	`hashCode(double value)` Compute the hash code of a primitive `double`.
`static int`	`hashCode(double[] data, int start, int count)` Compute the hash code of a segment of an int[].
`static int`	`hashCode(float value)` Compute the hash code of a primitive `float`.
`static int`	`hashCode(int[] data, int start, int count)` Compute the hash code of a segment of an int[].
`static int`	`hashCode(int hash, boolean value)` Add the hashCode for `value` to `hash`.
`static int`	`hashCode(int hash, double value)` Add the hashCode for `value` to `hash`.
`static int`	`hashCode(int hash, float value)` Add the hashCode for `value` to `hash`.
`static int`	`hashCode(int hash, int value)` Add the hashCode for `value` to `hash`.
`static int`	`hashCode(int hash, long value)` Add the hashCode for `value` to `hash`.
`static int`	`hashCode(int hash, Object value)` Add the hashCode for `value` to `hash`.
`static int`	`hashCode(List<?> list)` Compute the hash code of a list of objects, using our internal routines when possible.
`static int`	`hashCode(long value)` Compute the hash code of a primitive `long`.
`static int`	`hashCode(Object value)` Returns the value's hash code or 0 if null.
`static String`	`intern(String value)` Intern and return `value` (handles nulls).
`static boolean`	`isFalse(String value)` Returns true if the string `value` is a boolean value indicating `false`.
`static boolean`	`isTrue(String value)` Returns true if the string `value` is a boolean value indicating `true`.
`static <T> List<T>`	`newList(T... vals)` Creates a new `List` implementation based on ordered input values.
`static <K,V> Map<K,V>`	`newMap(K key, V val, Object... args)` Creates a new `LinkedHashMap` implementation based on key value pairs specified as paired arguments.
`static Boolean`	`parseBoolean(Object value)` Convert `value` to a Boolean (or null if not parseable).
`static Boolean`	`parseBoolean(String value)` Parse a boolean value (more lenient than Boolean.valueOf()).
`static BigDecimal`	`parseDecimal(Object value)` Parse an arbitrary object as a `BigDecimal`.
`static double`	`parseDouble(Object value)` Parse an arbitrary object as a double.
`static float`	`parseFloat(Object value)` Parse an arbitrary object as a float.
`static int`	`parseInt(Object value)` Parse an arbitrary object as an integer.
`static long`	`parseLong(Object value)` Parse an arbitrary object as a long.
`static int`	`parseUnsigned(Object value)` Parses an arbitrary object into an unsigned integer.
`static void`	`prettyPrint(int[][] matrix)` Pretty prints a 2-D int array
`static <T> void`	`prettyPrint(T[][] matrix)` Pretty prints a 2-D object array
`static <T> int`	`size(List<List<T>> matrix)` Returns the total number of cells in a matrix
`static <T> int`	`size(T[][] matrix)` Returns the total number of cells in a matrix
`static <T> T[]`	`toArray(T... args)` Autobox-like creating of array.
`static boolean`	`toBooleanValue(Object value, boolean defaultValue)` Converts an arbitrary object to a primitive boolean.
`static double`	`toDoubleValue(Object value, double defaultValue)` Converts an arbitrary object to a primitive double.
`static float`	`toFloatValue(Object value, float defaultValue)` Converts an arbitrary object to a primitive float.
`static int`	`toIntValue(Object value, int defaultValue)` Converts an arbitrary object to a primitive integer.
`static long`	`toLongValue(Object value, long defaultValue)` Converts an arbitrary object to a primitive long.
`static <T extends Comparable<? super T>> List<T>`	`toSortedList(Collection<T> collec)` Converts an arbitrary collection into a sorted list.
`static String`	`toStringValue(Object value, String defaultValue)` Converts an arbitrary object to a String.
`static int`	`toUnsignedValue(Object value, int defaultValue)` Converts an arbitrary object to a primitive unsigned integer.

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
  - getDefault
```
public static <T> T getDefault(T value,
                               T defaultValue)
```
    Returns defaultValue if value is null, value otherwise.
  - intern
```
public static String intern(String value)
```
    Intern and return value (handles nulls).
  - getDefault
```
public static boolean getDefault(Boolean value,
                                 boolean defaultValue)
```
    Returns defaultValue if value is null, value otherwise.
  - getDefault
```
public static int getDefault(Integer value,
                             int defaultValue)
```
    Returns defaultValue if value is null, value otherwise.
  - getDefault
```
public static long getDefault(Long value,
                              long defaultValue)
```
    Returns defaultValue if value is null, value otherwise.
  - getDefault
```
public static float getDefault(Float value,
                               float defaultValue)
```
    Returns defaultValue if value is null, value otherwise.
  - getDefault
```
public static double getDefault(Double value,
                                double defaultValue)
```
    Returns defaultValue if value is null, value otherwise.
  - toArray
```
public static <T> T[] toArray(T... args)
```
    Autobox-like creating of array.
  - binarySearch
```
public static int binarySearch(int[] array,
                               int key,
                               int startIndex,
                               int endIndex,
                               int missingOffset)
```
    Fastest possible binary search.
    WARNING: no bounds checking is performed.
    
    Parameters:
    
    array - the array to search.
    
    key - the key to search for.
    
    startIndex - the start index to start looking at (inclusive).
    
    endIndex - the end index to stop looking at (inclusive).
    
    Returns:
    
    the index where key (or the greatest value less than key) is located.
  - binarySearch
```
public static int binarySearch(long[] array,
                               long key,
                               int startIndex,
                               int endIndex,
                               int missingOffset)
```
    Fastest possible binary search.
    WARNING: no bounds checking is performed.
    
    Parameters:
    
    array - the array to search.
    
    key - the key to search for.
    
    startIndex - the start index to start looking at (inclusive).
    
    endIndex - the end index to stop looking at (inclusive).
    
    Returns:
    
    the index where key (or the greatest value less than key) is located.
  - binarySearch
```
public static int binarySearch(float[] array,
                               float key,
                               int startIndex,
                               int endIndex,
                               int missingOffset)
```
    Fastest possible binary search.
    WARNING: no bounds checking is performed.
    
    Parameters:
    
    array - the array to search.
    
    key - the key to search for.
    
    startIndex - the start index to start looking at (inclusive).
    
    endIndex - the end index to stop looking at (inclusive).
    
    Returns:
    
    the index where key (or the greatest value less than key) is located.
  - binarySearch
```
public static int binarySearch(double[] array,
                               double key,
                               int startIndex,
                               int endIndex,
                               int missingOffset)
```
    Fastest possible binary search.
    WARNING: no bounds checking is performed.
    
    Parameters:
    
    array - the array to search.
    
    key - the key to search for.
    
    startIndex - the start index to start looking at (inclusive).
    
    endIndex - the end index to stop looking at (inclusive).
    
    Returns:
    
    the index where key (or the greatest value less than key) is located.
  - clone
```
public static Date clone(Date value)
```
    Null safe clone of a date.
  - copyOf
```
public static <T> List<T> copyOf(List<T> value)
```
    Null safe copy of a list.
    NOTE: this is a shallow clone.
  - binarySearch
```
public static <T extends Comparable<T>> int binarySearch(T[] array,
                                                         T key,
                                                         int startIndex,
                                                         int endIndex,
                                                         int missingOffset)
```
    Fastest possible binary search.
    WARNING: no bounds checking is performed.
    
    Parameters:
    
    array - the array to search.
    
    key - the key to search for.
    
    startIndex - the start index to start looking at (inclusive).
    
    endIndex - the end index to stop looking at (inclusive).
    
    Returns:
    
    the index where key (or the greatest value less than key) is located.
  - size
```
public static <T> int size(T[][] matrix)
```
    Returns the total number of cells in a matrix
    
    Parameters:
    
    matrix - the matrix
    
    Returns:
    
    the total number of cells
  - size
```
public static <T> int size(List<List<T>> matrix)
```
    Returns the total number of cells in a matrix
    
    Parameters:
    
    matrix - the matrix
    
    Returns:
    
    the total number of cells
  - equals
```
public static boolean equals(Object a,
                             Object b)
```
    Returns true if a is equivalent to b.
    
    Parameters:
    
    a - left hand side
    
    b - right hand side
    
    Returns:
    
    true if a is equivalent to b
  - equals
```
public static boolean equals(float a,
                             float b)
```
    Returns true if a is equivalent to b.
    
    Parameters:
    
    a - left hand side
    
    b - right hand side
    
    Returns:
    
    true if a is equivalent to b
  - equals
```
public static boolean equals(double a,
                             double b)
```
    Returns true if a is equivalent to b.
    
    Parameters:
    
    a - left hand side
    
    b - right hand side
    
    Returns:
    
    true if a is equivalent to b
  - equals
```
public static boolean equals(List<? extends Throwable> a,
                             List<? extends Throwable> b)
```
    Compares if 2 lists of Throwables are equivalent.
    Uses equals(Throwable, Throwable) for comparing elements.
  - equals
```
public static boolean equals(Throwable a,
                             Throwable b)
```
    Compares equality of 2 Throwables.
    Equality check will validate a and b are of the same type and have same message.
  - compareTo
```
public static int compareTo(Comparable a,
                            Comparable b)
```
    Return the output of a.compareTo(b) Safe if a or b is null
    
    Parameters:
    
    a - left hand side
    
    b - right hand side
    
    Returns:
    
    true if a is equivalent to b
  - toSortedList
```
public static <T extends Comparable<? super T>> List<T> toSortedList(Collection<T> collec)
```
    Converts an arbitrary collection into a sorted list.
    
    Parameters:
    
    collec - the collection to convert
    
    Returns:
    
    the sorted list
  - toStringValue
```
public static String toStringValue(Object value,
                                   String defaultValue)
```
    Converts an arbitrary object to a String.
    
    Parameters:
    
    value - the value to convert
    
    defaultValue - if value is null
    
    Returns:
    
    the value as a String, or defaultValue if conversion fails.
  - parseInt
```
public static int parseInt(Object value)
```
    Parse an arbitrary object as an integer.
  - parseLong
```
public static long parseLong(Object value)
```
    Parse an arbitrary object as a long.
  - parseFloat
```
public static float parseFloat(Object value)
```
    Parse an arbitrary object as a float.
  - parseDouble
```
public static double parseDouble(Object value)
```
    Parse an arbitrary object as a double.
  - parseDecimal
```
public static BigDecimal parseDecimal(Object value)
```
    Parse an arbitrary object as a BigDecimal.
  - toIntValue
```
public static int toIntValue(Object value,
                             int defaultValue)
```
    Converts an arbitrary object to a primitive integer.
    
    Parameters:
    
    value - the value to convert
    
    defaultValue - if value cannot be converted, this will be returned
    
    Returns:
    
    the value as a int, or defaultValue if conversion fails.
  - toUnsignedValue
```
public static int toUnsignedValue(Object value,
                                  int defaultValue)
```
    Converts an arbitrary object to a primitive unsigned integer.
    
    Parameters:
    
    value - the value to convert
    
    defaultValue - if value cannot be parsed, this will be returned
    
    Returns:
    
    the value as a int, or defaultValue if conversion fails.
  - parseUnsigned
```
public static int parseUnsigned(Object value)
                         throws NumberFormatException,
                                IllegalArgumentException
```
    Parses an arbitrary object into an unsigned integer.
    
    Parameters:
    
    value - the value to convert
    
    Returns:
    
    the value as an int
    
    Throws:
    
    NumberFormatException - if object cannot be converted to int
    
    IllegalArgumentException - if integer value is negative
  - toLongValue
```
public static long toLongValue(Object value,
                               long defaultValue)
```
    Converts an arbitrary object to a primitive long.
    
    Parameters:
    
    value - the value to convert
    
    defaultValue - if value cannot be converted, this will be returned
    
    Returns:
    
    the value as a long, or defaultValue if conversion fails.
  - toFloatValue
```
public static float toFloatValue(Object value,
                                 float defaultValue)
```
    Converts an arbitrary object to a primitive float.
    
    Parameters:
    
    value - the value to convert
    
    defaultValue - if value cannot be converted, this will be returned
    
    Returns:
    
    the value as a float, or defaultValue if conversion fails.
  - toDoubleValue
```
public static double toDoubleValue(Object value,
                                   double defaultValue)
```
    Converts an arbitrary object to a primitive double.
    
    Parameters:
    
    value - the value to convert
    
    defaultValue - if value cannot be converted, this will be returned
    
    Returns:
    
    the value as a double, or defaultValue if conversion fails.
  - toBooleanValue
```
public static boolean toBooleanValue(Object value,
                                     boolean defaultValue)
```
    Converts an arbitrary object to a primitive boolean. If value is a Boolean instance, return its value. If value is a Number instance, return true if it is non-zero. true will be returned if the value's lower cased string representation is true, yes, or on. false will be returned if values' lower cased string representation is false, no, or off. non-zero numbers will be return true, 0 returns false. Otherwise, the defaultValue will be returned.
    
    Parameters:
    
    value - the value to convert
    
    defaultValue - if value cannot be converted, this will be returned
    
    Returns:
    
    the value as a boolean, or defaultValue if conversion fails.
  - isTrue
```
public static boolean isTrue(String value)
```
    Returns true if the string value is a boolean value indicating true.
  - isFalse
```
public static boolean isFalse(String value)
```
    Returns true if the string value is a boolean value indicating false.
  - parseBoolean
```
public static Boolean parseBoolean(String value)
```
    Parse a boolean value (more lenient than Boolean.valueOf()).
    true will be returned if the value's lower cased string representation is true, yes, or on. false will be returned if values' lower cased string representation is false, no, or off. non-zero numbers will be return true, 0 returns false.
    
    Parameters:
    
    value -
    
    Returns:
    
    the value or null if not parseable as a boolean
  - parseBoolean
```
public static Boolean parseBoolean(Object value)
```
    Convert value to a Boolean (or null if not parseable).
  - prettyPrint
```
public static void prettyPrint(int[][] matrix)
```
    Pretty prints a 2-D int array
  - prettyPrint
```
public static <T> void prettyPrint(T[][] matrix)
```
    Pretty prints a 2-D object array
  - getCause
```
public static <T extends Throwable> T getCause(Throwable ex,
                                               Class<T> type)
```
    Returns the exception of 'type' if anywhere in the exception's cause tree a class of 'type' is found, null otherwise
  - newMap
```
public static <K,V> Map<K,V> newMap(K key,
                                    V val,
                                    Object... args)
                             throws IllegalArgumentException
```
    Creates a new LinkedHashMap implementation based on key value pairs specified as paired arguments. The first key/value are used for compiler time type safety and are put into the map. All of the other arguments are NOT validated for type safety.
    
    Throws:
    
    IllegalArgumentException - if an odd number of arguments are specified
  - newList
```
@SafeVarargs
public static <T> List<T> newList(T... vals)
```
    Creates a new List implementation based on ordered input values. Same as Arrays.asList() but provides type safety
    
    Type Parameters:
    
    T - the type of generic list to create
    
    Parameters:
    
    vals - the values to add to the list
  - hashCode
```
public static int hashCode(boolean value)
```
    Compute the hash code of a primitive boolean.
  - hashCode
```
public static int hashCode(float value)
```
    Compute the hash code of a primitive float.
  - hashCode
```
public static int hashCode(double value)
```
    Compute the hash code of a primitive double.
  - hashCode
```
public static int hashCode(long value)
```
    Compute the hash code of a primitive long.
  - hashCode
```
public static int hashCode(Class<?> clazz)
```
    Compute the hash code of a Class by using the hashcode of Class.getName(). Null safe.
  - hashCode
```
public static int hashCode(List<?> list)
```
    Compute the hash code of a list of objects, using our internal routines when possible.
  - hashCode
```
public static int hashCode(int[] data,
                           int start,
                           int count)
```
    Compute the hash code of a segment of an int[].
  - hashCode
```
public static int hashCode(double[] data,
                           int start,
                           int count)
```
    Compute the hash code of a segment of an int[].
  - hashCode
```
public static int hashCode(int hash,
                           boolean value)
```
    Add the hashCode for value to hash.
  - hashCode
```
public static int hashCode(int hash,
                           float value)
```
    Add the hashCode for value to hash.
  - hashCode
```
public static int hashCode(int hash,
                           double value)
```
    Add the hashCode for value to hash.
  - hashCode
```
public static int hashCode(int hash,
                           long value)
```
    Add the hashCode for value to hash.
  - hashCode
```
public static int hashCode(int hash,
                           Object value)
```
    Add the hashCode for value to hash.
  - hashCode
```
public static int hashCode(Object value)
```
    Returns the value's hash code or 0 if null.
  - hashCode
```
public static int hashCode(int hash,
                           int value)
```
    Add the hashCode for value to hash.

Class ObjectUtils

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ObjectUtils

Method Detail

getDefault

intern

getDefault

getDefault

getDefault

getDefault

getDefault

toArray

binarySearch

binarySearch

binarySearch

binarySearch

clone

copyOf

binarySearch

size

size

equals

equals

equals

equals

equals

compareTo

toSortedList

toStringValue

parseInt

parseLong

parseFloat

parseDouble

parseDecimal

toIntValue

toUnsignedValue

parseUnsigned

toLongValue

toFloatValue

toDoubleValue

toBooleanValue

isTrue

isFalse

parseBoolean

parseBoolean

prettyPrint

prettyPrint

getCause

newMap

newList

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode