Module org.elasticsearch.server

Package org.elasticsearch.common.util

Class CollectionUtils

java.lang.Object

org.elasticsearch.common.util.CollectionUtils

public class CollectionUtils
extends Object

Collections-related utility methods.

Constructor Summary

Constructors

Constructor	Description
CollectionUtils()

Method Summary

Modifier and Type	Method	Description
static <E> List<E>	appendToCopy(Collection<E> collection, E element)	Creates a copy of the given collection with the given element appended.
static <E> List<E>	appendToCopyNoNullElements(Collection<E> collection, E element)	Same as appendToCopy(Collection, Object) but faster by assuming that all elements in the collection and the given element are non-null.
static <E> List<E>	appendToCopyNoNullElements(Collection<E> collection, E... elements)	Same as appendToCopyNoNullElements(Collection, Object) but for multiple elements to append.
static <E> ArrayList<E>	arrayAsArrayList(E... elements)
static <E> List<E>	concatLists(List<E> listA, Collection<E> listB)
static <E> List<List<E>>	eagerPartition(List<E> list, int size)
static void	ensureNoSelfReferences(Object value, String messageHint)	Deeply inspects a Map, Iterable, or Object array looking for references back to itself.
static boolean	isEmpty(Object[] array)	Checks if the given array contains any elements.
static <E> ArrayList<E>	iterableAsArrayList(Iterable<? extends E> elements)
static <E> List<E>	limitSize(List<E> list, int size)
static <E> ArrayList<E>	newSingletonArrayList(E element)
static <T> List<T>	rotate(List<T> list, int distance)	Return a rotated view of the given list with the given distance.
static int[]	toArray(Collection<Integer> ints)
static <T> void	uniquify(List<T> list, Comparator<T> cmp)	Eliminate duplicates from a sorted list in-place.
static <E> List<E>	wrapUnmodifiableOrEmptySingleton(List<E> list)

Methods inherited from class java.lang.Object

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

Constructor Details

CollectionUtils

public CollectionUtils()

Method Details

isEmpty

public static boolean isEmpty(Object[] array)

Checks if the given array contains any elements.

Parameters:

array - The array to check

Returns:

false if the array contains an element, true if not or the array is null.

uniquify

public static <T> void uniquify(List<T> list,
 Comparator<T> cmp)

Eliminate duplicates from a sorted list in-place.

Parameters:

list - A sorted list, which will be modified in place.

cmp - A comparator the list is already sorted by.

rotate

public static <T> List<T> rotate(List<T> list,
 int distance)

Return a rotated view of the given list with the given distance.

toArray

public static int[] toArray(Collection<Integer> ints)

ensureNoSelfReferences

public static void ensureNoSelfReferences(Object value,
 String messageHint)

Deeply inspects a Map, Iterable, or Object array looking for references back to itself.

Parameters:

value - The object to evaluate looking for self references

messageHint - A string to be included in the exception message if the call fails, to provide more context to the handler of the exception

Throws:

IllegalArgumentException - if a self-reference is found

iterableAsArrayList

public static <E> ArrayList<E> iterableAsArrayList(Iterable<? extends E> elements)

arrayAsArrayList

@SafeVarargs
public static <E> ArrayList<E> arrayAsArrayList(E... elements)

appendToCopy

public static <E> List<E> appendToCopy(Collection<E> collection,
 E element)

Creates a copy of the given collection with the given element appended.

Parameters:

collection - collection to copy

element - element to append

appendToCopyNoNullElements

public static <E> List<E> appendToCopyNoNullElements(Collection<E> collection,
 E element)

Same as appendToCopy(Collection, Object) but faster by assuming that all elements in the collection and the given element are non-null.

Parameters:

collection - collection to copy

element - element to append

Returns:

list with appended element

appendToCopyNoNullElements

public static <E> List<E> appendToCopyNoNullElements(Collection<E> collection,
 E... elements)

Same as appendToCopyNoNullElements(Collection, Object) but for multiple elements to append.

newSingletonArrayList

public static <E> ArrayList<E> newSingletonArrayList(E element)

eagerPartition

public static <E> List<List<E>> eagerPartition(List<E> list,
 int size)

concatLists

public static <E> List<E> concatLists(List<E> listA,
 Collection<E> listB)

wrapUnmodifiableOrEmptySingleton

public static <E> List<E> wrapUnmodifiableOrEmptySingleton(List<E> list)

limitSize

public static <E> List<E> limitSize(List<E> list,
 int size)