org.springframework.data.gemfire.util

Class ArrayUtils

java.lang.Object

org.springframework.data.gemfire.util.ArrayUtils

public abstract class ArrayUtils
extends Object

The ArrayUtils class is a utility class for working with Object arrays.

Author:

David Turanski, John Blum

See Also:

Array, Arrays

Constructor Summary

Constructors

Constructor and Description
ArrayUtils()

Method Summary

Modifier and Type	Method and Description
static <T> T[]	asArray(T... elements) Returns the given varargs element as an array.
static <T> T[]	defaultIfEmpty(T[] array, T[] defaultArray) Returns the given array if not null or empty, otherwise returns the defaultArray.
static <T> T	getFirst(T[] array) Null-safe method to return the first element in the array or null if the array is null or empty.
static <T> T	getFirst(T[] array, T defaultValue) Null-safe method to return the first element in the array or the defaultValue if the array is null or empty.
static Object[]	insert(Object[] originalArray, int position, Object element) Insert an element into the given array at position (index).
static boolean	isEmpty(Object[] array) Determines whether the given array is empty or not.
static boolean	isNotEmpty(Object[] array) Determines whether the given array is empty or not.
static int	length(Object[] array) Null-safe operation to determine an array's length.
static <T> T[]	nullSafeArray(T[] array, Class<T> componentType) Null-safe, empty array operation returning the given object array if not null or an empty object array if the array argument is null.
static Object[]	remove(Object[] originalArray, int position) Remove an element from the given array at position (index).
static <T extends Comparable<T>> T[]	sort(T[] array) Sort the array of elements according to the elements natural ordering.

Methods inherited from class java.lang.Object

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

Constructor Detail

ArrayUtils

public ArrayUtils()

Method Detail

asArray

@SafeVarargs
public static <T> T[] asArray(T... elements)

Returns the given varargs element as an array.

Type Parameters:

T - Class type of the elements.

Parameters:

elements - variable list of arguments to return as an array.

Returns:

an arry for the given varargs elements.

defaultIfEmpty

public static <T> T[] defaultIfEmpty(T[] array,
                                     T[] defaultArray)

Returns the given array if not null or empty, otherwise returns the defaultArray.

Type Parameters:

T - Class type of the array elements.

Parameters:

array - array to evaluate.

defaultArray - array to return if the given array is null or empty.

Returns:

the given array if not null or empty otherwise return the defaultArray.

getFirst

public static <T> T getFirst(T[] array)

Null-safe method to return the first element in the array or null if the array is null or empty.

Type Parameters:

T - Class type of the array elements.

Parameters:

array - the array from which to extract the first element.

Returns:

the first element in the array or null if the array is null or empty.

See Also:

getFirst(Object[], Object)

getFirst

public static <T> T getFirst(T[] array,
                             T defaultValue)

Null-safe method to return the first element in the array or the defaultValue if the array is null or empty.

Type Parameters:

T - Class type of the array elements.

Parameters:

array - the array from which to extract the first element.

defaultValue - value to return if the array is null or empty.

Returns:

the first element in the array or defaultValue if the array is null or empty.

See Also:

getFirst(Object[], Object)

insert

public static Object[] insert(Object[] originalArray,
                              int position,
                              Object element)

Insert an element into the given array at position (index). The element is inserted at the given position and all elements afterwards are moved to the right.

Parameters:

originalArray - the array in which to insert the element.

position - an integer index (position) at which to insert the element in the array.

element - the element to insert into the array.

Returns:

a new array with the element inserted at position.

See Also:

System.arraycopy(Object, int, Object, int, int), Array.newInstance(Class, int)

isEmpty

public static boolean isEmpty(Object[] array)

Determines whether the given array is empty or not.

Parameters:

array - the array to evaluate for emptiness.

Returns:

a boolean value indicating whether the given array is empty.

See Also:

length(Object...)

isNotEmpty

public static boolean isNotEmpty(Object[] array)

Determines whether the given array is empty or not.

Parameters:

array - the array to evaluate for emptiness.

Returns:

a boolean value indicating whether the given array is empty.

See Also:

isEmpty(Object[])

length

public static int length(Object[] array)

Null-safe operation to determine an array's length.

Parameters:

array - the array to determine it's length.

Returns:

the length of the given array or 0 if the array reference is null.

nullSafeArray

public static <T> T[] nullSafeArray(T[] array,
                                    Class<T> componentType)

Null-safe, empty array operation returning the given object array if not null or an empty object array if the array argument is null.

Type Parameters:

T - Class type of the array elements.

Parameters:

array - array of objects on which a null check is performed.

componentType - Class type of the array elements.

Returns:

the given object array if not null, otherwise return an empty object array.

See Also:

Array.newInstance(Class, int)

remove

public static Object[] remove(Object[] originalArray,
                              int position)

Remove an element from the given array at position (index). The element is removed at the specified position and all remaining elements are shifted to the left.

Parameters:

originalArray - the array from which to remove the element.

position - the integer index (position) indicating the element to remove from the array.

Returns:

a new array with the element at position in the originalArray removed.

See Also:

System.arraycopy(Object, int, Object, int, int), Array.newInstance(Class, int)

sort

public static <T extends Comparable<T>> T[] sort(T[] array)

Sort the array of elements according to the elements natural ordering.

Type Parameters:

T - Comparable class type of the array elements.

Parameters:

array - array of elements to sort.

Returns:

the sorted array of elements.

See Also:

Arrays.sort(Object[])