org.springframework.data.gemfire.util

Class CollectionUtils

java.lang.Object

org.springframework.util.CollectionUtils

org.springframework.data.gemfire.util.CollectionUtils

public abstract class CollectionUtils
extends CollectionUtils

The CollectionUtils class is a utility class for working with Java Collections Framework and classes.

Since:

1.7.0

Author:

John Blum

See Also:

Collection, Collections, Enumeration, Iterator, List, Map, Set, CollectionUtils

Constructor Summary

Constructors

Constructor and Description
CollectionUtils()

Method Summary

Modifier and Type	Method and Description
static <E,T extends Collection<E>> T	addAll(T collection, Iterable<E> iterable) Adds all elements from the given Iterable to the Collection.
static <T> Set<T>	asSet(T... elements) Returns an unmodifiable Set containing the elements from the given object array.
static boolean	containsAny(Collection<?> collection, Object... elements) Null-safe method to determines whether the given Collection contains any elements from the given array.
static <E,T extends Iterable<E>> T	defaultIfEmpty(T iterable, T defaultIterable) Returns the given Iterable if not null or empty, otherwise returns the defaultIterable.
static <T> Iterable<T>	emptyIterable() Returns an empty Iterable object.
static <T> Iterable<T>	iterable(Enumeration<T> enumeration) Adapts the given Enumeration as an Iterable object for use within a for each loop.
static <T> Iterable<T>	iterable(Iterator<T> iterator) Adapts the given Iterator as an Iterable object for use within a for each loop.
static <T> Collection<T>	nullSafeCollection(Collection<T> collection) Null-safe operation returning the given Collection if not null or an empty Collection (implemented with List) if null.
static <T> Iterable<T>	nullSafeIterable(Iterable<T> iterable) A null-safe operation returning the original Iterable object if non-null or a default, empty Iterable implementation if null.
static <T> List<T>	nullSafeList(List<T> list) Null-safe operation returning the given List if not null or an empty List if null.
static <K,V> Map<K,V>	nullSafeMap(Map<K,V> map) Null-safe operation returning the given Map if not null or an empty Map if null.
static <T> Set<T>	nullSafeSet(Set<T> set) Null-safe operation returning the given Set if not null or an empty Set if null.
static <T extends Comparable<T>> List<T>	sort(List<T> list) Sors the elements of the given List by their natural, Comparable ordering.
static <T> List<T>	subList(List<T> source, int... indices) Returns a sub-list of elements from the given List based on the provided indices.

Methods inherited from class org.springframework.util.CollectionUtils

arrayToList, contains, contains, containsAny, containsInstance, findCommonElementType, findFirstMatch, findValueOfType, findValueOfType, hasUniqueObject, isEmpty, isEmpty, mergeArrayIntoCollection, mergePropertiesIntoMap, toArray, toIterator, toMultiValueMap, unmodifiableMultiValueMap

Methods inherited from class java.lang.Object

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

Constructor Detail

CollectionUtils

public CollectionUtils()

Method Detail

addAll

public static <E,T extends Collection<E>> T addAll(T collection,
                                                   Iterable<E> iterable)

Adds all elements from the given Iterable to the Collection.

Type Parameters:

E - Class type of the elements in the Collection and Iterable.

T - concrete Class type of the Collection.

Parameters:

collection - Collection in which to add the elements from the Iterable.

iterable - Iterable containing the elements to add to the Collection.

Returns:

the given Collection.

Throws:

IllegalArgumentException - if Collection is null.

See Also:

Iterable, Collection

asSet

public static <T> Set<T> asSet(T... elements)

Returns an unmodifiable Set containing the elements from the given object array.

Type Parameters:

T - Class type of the elements.

Parameters:

elements - array of objects to add to the Set.

Returns:

an unmodifiable Set containing the elements from the given object array.

containsAny

public static boolean containsAny(Collection<?> collection,
                                  Object... elements)

Null-safe method to determines whether the given Collection contains any elements from the given array.

Parameters:

collection - Collection to evaluate

elements - array of elements to evaluate.

Returns:

a boolean value indicating whether the collection contains at least 1 element from the given array.

See Also:

Collection.contains(Object)

defaultIfEmpty

public static <E,T extends Iterable<E>> T defaultIfEmpty(T iterable,
                                                         T defaultIterable)

Returns the given Iterable if not null or empty, otherwise returns the defaultIterable.

Type Parameters:

T - concrete Class type of the Iterable.

E - Class type of the elements in the Iterables.

Parameters:

iterable - Iterable to evaluate.

defaultIterable - Iterable to return if the given iterable is null or empty.

Returns:

iterable if not null or empty otherwise return defaultIterable.

See Also:

Iterable

emptyIterable

public static <T> Iterable<T> emptyIterable()

Returns an empty Iterable object.

Type Parameters:

T - Class type of the elements in the Iterable.

Returns:

an empty Iterable.

See Also:

Iterable, nullSafeIterable(Iterable)

iterable

public static <T> Iterable<T> iterable(Enumeration<T> enumeration)

Adapts the given Enumeration as an Iterable object for use within a for each loop.

Type Parameters:

T - the class type of the Enumeration elements.

Parameters:

enumeration - the Enumeration to adapt as an Iterable object.

Returns:

an Iterable instance of the Enumeration.

See Also:

Iterable, Enumeration

iterable

public static <T> Iterable<T> iterable(Iterator<T> iterator)

Adapts the given Iterator as an Iterable object for use within a for each loop.

Type Parameters:

T - the class type of the Iterator elements.

Parameters:

iterator - the Iterator to adapt as an Iterable object.

Returns:

an Iterable instance of the Iterator.

See Also:

Iterable, Iterator

nullSafeCollection

public static <T> Collection<T> nullSafeCollection(Collection<T> collection)

Null-safe operation returning the given Collection if not null or an empty Collection (implemented with List) if null.

Type Parameters:

T - Class type of the Collection elements.

Parameters:

collection - Collection to evaluate.

Returns:

the given Collection if not null or return an empty Collection (implemented with List).

See Also:

Collections.emptyList(), Collection

nullSafeIterable

public static <T> Iterable<T> nullSafeIterable(Iterable<T> iterable)

A null-safe operation returning the original Iterable object if non-null or a default, empty Iterable implementation if null.

Type Parameters:

T - the class type of the iterable elements.

Parameters:

iterable - the Iterable object evaluated for a null reference.

Returns:

the Iterable object if not null or a default, empty Iterable implementation otherwise.

See Also:

Iterable, Iterator

nullSafeList

public static <T> List<T> nullSafeList(List<T> list)

Null-safe operation returning the given List if not null or an empty List if null.

Type Parameters:

T - Class type of the List elements.

Parameters:

list - List to evaluate.

Returns:

the given List if not null or an empty List.

See Also:

Collections.emptyList(), List

nullSafeMap

public static <K,V> Map<K,V> nullSafeMap(Map<K,V> map)

Null-safe operation returning the given Map if not null or an empty Map if null.

Type Parameters:

K - Class type of the Map's keys.

V - Class type of the Map's values.

Parameters:

map - Map to evaluate.

Returns:

the given Map if not null or an empty Map.

See Also:

Collections.emptyMap(), Map

nullSafeSet

public static <T> Set<T> nullSafeSet(Set<T> set)

Null-safe operation returning the given Set if not null or an empty Set if null.

Type Parameters:

T - Class type of the Set elements.

Parameters:

set - Set to evaluate.

Returns:

the given Set if not null or an empty Set.

See Also:

Collections.emptySet(), Set

sort

public static <T extends Comparable<T>> List<T> sort(List<T> list)

Sors the elements of the given List by their natural, Comparable ordering.

Type Parameters:

T - Comparable class type of the collection elements.

Parameters:

list - List of elements to sort.

Returns:

the List sorted.

See Also:

Collections.sort(List), List

subList

public static <T> List<T> subList(List<T> source,
                                  int... indices)

Returns a sub-list of elements from the given List based on the provided indices.

Type Parameters:

T - Class type of the elements in the list.

Parameters:

source - List from which the elements of the sub-list is constructed.

indices - array of indexes in the source List to the elements used to construct the sub-list.

Returns:

a sub-list of elements from the given List based on the provided indices.

Throws:

IndexOutOfBoundsException - if the array of indexes contains an index that is not within the bounds of the list.

NullPointerException - if either the list or indexes are null.

See Also:

List