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 <T> Set<T>	asSet(T... elements) Returns an unmodifiable Set containing the elements from the given object array.
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) A null-safe operation returning the original Collection if non-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

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.

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)

A null-safe operation returning the original Collection if non-null or an empty Collection (implemented with List) if null.

Type Parameters:

T - the element class type of the Collection.

Parameters:

collection - the Collection to evaluate for being null.

Returns:

the given Collection if not null, otherwise return an empty Collection (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