org.tinygroup.commons.tools

Class CollectionUtil

java.lang.Object

org.tinygroup.commons.tools.CollectionUtil

public final class CollectionUtil
extends Object

方便创建容器对象的工具。

Author:

renhui

Constructor Summary

Constructors

Constructor and Description
CollectionUtil()

Method Summary

Modifier and Type	Method and Description
static <T> List<T>	asList(T... args) 创建一个List。
static String	convertToString(Collection collection, String separator) 转换Collection所有元素(通过toString())为String, 中间以 separator分隔。
static String	convertToString(Collection collection, String prefix, String postfix) 转换Collection所有元素(通过toString())为String, 每个元素的前面加入prefix，后面加入postfix，如mymessage。
static <T> ArrayList<T>	createArrayList() 创建一个ArrayList。
static <T> ArrayList<T>	createArrayList(int initialCapacity) 创建一个ArrayList。
static <T> ArrayList<T>	createArrayList(Iterable<? extends T> c) 创建一个ArrayList。
static <T,V extends T> ArrayList<T>	createArrayList(V... args) 创建一个ArrayList。
static <K,V> ConcurrentHashMap<K,V>	createConcurrentHashMap() 创建一个ConcurrentHashMap。
static <K,V> HashMap<K,V>	createHashMap() 创建一个HashMap。
static <K,V> HashMap<K,V>	createHashMap(int initialCapacity) 创建一个HashMap。
static <T> HashSet<T>	createHashSet() 创建一个HashSet。
static <T> HashSet<T>	createHashSet(Iterable<? extends T> c) 创建一个HashSet。
static <T,V extends T> HashSet<T>	createHashSet(V... args) 创建一个HashSet。
static <K,V> LinkedHashMap<K,V>	createLinkedHashMap() 创建一个LinkedHashMap。
static <K,V> LinkedHashMap<K,V>	createLinkedHashMap(int initialCapacity) 创建一个LinkedHashMap。
static <T> LinkedHashSet<T>	createLinkedHashSet() 创建一个LinkedHashSet。
static <T> LinkedHashSet<T>	createLinkedHashSet(Iterable<? extends T> c) 创建一个LinkedHashSet。
static <T,V extends T> LinkedHashSet<T>	createLinkedHashSet(V... args) 创建一个LinkedHashSet。
static <T> LinkedList<T>	createLinkedList() 创建一个LinkedList。
static <T> LinkedList<T>	createLinkedList(Iterable<? extends T> c) 创建一个LinkedList。
static <T,V extends T> LinkedList<T>	createLinkedList(V... args) 创建一个LinkedList。
static <K,V> TreeMap<K,V>	createTreeMap() 创建一个TreeMap。
static <K,V> TreeMap<K,V>	createTreeMap(Comparator<? super K> comparator) 创建一个TreeMap。
static <T> TreeSet<T>	createTreeSet() 创建一个TreeSet。
static <T> TreeSet<T>	createTreeSet(Comparator<? super T> comparator) 创建一个TreeSet。
static <T> TreeSet<T>	createTreeSet(Comparator<? super T> comparator, Iterable<? extends T> c) 创建一个TreeSet。
static <T,V extends T> TreeSet<T>	createTreeSet(Comparator<? super T> comparator, V... args) 创建一个TreeSet。
static <T> TreeSet<T>	createTreeSet(Iterable<? extends T> c) 创建一个TreeSet。
static <T,V extends T> TreeSet<T>	createTreeSet(V... args) 创建一个TreeSet。
static <E> Map	extractIndexToMap(Collection<E> collection, String keyPropertyName) 提取集合中的对象的某个属性(通过Getter函数)作为key,集合对象作为值，组合成Map.
static List	extractToList(Collection collection, String propertyName) 提取集合中的对象的一个属性(通过Getter函数), 组合成List.
static Map	extractToMap(Collection collection, String keyPropertyName, String valuePropertyName) 提取集合中的对象的两个属性(通过Getter函数), 组合成Map.
static String	extractToString(Collection collection, String propertyName, String separator) 提取集合中的对象的一个属性(通过Getter函数), 组合成由分割符分隔的字符串.
static <T> T	getFirst(Collection<T> collection) 取得Collection的第一个元素，如果collection为空返回null.
static <T> T	getLast(Collection<T> collection) 获取Collection的最后一个元素 ，如果collection为空返回null.
static <T> List<T>	intersection(Collection<T> a, Collection<T> b) 返回a与b的交集的新List.
static boolean	isEmpty(Collection collection) Return true if the supplied Collection is null or empty.
static boolean	isEmpty(Map map) Return true if the supplied Map is null or empty.
static boolean	isNotEmpty(Collection collection) Return false if the supplied Collection is null or empty.
static <T> List<T>	subtract(Collection<T> a, Collection<T> b) 返回a-b的新List.
static String[]	toNoNullStringArray(Collection collection)
static <T> List<T>	union(Collection<T> a, Collection<T> b) 返回a+b的新List.

Methods inherited from class java.lang.Object

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

Constructor Detail

CollectionUtil

public CollectionUtil()

Method Detail

createArrayList

public static <T> ArrayList<T> createArrayList()

创建一个ArrayList。

createArrayList

public static <T> ArrayList<T> createArrayList(int initialCapacity)

创建一个ArrayList。

createArrayList

public static <T> ArrayList<T> createArrayList(Iterable<? extends T> c)

创建一个ArrayList。

createArrayList

public static <T,V extends T> ArrayList<T> createArrayList(V... args)

创建一个ArrayList。

createLinkedList

public static <T> LinkedList<T> createLinkedList()

创建一个LinkedList。

createLinkedList

public static <T> LinkedList<T> createLinkedList(Iterable<? extends T> c)

创建一个LinkedList。

createLinkedList

public static <T,V extends T> LinkedList<T> createLinkedList(V... args)

创建一个LinkedList。

asList

public static <T> List<T> asList(T... args)

创建一个List。

和createArrayList(args)不同，本方法会返回一个不可变长度的列表，且性能高于 createArrayList(args)。

createHashMap

public static <K,V> HashMap<K,V> createHashMap()

创建一个HashMap。

createHashMap

public static <K,V> HashMap<K,V> createHashMap(int initialCapacity)

创建一个HashMap。

createLinkedHashMap

public static <K,V> LinkedHashMap<K,V> createLinkedHashMap()

创建一个LinkedHashMap。

createLinkedHashMap

public static <K,V> LinkedHashMap<K,V> createLinkedHashMap(int initialCapacity)

创建一个LinkedHashMap。

createTreeMap

public static <K,V> TreeMap<K,V> createTreeMap()

创建一个TreeMap。

createTreeMap

public static <K,V> TreeMap<K,V> createTreeMap(Comparator<? super K> comparator)

创建一个TreeMap。

createConcurrentHashMap

public static <K,V> ConcurrentHashMap<K,V> createConcurrentHashMap()

创建一个ConcurrentHashMap。

createHashSet

public static <T> HashSet<T> createHashSet()

创建一个HashSet。

createHashSet

public static <T,V extends T> HashSet<T> createHashSet(V... args)

创建一个HashSet。

createHashSet

public static <T> HashSet<T> createHashSet(Iterable<? extends T> c)

创建一个HashSet。

createLinkedHashSet

public static <T> LinkedHashSet<T> createLinkedHashSet()

创建一个LinkedHashSet。

createLinkedHashSet

public static <T,V extends T> LinkedHashSet<T> createLinkedHashSet(V... args)

创建一个LinkedHashSet。

createLinkedHashSet

public static <T> LinkedHashSet<T> createLinkedHashSet(Iterable<? extends T> c)

创建一个LinkedHashSet。

createTreeSet

public static <T> TreeSet<T> createTreeSet()

创建一个TreeSet。

createTreeSet

public static <T,V extends T> TreeSet<T> createTreeSet(V... args)

创建一个TreeSet。

createTreeSet

public static <T> TreeSet<T> createTreeSet(Iterable<? extends T> c)

创建一个TreeSet。

createTreeSet

public static <T> TreeSet<T> createTreeSet(Comparator<? super T> comparator)

创建一个TreeSet。

createTreeSet

public static <T,V extends T> TreeSet<T> createTreeSet(Comparator<? super T> comparator,
                                                       V... args)

创建一个TreeSet。

createTreeSet

public static <T> TreeSet<T> createTreeSet(Comparator<? super T> comparator,
                                           Iterable<? extends T> c)

创建一个TreeSet。

isEmpty

public static boolean isEmpty(Collection collection)

Return true if the supplied Collection is null or empty. Otherwise, return false.

Parameters:

collection - the Collection to check

Returns:

whether the given Collection is empty

isNotEmpty

public static boolean isNotEmpty(Collection collection)

Return false if the supplied Collection is null or empty. Otherwise, return true.

Parameters:

collection - the Collection to check

Returns:

whether the given Collection is not empty

isEmpty

public static boolean isEmpty(Map map)

Return true if the supplied Map is null or empty. Otherwise, return false.

Parameters:

map - the Map to check

Returns:

whether the given Map is empty

toNoNullStringArray

public static String[] toNoNullStringArray(Collection collection)

extractToMap

public static Map extractToMap(Collection collection,
                               String keyPropertyName,
                               String valuePropertyName)
                        throws IllegalAccessException,
                               NoSuchMethodException,
                               InvocationTargetException

提取集合中的对象的两个属性(通过Getter函数), 组合成Map.

Parameters:

collection - 来源集合.

keyPropertyName - 要提取为Map中的Key值的属性名.

valuePropertyName - 要提取为Map中的Value值的属性名.

Throws:

IllegalAccessException

NoSuchMethodException

InvocationTargetException

extractIndexToMap

public static <E> Map extractIndexToMap(Collection<E> collection,
                                        String keyPropertyName)

提取集合中的对象的某个属性(通过Getter函数)作为key,集合对象作为值，组合成Map.

Parameters:

collection - 来源集合.

keyPropertyName - 要提取为Map中的Key值的属性名.

extractToList

public static List extractToList(Collection collection,
                                 String propertyName)

提取集合中的对象的一个属性(通过Getter函数), 组合成List.

Parameters:

collection - 来源集合.

propertyName - 要提取的属性名.

Returns:

Throws:

IllegalAccessException

NoSuchMethodException

InvocationTargetException

extractToString

public static String extractToString(Collection collection,
                                     String propertyName,
                                     String separator)
                              throws IllegalAccessException,
                                     NoSuchMethodException,
                                     InvocationTargetException

提取集合中的对象的一个属性(通过Getter函数), 组合成由分割符分隔的字符串.

Parameters:

collection - 来源集合.

propertyName - 要提取的属性名.

separator - 分隔符.

Returns:

Throws:

IllegalAccessException

NoSuchMethodException

InvocationTargetException

convertToString

public static String convertToString(Collection collection,
                                     String separator)

转换Collection所有元素(通过toString())为String, 中间以 separator分隔。

Parameters:

collection -

separator -

Returns:

convertToString

public static String convertToString(Collection collection,
                                     String prefix,
                                     String postfix)

转换Collection所有元素(通过toString())为String, 每个元素的前面加入prefix，后面加入postfix，如

mymessage

。

Parameters:

collection -

prefix -

postfix -

Returns:

getFirst

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

取得Collection的第一个元素，如果collection为空返回null.

Type Parameters:

T -

Parameters:

collection -

Returns:

getLast

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

获取Collection的最后一个元素 ，如果collection为空返回null.

Type Parameters:

T -

Parameters:

collection -

Returns:

union

public static <T> List<T> union(Collection<T> a,
                                Collection<T> b)

返回a+b的新List.

Type Parameters:

T -

Parameters:

a -

b -

Returns:

subtract

public static <T> List<T> subtract(Collection<T> a,
                                   Collection<T> b)

返回a-b的新List.

Type Parameters:

T -

Parameters:

a -

b -

Returns:

intersection

public static <T> List<T> intersection(Collection<T> a,
                                       Collection<T> b)

返回a与b的交集的新List.

Type Parameters:

T -

Parameters:

a -

b -

Returns: