de.unkrig.commons.util.collections

Class CollectionUtil

java.lang.Object

de.unkrig.commons.util.collections.CollectionUtil

public final class CollectionUtil
extends java.lang.Object

java.util.collection-related utility methods.

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.Iterator	AT_END Deprecated. Moved to IteratorUtil.AT_END
static java.util.SortedMap	EMPTY_SORTED_MAP Deprecated. Has moved to MapUtil.EMPTY_SORTED_MAP
static java.util.SortedSet	EMPTY_SORTED_SET Desperately missing from java.util.Collections.

Method Summary

Modifier and Type	Method and Description
static <K,V> java.util.SortedMap<K,V>	emptySortedMap() Deprecated. Has moved to MapUtil.emptySortedMap()
static <T> java.util.SortedSet<T>	emptySortedSet() Desperately missing from java.util.Collections.
static <K,V> java.util.Map.Entry<K,V>	entry(K key, V initialValue) Deprecated. Has moved to MapUtil.entry(Object, Object)
static <K,V> java.util.HashMap<K,V>	hashMapOf(int initialCapacity, java.util.Map.Entry<K,V>... entries) Deprecated. Has moved to MapUtil.hashMapOf(int, java.util.Map.Entry...)
static <K,V> java.util.HashMap<K,V>	hashMapOf(java.util.Map.Entry<K,V>... entries) Deprecated. Has moved to MapUtil.hashMapOf(java.util.Map.Entry...)
static <K,V> java.util.Map<K,V>	map(K[] keys, V[] values) Deprecated. Has moved to MapUtil.map(Object[], Object[])
static <K,V> java.util.Map<K,V>	map(java.lang.Object... keyValuePairs) Deprecated. Has moved to MapUtil.map(Object...)
static <K,V,M extends java.util.Map<K,V>> M	putAll(M subject, boolean allowDuplicateKeys, java.util.Map.Entry<K,V>... entries) Deprecated. Has moved to MapUtil.putAll(Map, boolean, java.util.Map.Entry...)
static <K,V,M extends java.util.Map<K,V>> M	putAll(M subject, java.util.Map.Entry<K,V>... entries) Deprecated. Has moved to MapUtil.putAll(Map, java.util.Map.Entry...)
static <T> T	removeFirstFrom(java.util.Collection<T> subject) Removes and returns the first element of the given collection.
static <T> java.util.Collection<T>	sorted(java.util.Collection<T> collection) Returns an unmodifiable collection containing the elements of the given collection, but sorted by their "natural ordering".
static <K,V> java.util.TreeMap<K,V>	treeMapOf(java.util.Map.Entry<K,V>... entries) Deprecated. Has moved to MapUtil.treeMapOf(java.util.Map.Entry...)

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_SORTED_MAP

@Deprecated
public static final java.util.SortedMap EMPTY_SORTED_MAP

Deprecated. Has moved to MapUtil.EMPTY_SORTED_MAP

EMPTY_SORTED_SET

public static final java.util.SortedSet EMPTY_SORTED_SET

Desperately missing from java.util.Collections.

AT_END

@Deprecated
public static final java.util.Iterator AT_END

Deprecated. Moved to IteratorUtil.AT_END

Method Detail

removeFirstFrom

@Nullable
public static <T> T removeFirstFrom(java.util.Collection<T> subject)

Removes and returns the first element of the given collection. This is also known as the 'shift' operation.

Returns:

null iff the collection is empty

map

@Deprecated
public static <K,V> java.util.Map<K,V> map(java.lang.Object... keyValuePairs)

Deprecated. Has moved to MapUtil.map(Object...)

map

@Deprecated
public static <K,V> java.util.Map<K,V> map(K[] keys,
                                                        V[] values)

Deprecated. Has moved to MapUtil.map(Object[], Object[])

hashMapOf

@Deprecated
public static <K,V> java.util.HashMap<K,V> hashMapOf(java.util.Map.Entry<K,V>... entries)

Deprecated. Has moved to MapUtil.hashMapOf(java.util.Map.Entry...)

hashMapOf

@Deprecated
public static <K,V> java.util.HashMap<K,V> hashMapOf(int initialCapacity,
                                                                  java.util.Map.Entry<K,V>... entries)

Deprecated. Has moved to MapUtil.hashMapOf(int, java.util.Map.Entry...)

treeMapOf

@Deprecated
public static <K,V> java.util.TreeMap<K,V> treeMapOf(java.util.Map.Entry<K,V>... entries)

Deprecated. Has moved to MapUtil.treeMapOf(java.util.Map.Entry...)

putAll

@Deprecated
public static <K,V,M extends java.util.Map<K,V>> M putAll(M subject,
                                                                       java.util.Map.Entry<K,V>... entries)

Deprecated. Has moved to MapUtil.putAll(Map, java.util.Map.Entry...)

putAll

@Deprecated
public static <K,V,M extends java.util.Map<K,V>> M putAll(M subject,
                                                                       boolean allowDuplicateKeys,
                                                                       java.util.Map.Entry<K,V>... entries)

Deprecated. Has moved to MapUtil.putAll(Map, boolean, java.util.Map.Entry...)

entry

@Deprecated
public static <K,V> java.util.Map.Entry<K,V> entry(K key,
                                                                V initialValue)

Deprecated. Has moved to MapUtil.entry(Object, Object)

emptySortedMap

@Deprecated
public static <K,V> java.util.SortedMap<K,V> emptySortedMap()

Deprecated. Has moved to MapUtil.emptySortedMap()

emptySortedSet

public static <T> java.util.SortedSet<T> emptySortedSet()

Desperately missing from java.util.Collections.

sorted

public static <T> java.util.Collection<T> sorted(java.util.Collection<T> collection)

Returns an unmodifiable collection containing the elements of the given collection, but sorted by their "natural ordering".