CollUtil (hutool-core 4.6.1 API)

java.lang.Object
- cn.hutool.core.collection.CollUtil

直接已知子类:

CollectionUtil
```
public class CollUtil
extends Object
```
集合相关工具类
此工具方法针对Collection及其实现类封装的工具。
由于Collection 实现了Iterable接口，因此部分工具此类不提供，而是在IterUtil 中提供

从以下版本开始:

3.1.1

作者:

xiaoleilu

另请参阅:
IterUtil

嵌套类概要

嵌套类
限定符和类型	类和说明
`static interface`	`CollUtil.Consumer<T>` 针对一个参数做相应的操作
`static interface`	`CollUtil.Hash<T>` Hash计算接口
`static interface`	`CollUtil.KVConsumer<K,V>` 针对两个参数做相应的操作，例如Map中的KEY和VALUE

构造器概要

构造器
构造器和说明

CollUtil()

构造器
构造器和说明
`CollUtil()`

方法概要

方法
限定符和类型	方法和说明
`static <T> Collection<T>`	`addAll(Collection<T> collection, Enumeration<T> enumeration)` 加入全部
`static <T> Collection<T>`	`addAll(Collection<T> collection, Iterable<T> iterable)` 加入全部
`static <T> Collection<T>`	`addAll(Collection<T> collection, Iterator<T> iterator)` 加入全部
`static <T> Collection<T>`	`addAll(Collection<T> collection, Object value)` 将指定对象全部加入到集合中提供的对象如果为集合类型，会自动转换为目标元素类型
`static <T> Collection<T>`	`addAll(Collection<T> collection, Object value, Type elementType)` 将指定对象全部加入到集合中提供的对象如果为集合类型，会自动转换为目标元素类型
`static <T> Collection<T>`	`addAll(Collection<T> collection, T[] values)` 加入全部
`static <T> List<T>`	`addAllIfNotContains(List<T> list, List<T> otherList)` 将另一个列表中的元素加入到列表中，如果列表中已经存在此元素则忽略之
`static <E> Enumeration<E>`	`asEnumeration(Iterator<E> iter)` Iterator转换为Enumeration Adapt the specified `Iterator` to the `Enumeration` interface.
`static <E> Iterable<E>`	`asIterable(Iterator<E> iter)` `Iterator` 转为 `Iterable`
`static <E> Iterator<E>`	`asIterator(Enumeration<E> e)` Enumeration转换为Iterator Adapt the specified `Enumeration` to the `Iterator` interface
`static boolean`	`contains(Collection<?> collection, Object value)` 判断指定集合是否包含指定值，如果集合为空（null或者空），返回`false`，否则找到元素返回`true`
`static boolean`	`containsAll(Collection<?> coll1, Collection<?> coll2)` 集合1中是否包含集合2中所有的元素，既集合2是否为集合1的子集
`static boolean`	`containsAny(Collection<?> coll1, Collection<?> coll2)` 其中一个集合在另一个集合中是否至少包含一个元素，既是两个集合是否至少有一个共同的元素
`static <T> int`	`count(Iterable<T> iterable, Matcher<T> matcher)` 集合中匹配规则的数量
`static <T> Map<T,Integer>`	`countMap(Iterable<T> collection)` 根据集合返回一个元素计数的 `Map` 所谓元素计数就是假如这个集合中某个元素出现了n次，那将这个元素做为key，n做为value 例如：[a,b,c,c,c] 得到： a: 1 b: 1 c: 3
`static <T> Collection<T>`	`create(Class<?> collectionType)` 创建新的集合对象
`static <K,V> Map<K,V>`	`createMap(Class<?> mapType)` 创建Map 传入抽象Map`AbstractMap`和`Map`类将默认创建`HashMap`
`static <T> Collection<T>`	`disjunction(Collection<T> coll1, Collection<T> coll2)` 两个集合的差集针对一个集合中存在多个相同元素的情况，计算两个集合中此元素的个数，保留两个集合中此元素个数差的个数例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c] 结果：[c]，此结果中只保留了一个任意一个集合为空，返回另一个集合两个集合无交集则返回两个集合的组合
`static <T> ArrayList<T>`	`distinct(Collection<T> collection)` 去重集合
`static List<Object>`	`extract(Iterable<?> collection, Editor<Object> editor)` 通过Editor抽取集合元素中的某些值返回为新列表例如提供的是一个Bean列表，通过Editor接口实现获取某个字段值，返回这个字段值组成的新列表
`static List<Object>`	`extract(Iterable<?> collection, Editor<Object> editor, boolean ignoreNull)` 通过Editor抽取集合元素中的某些值返回为新列表例如提供的是一个Bean列表，通过Editor接口实现获取某个字段值，返回这个字段值组成的新列表
`static <T> Collection<T>`	`filter(Collection<T> collection, Editor<T> editor)` 过滤过滤过程通过传入的Editor实现来返回需要的元素内容，这个Editor实现可以实现以下功能： 1、过滤出需要的对象，如果返回null表示这个元素对象抛弃 2、修改元素对象，返回集合中为修改后的对象
`static <T> Collection<T>`	`filter(Collection<T> collection, Filter<T> filter)` 过滤过滤过程通过传入的Filter实现来过滤返回需要的元素内容，这个Filter实现可以实现以下功能： 1、过滤出需要的对象，`Filter.accept(Object)`方法返回true的对象将被加入结果集合中
`static <T> List<T>`	`filter(List<T> list, Editor<T> editor)` 过滤过滤过程通过传入的Editor实现来返回需要的元素内容，这个Editor实现可以实现以下功能： 1、过滤出需要的对象，如果返回null表示这个元素对象抛弃 2、修改元素对象，返回集合中为修改后的对象
`static <T> List<T>`	`filter(List<T> list, Filter<T> filter)` 过滤过滤过程通过传入的Filter实现来过滤返回需要的元素内容，这个Filter实现可以实现以下功能： 1、过滤出需要的对象，`Filter.accept(Object)`方法返回true的对象将被加入结果集合中
`static <K,V> Map<K,V>`	`filter(Map<K,V> map, Editor<Map.Entry<K,V>> editor)` 过滤过滤过程通过传入的Editor实现来返回需要的元素内容，这个Editor实现可以实现以下功能： 1、过滤出需要的对象，如果返回null表示这个元素对象抛弃 2、修改元素对象，返回集合中为修改后的对象
`static <K,V> Map<K,V>`	`filter(Map<K,V> map, Filter<Map.Entry<K,V>> filter)` 过滤过滤过程通过传入的Editor实现来返回需要的元素内容，这个Editor实现可以实现以下功能： 1、过滤出需要的对象，如果返回null表示这个元素对象抛弃 2、修改元素对象，返回集合中为修改后的对象
`static <T> T`	`findOne(Iterable<T> collection, Filter<T> filter)` 查找第一个匹配元素对象
`static <T> T`	`findOneByField(Iterable<T> collection, String fieldName, Object fieldValue)` 查找第一个匹配元素对象如果集合元素是Map，则比对键和值是否相同，相同则返回如果为普通Bean，则通过反射比对元素字段名对应的字段值是否相同，相同则返回如果给定字段值参数是`null` 且元素对象中的字段值也为`null`则认为相同
`static <T> void`	`forEach(Enumeration<T> enumeration, CollUtil.Consumer<T> consumer)` 循环遍历 `Enumeration`，使用`CollUtil.Consumer` 接受遍历的每条数据，并针对每条数据做处理
`static <T> void`	`forEach(Iterator<T> iterator, CollUtil.Consumer<T> consumer)` 循环遍历 `Iterator`，使用`CollUtil.Consumer` 接受遍历的每条数据，并针对每条数据做处理
`static <K,V> void`	`forEach(Map<K,V> map, CollUtil.KVConsumer<K,V> kvConsumer)` 循环遍历Map，使用`CollUtil.KVConsumer` 接受遍历的每条数据，并针对每条数据做处理
`static <T> T`	`get(Collection<T> collection, int index)` 获取集合中指定下标的元素值，下标可以为负数，例如-1表示最后一个元素如果元素越界，返回null
`static <T> List<T>`	`getAny(Collection<T> collection, int... indexes)` 获取集合中指定多个下标的元素值，下标可以为负数，例如-1表示最后一个元素
`static Class<?>`	`getElementType(Iterable<?> iterable)` 获得`Iterable`对象的元素类型（通过第一个非空元素判断）
`static Class<?>`	`getElementType(Iterator<?> iterator)` 获得`Iterator`对象的元素类型（通过第一个非空元素判断）
`static List<Object>`	`getFieldValues(Iterable<?> collection, String fieldName)` 获取给定Bean列表中指定字段名对应字段值的列表列表元素支持Bean与Map
`static List<Object>`	`getFieldValues(Iterable<?> collection, String fieldName, boolean ignoreNull)` 获取给定Bean列表中指定字段名对应字段值的列表列表元素支持Bean与Map
`static <T> List<T>`	`getFieldValues(Iterable<?> collection, String fieldName, Class<T> elementType)` 获取给定Bean列表中指定字段名对应字段值的列表列表元素支持Bean与Map
`static <T> T`	`getFirst(Iterable<T> iterable)` 获取集合的第一个元素
`static <T> T`	`getFirst(Iterator<T> iterator)` 获取集合的第一个元素
`static <T> T`	`getLast(Collection<T> collection)` 获取集合的最后一个元素
`static <T> List<List<T>>`	`group(Collection<T> collection, CollUtil.Hash<T> hash)` 分组，按照`CollUtil.Hash`接口定义的hash算法，集合中的元素放入hash值对应的子列表中
`static <T> List<List<T>>`	`groupByField(Collection<T> collection, String fieldName)` 根据元素的指定字段名分组，非Bean都放在第一个分组中
`static boolean`	`hasNull(Iterable<?> iterable)` 是否包含`null`元素
`static <T> Collection<T>`	`intersection(Collection<T> coll1, Collection<T> coll2)` 两个集合的交集针对一个集合中存在多个相同元素的情况，计算两个集合中此元素的个数，保留最少的个数例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c] 结果：[a, b, c, c]，此结果中只保留了两个c
`static <T> Collection<T>`	`intersection(Collection<T> coll1, Collection<T> coll2, Collection<T>... otherColls)` 多个集合的交集针对一个集合中存在多个相同元素的情况，计算两个集合中此元素的个数，保留最少的个数例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c] 结果：[a, b, c, c]，此结果中只保留了两个c
`static boolean`	`isEmpty(Collection<?> collection)` 集合是否为空
`static boolean`	`isEmpty(Enumeration<?> enumeration)` Enumeration是否为空
`static boolean`	`isEmpty(Iterable<?> iterable)` Iterable是否为空
`static boolean`	`isEmpty(Iterator<?> Iterator)` Iterator是否为空
`static boolean`	`isEmpty(Map<?,?> map)` Map是否为空
`static boolean`	`isNotEmpty(Collection<?> collection)` 集合是否为非空
`static boolean`	`isNotEmpty(Enumeration<?> enumeration)` Enumeration是否为空
`static boolean`	`isNotEmpty(Iterable<?> iterable)` Iterable是否为空
`static boolean`	`isNotEmpty(Iterator<?> Iterator)` Iterator是否为空
`static boolean`	`isNotEmpty(Map<?,?> map)` Map是否为非空
`static <T> String`	`join(Iterable<T> iterable, CharSequence conjunction)` 以 conjunction 为分隔符将集合转换为字符串如果集合元素为数组、`Iterable`或`Iterator`，则递归组合其为字符串
`static <T> String`	`join(Iterator<T> iterator, CharSequence conjunction)` 以 conjunction 为分隔符将集合转换为字符串如果集合元素为数组、`Iterable`或`Iterator`，则递归组合其为字符串
`static <K> Set<K>`	`keySet(Collection<Map<K,?>> mapCollection)` 获取指定Map列表中所有的Key
`static <T> List<T>`	`list(boolean isLinked)` 新建一个空List
`static <T> List<T>`	`list(boolean isLinked, Collection<T> collection)` 新建一个List
`static <T> List<T>`	`list(boolean isLinked, Enumeration<T> enumration)` 新建一个List 提供的参数为null时返回空`ArrayList`
`static <T> List<T>`	`list(boolean isLinked, Iterable<T> iterable)` 新建一个List 提供的参数为null时返回空`ArrayList`
`static <T> List<T>`	`list(boolean isLinked, Iterator<T> iter)` 新建一个ArrayList 提供的参数为null时返回空`ArrayList`
`static <T> List<T>`	`list(boolean isLinked, T... values)` 新建一个List
`static <T> ArrayList<T>`	`newArrayList(Collection<T> collection)` 新建一个ArrayList
`static <T> ArrayList<T>`	`newArrayList(Enumeration<T> enumration)` 新建一个ArrayList 提供的参数为null时返回空`ArrayList`
`static <T> ArrayList<T>`	`newArrayList(Iterable<T> iterable)` 新建一个ArrayList 提供的参数为null时返回空`ArrayList`
`static <T> ArrayList<T>`	`newArrayList(Iterator<T> iter)` 新建一个ArrayList 提供的参数为null时返回空`ArrayList`
`static <T> ArrayList<T>`	`newArrayList(T... values)` 新建一个ArrayList
`static <T> BlockingQueue<T>`	`newBlockingQueue(int capacity, boolean isLinked)` 新建`BlockingQueue` 在队列为空时，获取元素的线程会等待队列变为非空。
`static <T> CopyOnWriteArrayList<T>`	`newCopyOnWriteArrayList(Collection<T> collection)` 新建一个CopyOnWriteArrayList
`static <K,V> HashMap<K,V>`	`newHashMap()` 新建一个HashMap
`static <K,V> HashMap<K,V>`	`newHashMap(int size)` 新建一个HashMap
`static <K,V> HashMap<K,V>`	`newHashMap(int size, boolean isOrder)` 新建一个HashMap
`static <T> HashSet<T>`	`newHashSet(boolean isSorted, Collection<T> collection)` 新建一个HashSet
`static <T> HashSet<T>`	`newHashSet(boolean isSorted, Enumeration<T> enumration)` 新建一个HashSet
`static <T> HashSet<T>`	`newHashSet(boolean isSorted, Iterator<T> iter)` 新建一个HashSet
`static <T> HashSet<T>`	`newHashSet(boolean isSorted, T... ts)` 新建一个HashSet
`static <T> HashSet<T>`	`newHashSet(Collection<T> collection)` 新建一个HashSet
`static <T> HashSet<T>`	`newHashSet(T... ts)` 新建一个HashSet
`static <T> LinkedHashSet<T>`	`newLinkedHashSet(T... ts)` 新建一个LinkedHashSet
`static <T> LinkedList<T>`	`newLinkedList(T... values)` 新建LinkedList
`static <T> List<T>`	`page(int pageNo, int pageSize, List<T> list)` 对指定List分页取值
`static <T> List<T>`	`popPart(Deque<T> surplusAlaDatas, int partSize)` 切取部分数据切取后的栈将减少这些元素
`static <T> List<T>`	`popPart(Stack<T> surplusAlaDatas, int partSize)` 切取部分数据切取后的栈将减少这些元素
`static <T> Collection<T>`	`removeAny(Collection<T> collection, T... elesRemoved)` 去掉集合中的多个元素
`static <T extends CharSequence> Collection<T>`	`removeBlank(Collection<T> collection)` 去除`null`或者""或者空白字符串元素
`static <T extends CharSequence> Collection<T>`	`removeEmpty(Collection<T> collection)` 去除`null`或者"" 元素
`static <T> Collection<T>`	`removeNull(Collection<T> collection)` 去除`null` 元素
`static <T> List<T>`	`reverse(List<T> list)` 反序给定List，会在原List基础上直接修改
`static <T> List<T>`	`reverseNew(List<T> list)` 反序给定List，会创建一个新的List，原List数据不变
`static <T> List<T>`	`setOrAppend(List<T> list, int index, T element)` 设置或增加元素。
`static <T> List<T>`	`sort(Collection<T> collection, Comparator<? super T> comparator)` 排序集合，排序不会修改原集合
`static <T> List<T>`	`sort(List<T> list, Comparator<? super T> c)` 针对List排序，排序会修改原List
`static <K,V> TreeMap<K,V>`	`sort(Map<K,V> map, Comparator<? super K> comparator)` 排序Map
`static <K,V> LinkedHashMap<K,V>`	`sortByEntry(Map<K,V> map, Comparator<Map.Entry<K,V>> comparator)` 通过Entry排序，可以按照键排序，也可以按照值排序，亦或者两者综合排序
`static <T> List<String>`	`sortByPinyin(Collection<String> collection)` 根据汉字的拼音顺序排序
`static <T> List<String>`	`sortByPinyin(List<String> list)` 根据汉字的拼音顺序排序
`static <T> List<T>`	`sortByProperty(Collection<T> collection, String property)` 根据Bean的属性排序
`static <T> List<T>`	`sortByProperty(List<T> list, String property)` 根据Bean的属性排序
`static <K,V> List<Map.Entry<K,V>>`	`sortEntryToList(Collection<Map.Entry<K,V>> collection)` 将Set排序（根据Entry的值）
`static <T> List<T>`	`sortPageAll(int pageNo, int pageSize, Comparator<T> comparator, Collection<T>... colls)` 将多个集合排序并显示不同的段落（分页）采用`BoundedPriorityQueue`实现分页取局部
`static <K,V> LinkedHashMap<K,V>`	`sortToMap(Collection<Map.Entry<K,V>> entryCollection, Comparator<Map.Entry<K,V>> comparator)` 通过Entry排序，可以按照键排序，也可以按照值排序，亦或者两者综合排序
`static <T> List<List<T>>`	`split(Collection<T> collection, int size)` 对集合按照指定长度分段，每一个段为单独的集合，返回这个集合的列表
`static <T> List<T>`	`sub(Collection<T> collection, int start, int end)` 截取集合的部分
`static <T> List<T>`	`sub(Collection<T> list, int start, int end, int step)` 截取集合的部分
`static <T> List<T>`	`sub(List<T> list, int start, int end)` 截取集合的部分
`static <T> List<T>`	`sub(List<T> list, int start, int end, int step)` 截取集合的部分
`static <E> Collection<E>`	`toCollection(Iterable<E> iterable)` `Iterable`转为`Collection` 首先尝试强转，强转失败则构建一个新的`ArrayList`
`static <T> ArrayList<T>`	`toList(T... values)` 数组转为ArrayList
`static <K,V> Map<K,List<V>>`	`toListMap(Iterable<? extends Map<K,V>> mapList)` 行转列，合并相同的键，值合并为列表将Map列表中相同key的值组成列表做为Map的value 是`toMapList(Map)`的逆方法比如传入数据： [ {a: 1, b: 1, c: 1} {a: 2, b: 2} {a: 3, b: 3} {a: 4} ] 结果是： { a: [1,2,3,4] b: [1,2,3,] c: [1] }
`static <K,V> HashMap<K,V>`	`toMap(Iterable<Map.Entry<K,V>> entryIter)` 将Entry集合转换为HashMap
`static HashMap<Object,Object>`	`toMap(Object[] array)` 将数组转换为Map（HashMap），支持数组元素类型为： Map.Entry 长度大于1的数组（取前两个值），如果不满足跳过此元素 Iterable 长度也必须大于1（取前两个值），如果不满足跳过此元素 Iterator 长度也必须大于1（取前两个值），如果不满足跳过此元素 Map<Object, Object> colorMap = CollectionUtil.toMap(new String[][] {{ {"RED", "#FF0000"}, {"GREEN", "#00FF00"}, {"BLUE", "#0000FF"}}); 参考：commons-lang
`static <K,V> List<Map<K,V>>`	`toMapList(Map<K,? extends Iterable<V>> listMap)` 列转行。
`static <T> TreeSet<T>`	`toTreeSet(Collection<T> collection, Comparator<T> comparator)` 将集合转换为排序后的TreeSet
`static <T> Collection<T>`	`union(Collection<T> coll1, Collection<T> coll2)` 两个集合的并集针对一个集合中存在多个相同元素的情况，计算两个集合中此元素的个数，保留最多的个数例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c] 结果：[a, b, c, c, c]，此结果中只保留了三个c
`static <T> Collection<T>`	`union(Collection<T> coll1, Collection<T> coll2, Collection<T>... otherColls)` 多个集合的并集针对一个集合中存在多个相同元素的情况，计算两个集合中此元素的个数，保留最多的个数例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c] 结果：[a, b, c, c, c]，此结果中只保留了三个c
`static <V> List<V>`	`values(Collection<Map<?,V>> mapCollection)` 获取指定Map列表中所有的Value
`static <K,V> ArrayList<V>`	`valuesOfKeys(Map<K,V> map, Iterable<K> keys)` 从Map中获取指定键列表对应的值列表如果key在map中不存在或key对应值为null，则返回值列表对应位置的值也为null
`static <K,V> ArrayList<V>`	`valuesOfKeys(Map<K,V> map, Iterator<K> keys)` 从Map中获取指定键列表对应的值列表如果key在map中不存在或key对应值为null，则返回值列表对应位置的值也为null
`static <K,V> ArrayList<V>`	`valuesOfKeys(Map<K,V> map, K... keys)` 从Map中获取指定键列表对应的值列表如果key在map中不存在或key对应值为null，则返回值列表对应位置的值也为null
`static <K,V> Map<K,V>`	`zip(Collection<K> keys, Collection<V> values)` 映射键值（参考Python的zip()函数）例如： keys = [a,b,c,d] values = [1,2,3,4] 则得到的Map是 {a=1, b=2, c=3, d=4} 如果两个数组长度不同，则只对应最短部分
`static Map<String,String>`	`zip(String keys, String values, String delimiter)` 映射键值（参考Python的zip()函数），返回Map无序例如： keys = a,b,c,d values = 1,2,3,4 delimiter = , 则得到的Map是 {a=1, b=2, c=3, d=4} 如果两个数组长度不同，则只对应最短部分
`static Map<String,String>`	`zip(String keys, String values, String delimiter, boolean isOrder)` 映射键值（参考Python的zip()函数）例如： keys = a,b,c,d values = 1,2,3,4 delimiter = , 则得到的Map是 {a=1, b=2, c=3, d=4} 如果两个数组长度不同，则只对应最短部分

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - CollUtil
```
public CollUtil()
```
- 方法详细资料
  - union
```
public static <T> Collection<T> union(Collection<T> coll1,
                      Collection<T> coll2)
```
    两个集合的并集
    针对一个集合中存在多个相同元素的情况，计算两个集合中此元素的个数，保留最多的个数
    例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c]
    结果：[a, b, c, c, c]，此结果中只保留了三个c
    
    类型参数:
    T - 集合元素类型
    参数:
    coll1 - 集合1
    coll2 - 集合2
    
    返回:
    并集的集合，返回 ArrayList
  - union
```
@SafeVarargs
public static <T> Collection<T> union(Collection<T> coll1,
                                  Collection<T> coll2,
                                  Collection<T>... otherColls)
```
    多个集合的并集
    针对一个集合中存在多个相同元素的情况，计算两个集合中此元素的个数，保留最多的个数
    例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c]
    结果：[a, b, c, c, c]，此结果中只保留了三个c
    
    类型参数:
    T - 集合元素类型
    参数:
    coll1 - 集合1
    coll2 - 集合2
    otherColls - 其它集合
    
    返回:
    并集的集合，返回 ArrayList
  - intersection
```
public static <T> Collection<T> intersection(Collection<T> coll1,
                             Collection<T> coll2)
```
    两个集合的交集
    针对一个集合中存在多个相同元素的情况，计算两个集合中此元素的个数，保留最少的个数
    例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c]
    结果：[a, b, c, c]，此结果中只保留了两个c
    
    类型参数:
    T - 集合元素类型
    参数:
    coll1 - 集合1
    coll2 - 集合2
    
    返回:
    交集的集合，返回 ArrayList
  - intersection
```
@SafeVarargs
public static <T> Collection<T> intersection(Collection<T> coll1,
                                         Collection<T> coll2,
                                         Collection<T>... otherColls)
```
    多个集合的交集
    针对一个集合中存在多个相同元素的情况，计算两个集合中此元素的个数，保留最少的个数
    例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c]
    结果：[a, b, c, c]，此结果中只保留了两个c
    
    类型参数:
    T - 集合元素类型
    参数:
    coll1 - 集合1
    coll2 - 集合2
    otherColls - 其它集合
    
    返回:
    并集的集合，返回 ArrayList
  - disjunction
```
public static <T> Collection<T> disjunction(Collection<T> coll1,
                            Collection<T> coll2)
```
    两个集合的差集
    针对一个集合中存在多个相同元素的情况，计算两个集合中此元素的个数，保留两个集合中此元素个数差的个数
    例如：集合1：[a, b, c, c, c]，集合2：[a, b, c, c]
    结果：[c]，此结果中只保留了一个
    任意一个集合为空，返回另一个集合
    两个集合无交集则返回两个集合的组合
    
    类型参数:
    T - 集合元素类型
    参数:
    coll1 - 集合1
    coll2 - 集合2
    
    返回:
    差集的集合，返回 ArrayList
  - contains
```
public static boolean contains(Collection<?> collection,
               Object value)
```
    判断指定集合是否包含指定值，如果集合为空（null或者空），返回false，否则找到元素返回true
    
    参数:
    collection - 集合
    value - 需要查找的值
    
    返回:
    如果集合为空（null或者空），返回false，否则找到元素返回true
    从以下版本开始:
    
    4.1.10
  - containsAny
```
public static boolean containsAny(Collection<?> coll1,
                  Collection<?> coll2)
```
    其中一个集合在另一个集合中是否至少包含一个元素，既是两个集合是否至少有一个共同的元素
    
    参数:
    coll1 - 集合1
    coll2 - 集合2
    
    返回:
    其中一个集合在另一个集合中是否至少包含一个元素
    从以下版本开始:
    
    2.1
    
    另请参阅:
    intersection(java.util.Collection<T>, java.util.Collection<T>)
  - containsAll
```
public static boolean containsAll(Collection<?> coll1,
                  Collection<?> coll2)
```
    集合1中是否包含集合2中所有的元素，既集合2是否为集合1的子集
    
    参数:
    coll1 - 集合1
    coll2 - 集合2
    
    返回:
    集合1中是否包含集合2中所有的元素
    从以下版本开始:
    
    4.5.12
  - countMap
```
public static <T> Map<T,Integer> countMap(Iterable<T> collection)
```
    根据集合返回一个元素计数的 Map
    所谓元素计数就是假如这个集合中某个元素出现了n次，那将这个元素做为key，n做为value
    例如：[a,b,c,c,c] 得到：
    a: 1
    b: 1
    c: 3
    
    类型参数:
    T - 集合元素类型
    参数:
    collection - 集合
    
    返回:
    Map
    另请参阅:
    IterUtil.countMap(Iterable)
  - join
```
public static <T> String join(Iterable<T> iterable,
              CharSequence conjunction)
```
    以 conjunction 为分隔符将集合转换为字符串
    如果集合元素为数组、Iterable或Iterator，则递归组合其为字符串
    
    类型参数:
    T - 集合元素类型
    参数:
    iterable - Iterable
    conjunction - 分隔符
    
    返回:
    连接后的字符串
    另请参阅:
    IterUtil.join(Iterable, CharSequence)
  - join
```
public static <T> String join(Iterator<T> iterator,
              CharSequence conjunction)
```
    以 conjunction 为分隔符将集合转换为字符串
    如果集合元素为数组、Iterable或Iterator，则递归组合其为字符串
    
    类型参数:
    T - 集合元素类型
    参数:
    iterator - 集合
    conjunction - 分隔符
    
    返回:
    连接后的字符串
    另请参阅:
    IterUtil.join(Iterator, CharSequence)
  - popPart
```
public static <T> List<T> popPart(Stack<T> surplusAlaDatas,
                  int partSize)
```
    切取部分数据
    切取后的栈将减少这些元素
    
    类型参数:
    T - 集合元素类型
    参数:
    surplusAlaDatas - 原数据
    partSize - 每部分数据的长度
    
    返回:
    切取出的数据或null
  - popPart
```
public static <T> List<T> popPart(Deque<T> surplusAlaDatas,
                  int partSize)
```
    切取部分数据
    切取后的栈将减少这些元素
    
    类型参数:
    T - 集合元素类型
    参数:
    surplusAlaDatas - 原数据
    partSize - 每部分数据的长度
    
    返回:
    切取出的数据或null
  - newHashMap
```
public static <K,V> HashMap<K,V> newHashMap()
```
    新建一个HashMap
    
    类型参数:
    K - Key类型
    V - Value类型
    
    返回:
    HashMap对象
    另请参阅:
    MapUtil.newHashMap()
  - newHashMap
```
public static <K,V> HashMap<K,V> newHashMap(int size,
                            boolean isOrder)
```
    新建一个HashMap
    
    类型参数:
    K - Key类型
    V - Value类型
    参数:
    size - 初始大小，由于默认负载因子0.75，传入的size会实际初始大小为size / 0.75
    isOrder - Map的Key是否有序，有序返回 LinkedHashMap，否则返回 HashMap
    
    返回:
    HashMap对象
    从以下版本开始:
    
    3.0.4
    
    另请参阅:
    MapUtil.newHashMap(int, boolean)
  - newHashMap
```
public static <K,V> HashMap<K,V> newHashMap(int size)
```
    新建一个HashMap
    
    类型参数:
    K - Key类型
    V - Value类型
    参数:
    size - 初始大小，由于默认负载因子0.75，传入的size会实际初始大小为size / 0.75
    
    返回:
    HashMap对象
    另请参阅:
    MapUtil.newHashMap(int)
  - newHashSet
```
@SafeVarargs
public static <T> HashSet<T> newHashSet(T... ts)
```
    新建一个HashSet
    
    类型参数:
    T - 集合元素类型
    参数:
    ts - 元素数组
    
    返回:
    HashSet对象
  - newLinkedHashSet
```
@SafeVarargs
public static <T> LinkedHashSet<T> newLinkedHashSet(T... ts)
```
    新建一个LinkedHashSet
    
    类型参数:
    T - 集合元素类型
    参数:
    ts - 元素数组
    
    返回:
    HashSet对象
    从以下版本开始:
    
    4.1.10
  - newHashSet
```
@SafeVarargs
public static <T> HashSet<T> newHashSet(boolean isSorted,
                                    T... ts)
```
    新建一个HashSet
    
    类型参数:
    T - 集合元素类型
    参数:
    isSorted - 是否有序，有序返回 LinkedHashSet，否则返回 HashSet
    ts - 元素数组
    
    返回:
    HashSet对象
  - newHashSet
```
public static <T> HashSet<T> newHashSet(Collection<T> collection)
```
    新建一个HashSet
    
    类型参数:
    T - 集合元素类型
    参数:
    collection - 集合
    
    返回:
    HashSet对象
  - newHashSet
```
public static <T> HashSet<T> newHashSet(boolean isSorted,
                        Collection<T> collection)
```
    新建一个HashSet
    
    类型参数:
    T - 集合元素类型
    参数:
    isSorted - 是否有序，有序返回 LinkedHashSet，否则返回HashSet
    collection - 集合，用于初始化Set
    
    返回:
    HashSet对象
  - newHashSet
```
public static <T> HashSet<T> newHashSet(boolean isSorted,
                        Iterator<T> iter)
```
    新建一个HashSet
    
    类型参数:
    T - 集合元素类型
    参数:
    isSorted - 是否有序，有序返回 LinkedHashSet，否则返回HashSet
    iter - Iterator
    
    返回:
    HashSet对象
    从以下版本开始:
    
    3.0.8
  - newHashSet
```
public static <T> HashSet<T> newHashSet(boolean isSorted,
                        Enumeration<T> enumration)
```
    新建一个HashSet
    
    类型参数:
    T - 集合元素类型
    参数:
    isSorted - 是否有序，有序返回 LinkedHashSet，否则返回HashSet
    enumration - Enumeration
    
    返回:
    HashSet对象
    从以下版本开始:
    
    3.0.8
  - list
```
public static <T> List<T> list(boolean isLinked)
```
    新建一个空List
    
    类型参数:
    T - 集合元素类型
    参数:
    isLinked - 是否新建LinkedList
    
    返回:
    List对象
    从以下版本开始:
    
    4.1.2
  - list
```
@SafeVarargs
public static <T> List<T> list(boolean isLinked,
                           T... values)
```
    新建一个List
    
    类型参数:
    T - 集合元素类型
    参数:
    isLinked - 是否新建LinkedList
    values - 数组
    
    返回:
    List对象
    从以下版本开始:
    
    4.1.2
  - list
```
public static <T> List<T> list(boolean isLinked,
               Collection<T> collection)
```
    新建一个List
    
    类型参数:
    T - 集合元素类型
    参数:
    isLinked - 是否新建LinkedList
    collection - 集合
    
    返回:
    List对象
    从以下版本开始:
    
    4.1.2
  - list
```
public static <T> List<T> list(boolean isLinked,
               Iterable<T> iterable)
```
    新建一个List
    提供的参数为null时返回空ArrayList
    
    类型参数:
    T - 集合元素类型
    参数:
    isLinked - 是否新建LinkedList
    iterable - Iterable
    
    返回:
    List对象
    从以下版本开始:
    
    4.1.2
  - list
```
public static <T> List<T> list(boolean isLinked,
               Iterator<T> iter)
```
    新建一个ArrayList
    提供的参数为null时返回空ArrayList
    
    类型参数:
    T - 集合元素类型
    参数:
    isLinked - 是否新建LinkedList
    iter - Iterator
    
    返回:
    ArrayList对象
    从以下版本开始:
    
    4.1.2
  - list
```
public static <T> List<T> list(boolean isLinked,
               Enumeration<T> enumration)
```
    新建一个List
    提供的参数为null时返回空ArrayList
    
    类型参数:
    T - 集合元素类型
    参数:
    isLinked - 是否新建LinkedList
    enumration - Enumeration
    
    返回:
    ArrayList对象
    从以下版本开始:
    
    3.0.8
  - newArrayList
```
@SafeVarargs
public static <T> ArrayList<T> newArrayList(T... values)
```
    新建一个ArrayList
    
    类型参数:
    T - 集合元素类型
    参数:
    values - 数组
    
    返回:
    ArrayList对象
  - toList
```
@SafeVarargs
public static <T> ArrayList<T> toList(T... values)
```
    数组转为ArrayList
    
    类型参数:
    T - 集合元素类型
    参数:
    values - 数组
    
    返回:
    ArrayList对象
    从以下版本开始:
    
    4.0.11
  - newArrayList
```
public static <T> ArrayList<T> newArrayList(Collection<T> collection)
```
    新建一个ArrayList
    
    类型参数:
    T - 集合元素类型
    参数:
    collection - 集合
    
    返回:
    ArrayList对象
  - newArrayList
```
public static <T> ArrayList<T> newArrayList(Iterable<T> iterable)
```
    新建一个ArrayList
    提供的参数为null时返回空ArrayList
    
    类型参数:
    T - 集合元素类型
    参数:
    iterable - Iterable
    
    返回:
    ArrayList对象
    从以下版本开始:
    
    3.1.0
  - newArrayList
```
public static <T> ArrayList<T> newArrayList(Iterator<T> iter)
```
    新建一个ArrayList
    提供的参数为null时返回空ArrayList
    
    类型参数:
    T - 集合元素类型
    参数:
    iter - Iterator
    
    返回:
    ArrayList对象
    从以下版本开始:
    
    3.0.8
  - newArrayList
```
public static <T> ArrayList<T> newArrayList(Enumeration<T> enumration)
```
    新建一个ArrayList
    提供的参数为null时返回空ArrayList
    
    类型参数:
    T - 集合元素类型
    参数:
    enumration - Enumeration
    
    返回:
    ArrayList对象
    从以下版本开始:
    
    3.0.8
  - newLinkedList
```
@SafeVarargs
public static <T> LinkedList<T> newLinkedList(T... values)
```
    新建LinkedList
    
    类型参数:
    T - 类型
    参数:
    values - 数组
    
    返回:
    LinkedList
    从以下版本开始:
    
    4.1.2
  - newCopyOnWriteArrayList
```
public static <T> CopyOnWriteArrayList<T> newCopyOnWriteArrayList(Collection<T> collection)
```
    新建一个CopyOnWriteArrayList
    
    类型参数:
    T - 集合元素类型
    参数:
    collection - 集合
    
    返回:
    CopyOnWriteArrayList
  - newBlockingQueue
```
public static <T> BlockingQueue<T> newBlockingQueue(int capacity,
                                    boolean isLinked)
```
    新建BlockingQueue
    在队列为空时，获取元素的线程会等待队列变为非空。当队列满时，存储元素的线程会等待队列可用。
    
    参数:
    capacity - 容量
    isLinked - 是否为链表形式
    
    返回:
    BlockingQueue
    从以下版本开始:
    
    3.3.0
  - create
```
public static <T> Collection<T> create(Class<?> collectionType)
```
    创建新的集合对象
    
    类型参数:
    T - 集合类型
    参数:
    collectionType - 集合类型
    
    返回:
    集合类型对应的实例
    从以下版本开始:
    
    3.0.8
  - createMap
```
public static <K,V> Map<K,V> createMap(Class<?> mapType)
```
    创建Map
    传入抽象MapAbstractMap和Map类将默认创建HashMap
    
    类型参数:
    K - map键类型
    V - map值类型
    参数:
    mapType - map类型
    
    返回:
    Map实例
    另请参阅:
    MapUtil.createMap(Class)
  - distinct
```
public static <T> ArrayList<T> distinct(Collection<T> collection)
```
    去重集合
    
    类型参数:
    T - 集合元素类型
    参数:
    collection - 集合
    
    返回:
    ArrayList
  - sub
```
public static <T> List<T> sub(List<T> list,
              int start,
              int end)
```
    截取集合的部分
    
    类型参数:
    T - 集合元素类型
    参数:
    list - 被截取的数组
    start - 开始位置（包含）
    end - 结束位置（不包含）
    
    返回:
    截取后的数组，当开始位置超过最大时，返回空的List
  - sub
```
public static <T> List<T> sub(List<T> list,
              int start,
              int end,
              int step)
```
    截取集合的部分
    
    类型参数:
    T - 集合元素类型
    参数:
    list - 被截取的数组
    start - 开始位置（包含）
    end - 结束位置（不包含）
    step - 步进
    
    返回:
    截取后的数组，当开始位置超过最大时，返回空的List
    从以下版本开始:
    
    4.0.6
  - sub
```
public static <T> List<T> sub(Collection<T> collection,
              int start,
              int end)
```
    截取集合的部分
    
    类型参数:
    T - 集合元素类型
    参数:
    collection - 被截取的数组
    start - 开始位置（包含）
    end - 结束位置（不包含）
    
    返回:
    截取后的数组，当开始位置超过最大时，返回null
  - sub
```
public static <T> List<T> sub(Collection<T> list,
              int start,
              int end,
              int step)
```
    截取集合的部分
    
    类型参数:
    T - 集合元素类型
    参数:
    list - 被截取的数组
    start - 开始位置（包含）
    end - 结束位置（不包含）
    step - 步进
    
    返回:
    截取后的数组，当开始位置超过最大时，返回空集合
    从以下版本开始:
    
    4.0.6
  - split
```
public static <T> List<List<T>> split(Collection<T> collection,
                      int size)
```
    对集合按照指定长度分段，每一个段为单独的集合，返回这个集合的列表
    
    类型参数:
    T - 集合元素类型
    参数:
    collection - 集合
    size - 每个段的长度
    
    返回:
    分段列表
  - filter
```
public static <T> Collection<T> filter(Collection<T> collection,
                       Editor<T> editor)
```
    过滤
    过滤过程通过传入的Editor实现来返回需要的元素内容，这个Editor实现可以实现以下功能：
```
 1、过滤出需要的对象，如果返回null表示这个元素对象抛弃
 2、修改元素对象，返回集合中为修改后的对象
 
```
    类型参数:
    T - 集合元素类型
    参数:
    collection - 集合
    editor - 编辑器接口
    
    返回:
    过滤后的集合
  - filter
```
public static <T> List<T> filter(List<T> list,
                 Editor<T> editor)
```
    过滤
    过滤过程通过传入的Editor实现来返回需要的元素内容，这个Editor实现可以实现以下功能：
```
 1、过滤出需要的对象，如果返回null表示这个元素对象抛弃
 2、修改元素对象，返回集合中为修改后的对象
 
```
    类型参数:
    T - 集合元素类型
    参数:
    list - 集合
    editor - 编辑器接口
    
    返回:
    过滤后的数组
    从以下版本开始:
    
    4.1.8
  - filter
```
public static <T> Collection<T> filter(Collection<T> collection,
                       Filter<T> filter)
```
    过滤
    过滤过程通过传入的Filter实现来过滤返回需要的元素内容，这个Filter实现可以实现以下功能：
```
 1、过滤出需要的对象，Filter.accept(Object)方法返回true的对象将被加入结果集合中
 
```
    类型参数:
    T - 集合元素类型
    参数:
    collection - 集合
    filter - 过滤器
    
    返回:
    过滤后的数组
    从以下版本开始:
    
    3.1.0
  - filter
```
public static <T> List<T> filter(List<T> list,
                 Filter<T> filter)
```
    过滤
    过滤过程通过传入的Filter实现来过滤返回需要的元素内容，这个Filter实现可以实现以下功能：
```
 1、过滤出需要的对象，Filter.accept(Object)方法返回true的对象将被加入结果集合中
 
```
    类型参数:
    T - 集合元素类型
    参数:
    list - 集合
    filter - 过滤器
    
    返回:
    过滤后的数组
    从以下版本开始:
    
    4.1.8
  - removeNull
```
public static <T> Collection<T> removeNull(Collection<T> collection)
```
    去除null 元素
    
    参数:
    collection - 集合
    
    返回:
    处理后的集合
    从以下版本开始:
    
    3.2.2
  - removeAny
```
public static <T> Collection<T> removeAny(Collection<T> collection,
                          T... elesRemoved)
```
    去掉集合中的多个元素
    
    参数:
    collection - 集合
    elesRemoved - 被去掉的元素数组
    
    返回:
    原集合
    从以下版本开始:
    
    4.1.0
  - removeEmpty
```
public static <T extends CharSequence> Collection<T> removeEmpty(Collection<T> collection)
```
    去除null或者"" 元素
    
    参数:
    collection - 集合
    
    返回:
    处理后的集合
    从以下版本开始:
    
    3.2.2
  - removeBlank
```
public static <T extends CharSequence> Collection<T> removeBlank(Collection<T> collection)
```
    去除null或者""或者空白字符串元素
    
    参数:
    collection - 集合
    
    返回:
    处理后的集合
    从以下版本开始:
    
    3.2.2
  - extract
```
public static List<Object> extract(Iterable<?> collection,
                   Editor<Object> editor)
```
    通过Editor抽取集合元素中的某些值返回为新列表
    例如提供的是一个Bean列表，通过Editor接口实现获取某个字段值，返回这个字段值组成的新列表
    
    参数:
    collection - 原集合
    editor - 编辑器
    
    返回:
    抽取后的新列表
  - extract
```
public static List<Object> extract(Iterable<?> collection,
                   Editor<Object> editor,
                   boolean ignoreNull)
```
    通过Editor抽取集合元素中的某些值返回为新列表
    例如提供的是一个Bean列表，通过Editor接口实现获取某个字段值，返回这个字段值组成的新列表
    
    参数:
    collection - 原集合
    editor - 编辑器
    ignoreNull - 是否忽略空值
    
    返回:
    抽取后的新列表
    从以下版本开始:
    
    4.5.7
  - getFieldValues
```
public static List<Object> getFieldValues(Iterable<?> collection,
                          String fieldName)
```
    获取给定Bean列表中指定字段名对应字段值的列表
    列表元素支持Bean与Map
    
    参数:
    collection - Bean集合或Map集合
    fieldName - 字段名或map的键
    
    返回:
    字段值列表
    从以下版本开始:
    
    3.1.0
  - getFieldValues
```
public static List<Object> getFieldValues(Iterable<?> collection,
                          String fieldName,
                          boolean ignoreNull)
```
    获取给定Bean列表中指定字段名对应字段值的列表
    列表元素支持Bean与Map
    
    参数:
    collection - Bean集合或Map集合
    fieldName - 字段名或map的键
    ignoreNull - 是否忽略值为null的字段
    
    返回:
    字段值列表
    从以下版本开始:
    
    4.5.7
  - getFieldValues
```
public static <T> List<T> getFieldValues(Iterable<?> collection,
                         String fieldName,
                         Class<T> elementType)
```
    获取给定Bean列表中指定字段名对应字段值的列表
    列表元素支持Bean与Map
    
    类型参数:
    T - 元素类型
    参数:
    collection - Bean集合或Map集合
    fieldName - 字段名或map的键
    elementType - 元素类型类
    
    返回:
    字段值列表
    从以下版本开始:
    
    4.5.6
  - findOne
```
public static <T> T findOne(Iterable<T> collection,
            Filter<T> filter)
```
    查找第一个匹配元素对象
    
    类型参数:
    T - 集合元素类型
    参数:
    collection - 集合
    filter - 过滤器，满足过滤条件的第一个元素将被返回
    
    返回:
    满足过滤条件的第一个元素
    从以下版本开始:
    
    3.1.0
  - findOneByField
```
public static <T> T findOneByField(Iterable<T> collection,
                   String fieldName,
                   Object fieldValue)
```
    查找第一个匹配元素对象
    如果集合元素是Map，则比对键和值是否相同，相同则返回
    如果为普通Bean，则通过反射比对元素字段名对应的字段值是否相同，相同则返回
    如果给定字段值参数是null 且元素对象中的字段值也为null则认为相同
    
    类型参数:
    T - 集合元素类型
    参数:
    collection - 集合，集合元素可以是Bean或者Map
    fieldName - 集合元素对象的字段名或map的键
    fieldValue - 集合元素对象的字段值或map的值
    
    返回:
    满足条件的第一个元素
    从以下版本开始:
    
    3.1.0
  - filter
```
public static <K,V> Map<K,V> filter(Map<K,V> map,
                    Editor<Map.Entry<K,V>> editor)
```
    过滤
    过滤过程通过传入的Editor实现来返回需要的元素内容，这个Editor实现可以实现以下功能：
```
 1、过滤出需要的对象，如果返回null表示这个元素对象抛弃
 2、修改元素对象，返回集合中为修改后的对象
 
```
    类型参数:
    K - Key类型
    V - Value类型
    参数:
    map - Map
    editor - 编辑器接口
    
    返回:
    过滤后的Map
    另请参阅:
    MapUtil.filter(Map, Editor)
  - filter
```
public static <K,V> Map<K,V> filter(Map<K,V> map,
                    Filter<Map.Entry<K,V>> filter)
```
    过滤
    过滤过程通过传入的Editor实现来返回需要的元素内容，这个Editor实现可以实现以下功能：
```
 1、过滤出需要的对象，如果返回null表示这个元素对象抛弃
 2、修改元素对象，返回集合中为修改后的对象
 
```
    类型参数:
    K - Key类型
    V - Value类型
    参数:
    map - Map
    filter - 编辑器接口
    
    返回:
    过滤后的Map
    从以下版本开始:
    
    3.1.0
    
    另请参阅:
    MapUtil.filter(Map, Filter)
  - count
```
public static <T> int count(Iterable<T> iterable,
            Matcher<T> matcher)
```
    集合中匹配规则的数量
    
    类型参数:
    T - 集合元素类型
    参数:
    iterable - Iterable
    matcher - 匹配器，为空则全部匹配
    
    返回:
    匹配数量
  - isEmpty
```
public static boolean isEmpty(Collection<?> collection)
```
    集合是否为空
    
    参数:
    collection - 集合
    
    返回:
    是否为空
  - isEmpty
```
public static boolean isEmpty(Map<?,?> map)
```
    Map是否为空
    
    参数:
    map - 集合
    
    返回:
    是否为空
    另请参阅:
    MapUtil.isEmpty(Map)
  - isEmpty
```
public static boolean isEmpty(Iterable<?> iterable)
```
    Iterable是否为空
    
    参数:
    iterable - Iterable对象
    
    返回:
    是否为空
    另请参阅:
    IterUtil.isEmpty(Iterable)
  - isEmpty
```
public static boolean isEmpty(Iterator<?> Iterator)
```
    Iterator是否为空
    
    参数:
    Iterator - Iterator对象
    
    返回:
    是否为空
    另请参阅:
    IterUtil.isEmpty(Iterator)
  - isEmpty
```
public static boolean isEmpty(Enumeration<?> enumeration)
```
    Enumeration是否为空
    
    参数:
    enumeration - Enumeration
    
    返回:
    是否为空
  - isNotEmpty
```
public static boolean isNotEmpty(Collection<?> collection)
```
    集合是否为非空
    
    参数:
    collection - 集合
    
    返回:
    是否为非空
  - isNotEmpty
```
public static boolean isNotEmpty(Map<?,?> map)
```
    Map是否为非空
    
    参数:
    map - 集合
    
    返回:
    是否为非空
    另请参阅:
    MapUtil.isNotEmpty(Map)
  - isNotEmpty
```
public static boolean isNotEmpty(Iterable<?> iterable)
```
    Iterable是否为空
    
    参数:
    iterable - Iterable对象
    
    返回:
    是否为空
    另请参阅:
    IterUtil.isNotEmpty(Iterable)
  - isNotEmpty
```
public static boolean isNotEmpty(Iterator<?> Iterator)
```
    Iterator是否为空
    
    参数:
    Iterator - Iterator对象
    
    返回:
    是否为空
    另请参阅:
    IterUtil.isNotEmpty(Iterator)
  - isNotEmpty
```
public static boolean isNotEmpty(Enumeration<?> enumeration)
```
    Enumeration是否为空
    
    参数:
    enumeration - Enumeration
    
    返回:
    是否为空
  - hasNull
```
public static boolean hasNull(Iterable<?> iterable)
```
    是否包含null元素
    
    参数:
    iterable - 被检查的Iterable对象，如果为null 返回false
    
    返回:
    是否包含null元素
    从以下版本开始:
    
    3.0.7
    
    另请参阅:
    IterUtil.hasNull(Iterable)
  - zip
```
public static Map<String,String> zip(String keys,
                     String values,
                     String delimiter,
                     boolean isOrder)
```
    映射键值（参考Python的zip()函数）
    例如：
    keys = a,b,c,d
    values = 1,2,3,4
    delimiter = , 则得到的Map是 {a=1, b=2, c=3, d=4}
    如果两个数组长度不同，则只对应最短部分
    
    参数:
    keys - 键列表
    values - 值列表
    delimiter - 分隔符
    isOrder - 是否有序
    
    返回:
    Map
    从以下版本开始:
    
    3.0.4
  - zip
```
public static Map<String,String> zip(String keys,
                     String values,
                     String delimiter)
```
    映射键值（参考Python的zip()函数），返回Map无序
    例如：
    keys = a,b,c,d
    values = 1,2,3,4
    delimiter = , 则得到的Map是 {a=1, b=2, c=3, d=4}
    如果两个数组长度不同，则只对应最短部分
    
    参数:
    keys - 键列表
    values - 值列表
    delimiter - 分隔符
    
    返回:
    Map
  - zip
```
public static <K,V> Map<K,V> zip(Collection<K> keys,
                 Collection<V> values)
```
    映射键值（参考Python的zip()函数）
    例如：
    keys = [a,b,c,d]
    values = [1,2,3,4]
    则得到的Map是 {a=1, b=2, c=3, d=4}
    如果两个数组长度不同，则只对应最短部分
    
    类型参数:
    K - 键类型
    V - 值类型
    参数:
    keys - 键列表
    values - 值列表
    
    返回:
    Map
  - toMap
```
public static <K,V> HashMap<K,V> toMap(Iterable<Map.Entry<K,V>> entryIter)
```
    将Entry集合转换为HashMap
    
    类型参数:
    K - 键类型
    V - 值类型
    参数:
    entryIter - entry集合
    
    返回:
    Map
    另请参阅:
    IterUtil.toMap(Iterable)
  - toMap
```
public static HashMap<Object,Object> toMap(Object[] array)
```
    将数组转换为Map（HashMap），支持数组元素类型为：
```
 Map.Entry
 长度大于1的数组（取前两个值），如果不满足跳过此元素
 Iterable 长度也必须大于1（取前两个值），如果不满足跳过此元素
 Iterator 长度也必须大于1（取前两个值），如果不满足跳过此元素
 
```
```
 Map<Object, Object> colorMap = CollectionUtil.toMap(new String[][] {{
     {"RED", "#FF0000"},
     {"GREEN", "#00FF00"},
     {"BLUE", "#0000FF"}});
 
```
    参考：commons-lang
    参数:
    array - 数组。元素类型为Map.Entry、数组、Iterable、Iterator
    
    返回:
    HashMap
    从以下版本开始:
    
    3.0.8
    
    另请参阅:
    MapUtil.of(Object[])
  - toTreeSet
```
public static <T> TreeSet<T> toTreeSet(Collection<T> collection,
                       Comparator<T> comparator)
```
    将集合转换为排序后的TreeSet
    
    类型参数:
    T - 集合元素类型
    参数:
    collection - 集合
    comparator - 比较器
    
    返回:
    treeSet
  - asEnumeration
```
public static <E> Enumeration<E> asEnumeration(Iterator<E> iter)
```
    Iterator转换为Enumeration
    Adapt the specified Iterator to the Enumeration interface.
    
    类型参数:
    E - 集合元素类型
    参数:
    iter - Iterator
    
    返回:
    Enumeration
  - asIterator
```
public static <E> Iterator<E> asIterator(Enumeration<E> e)
```
    Enumeration转换为Iterator
    Adapt the specified Enumeration to the Iterator interface
    
    类型参数:
    E - 集合元素类型
    参数:
    e - Enumeration
    
    返回:
    Iterator
    另请参阅:
    IterUtil.asIterator(Enumeration)
  - asIterable
```
public static <E> Iterable<E> asIterable(Iterator<E> iter)
```
    Iterator 转为 Iterable
    
    类型参数:
    E - 元素类型
    参数:
    iter - Iterator
    
    返回:
    Iterable
    另请参阅:
    IterUtil.asIterable(Iterator)
  - toCollection
```
public static <E> Collection<E> toCollection(Iterable<E> iterable)
```
    Iterable转为Collection
    首先尝试强转，强转失败则构建一个新的ArrayList
    
    类型参数:
    E - 集合元素类型
    参数:
    iterable - Iterable
    
    返回:
    Collection 或者 ArrayList
    从以下版本开始:
    
    3.0.9
  - toListMap
```
public static <K,V> Map<K,List<V>> toListMap(Iterable<? extends Map<K,V>> mapList)
```
    行转列，合并相同的键，值合并为列表
    将Map列表中相同key的值组成列表做为Map的value
    是toMapList(Map)的逆方法
    比如传入数据：
```
 [
  {a: 1, b: 1, c: 1}
  {a: 2, b: 2}
  {a: 3, b: 3}
  {a: 4}
 ]
 
```
    结果是：
```
 {
   a: [1,2,3,4]
   b: [1,2,3,]
   c: [1]
 }
 
```
    类型参数:
    K - 键类型
    V - 值类型
    参数:
    mapList - Map列表
    
    返回:
    Map
    另请参阅:
    MapUtil.toListMap(Iterable)
  - toMapList
```
public static <K,V> List<Map<K,V>> toMapList(Map<K,? extends Iterable<V>> listMap)
```
    列转行。将Map中值列表分别按照其位置与key组成新的map。
    是toListMap(Iterable)的逆方法
    比如传入数据：
```
 {
   a: [1,2,3,4]
   b: [1,2,3,]
   c: [1]
 }
 
```
    结果是：
```
 [
  {a: 1, b: 1, c: 1}
  {a: 2, b: 2}
  {a: 3, b: 3}
  {a: 4}
 ]
 
```
    类型参数:
    K - 键类型
    V - 值类型
    参数:
    listMap - 列表Map
    
    返回:
    Map列表
    另请参阅:
    MapUtil.toMapList(Map)
  - addAll
```
public static <T> Collection<T> addAll(Collection<T> collection,
                       Object value)
```
    将指定对象全部加入到集合中
    提供的对象如果为集合类型，会自动转换为目标元素类型
    
    类型参数:
    T - 元素类型
    参数:
    collection - 被加入的集合
    value - 对象，可能为Iterator、Iterable、Enumeration、Array
    
    返回:
    被加入集合
  - addAll
```
public static <T> Collection<T> addAll(Collection<T> collection,
                       Object value,
                       Type elementType)
```
    将指定对象全部加入到集合中
    提供的对象如果为集合类型，会自动转换为目标元素类型
    
    类型参数:
    T - 元素类型
    参数:
    collection - 被加入的集合
    value - 对象，可能为Iterator、Iterable、Enumeration、Array，或者与集合元素类型一致
    elementType - 元素类型，为空时，使用Object类型来接纳所有类型
    
    返回:
    被加入集合
  - addAll
```
public static <T> Collection<T> addAll(Collection<T> collection,
                       Iterator<T> iterator)
```
    加入全部
    
    类型参数:
    T - 集合元素类型
    参数:
    collection - 被加入的集合 Collection
    iterator - 要加入的Iterator
    
    返回:
    原集合
  - addAll
```
public static <T> Collection<T> addAll(Collection<T> collection,
                       Iterable<T> iterable)
```
    加入全部
    
    类型参数:
    T - 集合元素类型
    参数:
    collection - 被加入的集合 Collection
    iterable - 要加入的内容Iterable
    
    返回:
    原集合
  - addAll
```
public static <T> Collection<T> addAll(Collection<T> collection,
                       Enumeration<T> enumeration)
```
    加入全部
    
    类型参数:
    T - 集合元素类型
    参数:
    collection - 被加入的集合 Collection
    enumeration - 要加入的内容Enumeration
    
    返回:
    原集合
  - addAll
```
public static <T> Collection<T> addAll(Collection<T> collection,
                       T[] values)
```
    加入全部
    
    类型参数:
    T - 集合元素类型
    参数:
    collection - 被加入的集合 Collection
    values - 要加入的内容数组
    
    返回:
    原集合
    从以下版本开始:
    
    3.0.8
  - addAllIfNotContains
```
public static <T> List<T> addAllIfNotContains(List<T> list,
                              List<T> otherList)
```
    将另一个列表中的元素加入到列表中，如果列表中已经存在此元素则忽略之
    
    类型参数:
    T - 集合元素类型
    参数:
    list - 列表
    otherList - 其它列表
    
    返回:
    此列表
  - get
```
public static <T> T get(Collection<T> collection,
        int index)
```
    获取集合中指定下标的元素值，下标可以为负数，例如-1表示最后一个元素
    如果元素越界，返回null
    
    类型参数:
    T - 元素类型
    参数:
    collection - 集合
    index - 下标，支持负数
    
    返回:
    元素值
    从以下版本开始:
    
    4.0.6
  - getAny
```
public static <T> List<T> getAny(Collection<T> collection,
                 int... indexes)
```
    获取集合中指定多个下标的元素值，下标可以为负数，例如-1表示最后一个元素
    
    类型参数:
    T - 元素类型
    参数:
    collection - 集合
    indexes - 下标，支持负数
    
    返回:
    元素值列表
    从以下版本开始:
    
    4.0.6
  - getFirst
```
public static <T> T getFirst(Iterable<T> iterable)
```
    获取集合的第一个元素
    
    类型参数:
    T - 集合元素类型
    参数:
    iterable - Iterable
    
    返回:
    第一个元素
    从以下版本开始:
    
    3.0.1
    
    另请参阅:
    IterUtil.getFirst(Iterable)
  - getFirst
```
public static <T> T getFirst(Iterator<T> iterator)
```
    获取集合的第一个元素
    
    类型参数:
    T - 集合元素类型
    参数:
    iterator - Iterator
    
    返回:
    第一个元素
    从以下版本开始:
    
    3.0.1
    
    另请参阅:
    IterUtil.getFirst(Iterator)
  - getLast
```
public static <T> T getLast(Collection<T> collection)
```
    获取集合的最后一个元素
    
    类型参数:
    T - 集合元素类型
    参数:
    collection - Collection
    
    返回:
    最后一个元素
    从以下版本开始:
    
    4.1.10
  - getElementType
```
public static Class<?> getElementType(Iterable<?> iterable)
```
    获得Iterable对象的元素类型（通过第一个非空元素判断）
    
    参数:
    iterable - Iterable
    
    返回:
    元素类型，当列表为空或元素全部为null时，返回null
    从以下版本开始:
    
    3.0.8
    
    另请参阅:
    IterUtil.getElementType(Iterable)
  - getElementType
```
public static Class<?> getElementType(Iterator<?> iterator)
```
    获得Iterator对象的元素类型（通过第一个非空元素判断）
    
    参数:
    iterator - Iterator
    
    返回:
    元素类型，当列表为空或元素全部为null时，返回null
    从以下版本开始:
    
    3.0.8
    
    另请参阅:
    IterUtil.getElementType(Iterator)
  - valuesOfKeys
```
public static <K,V> ArrayList<V> valuesOfKeys(Map<K,V> map,
                              K... keys)
```
    从Map中获取指定键列表对应的值列表
    如果key在map中不存在或key对应值为null，则返回值列表对应位置的值也为null
    
    类型参数:
    K - 键类型
    V - 值类型
    参数:
    map - Map
    keys - 键列表
    
    返回:
    值列表
    从以下版本开始:
    
    3.0.8
  - valuesOfKeys
```
public static <K,V> ArrayList<V> valuesOfKeys(Map<K,V> map,
                              Iterable<K> keys)
```
    从Map中获取指定键列表对应的值列表
    如果key在map中不存在或key对应值为null，则返回值列表对应位置的值也为null
    
    类型参数:
    K - 键类型
    V - 值类型
    参数:
    map - Map
    keys - 键列表
    
    返回:
    值列表
    从以下版本开始:
    
    3.0.9
  - valuesOfKeys
```
public static <K,V> ArrayList<V> valuesOfKeys(Map<K,V> map,
                              Iterator<K> keys)
```
    从Map中获取指定键列表对应的值列表
    如果key在map中不存在或key对应值为null，则返回值列表对应位置的值也为null
    
    类型参数:
    K - 键类型
    V - 值类型
    参数:
    map - Map
    keys - 键列表
    
    返回:
    值列表
    从以下版本开始:
    
    3.0.9
  - sortPageAll
```
@SafeVarargs
public static <T> List<T> sortPageAll(int pageNo,
                                  int pageSize,
                                  Comparator<T> comparator,
                                  Collection<T>... colls)
```
    将多个集合排序并显示不同的段落（分页）
    采用BoundedPriorityQueue实现分页取局部
    
    类型参数:
    T - 集合元素类型
    参数:
    pageNo - 页码，从1开始计数，0和1效果相同
    pageSize - 每页的条目数
    comparator - 比较器
    colls - 集合数组
    
    返回:
    分页后的段落内容
  - page
```
public static <T> List<T> page(int pageNo,
               int pageSize,
               List<T> list)
```
    对指定List分页取值
    
    类型参数:
    T - 集合元素类型
    参数:
    pageNo - 页码，从1开始计数，0和1效果相同
    pageSize - 每页的条目数
    list - 列表
    
    返回:
    分页后的段落内容
    从以下版本开始:
    
    4.1.20
  - sort
```
public static <T> List<T> sort(Collection<T> collection,
               Comparator<? super T> comparator)
```
    排序集合，排序不会修改原集合
    
    类型参数:
    T - 集合元素类型
    参数:
    collection - 集合
    comparator - 比较器
    
    返回:
    treeSet
  - sort
```
public static <T> List<T> sort(List<T> list,
               Comparator<? super T> c)
```
    针对List排序，排序会修改原List
    
    类型参数:
    T - 元素类型
    参数:
    list - 被排序的List
    c - Comparator
    
    返回:
    原list
    另请参阅:
    Collections.sort(List, Comparator)
  - sortByProperty
```
public static <T> List<T> sortByProperty(Collection<T> collection,
                         String property)
```
    根据Bean的属性排序
    
    类型参数:
    T - 元素类型
    参数:
    collection - 集合，会被转换为List
    property - 属性名
    
    返回:
    排序后的List
    从以下版本开始:
    
    4.0.6
  - sortByProperty
```
public static <T> List<T> sortByProperty(List<T> list,
                         String property)
```
    根据Bean的属性排序
    
    类型参数:
    T - 元素类型
    参数:
    list - List
    property - 属性名
    
    返回:
    排序后的List
    从以下版本开始:
    
    4.0.6
  - sortByPinyin
```
public static <T> List<String> sortByPinyin(Collection<String> collection)
```
    根据汉字的拼音顺序排序
    
    参数:
    collection - 集合，会被转换为List
    
    返回:
    排序后的List
    从以下版本开始:
    
    4.0.8
  - sortByPinyin
```
public static <T> List<String> sortByPinyin(List<String> list)
```
    根据汉字的拼音顺序排序
    
    参数:
    list - List
    
    返回:
    排序后的List
    从以下版本开始:
    
    4.0.8
  - sort
```
public static <K,V> TreeMap<K,V> sort(Map<K,V> map,
                      Comparator<? super K> comparator)
```
    排序Map
    
    类型参数:
    K - 键类型
    V - 值类型
    参数:
    map - Map
    comparator - Entry比较器
    
    返回:
    TreeMap
    从以下版本开始:
    
    3.0.9
  - sortToMap
```
public static <K,V> LinkedHashMap<K,V> sortToMap(Collection<Map.Entry<K,V>> entryCollection,
                                 Comparator<Map.Entry<K,V>> comparator)
```
    通过Entry排序，可以按照键排序，也可以按照值排序，亦或者两者综合排序
    
    类型参数:
    K - 键类型
    V - 值类型
    参数:
    entryCollection - Entry集合
    comparator - Comparator
    
    返回:
    LinkedList
    从以下版本开始:
    
    3.0.9
  - sortByEntry
```
public static <K,V> LinkedHashMap<K,V> sortByEntry(Map<K,V> map,
                                   Comparator<Map.Entry<K,V>> comparator)
```
    通过Entry排序，可以按照键排序，也可以按照值排序，亦或者两者综合排序
    
    类型参数:
    K - 键类型
    V - 值类型
    参数:
    map - 被排序的Map
    comparator - Comparator
    
    返回:
    LinkedList
    从以下版本开始:
    
    3.0.9
  - sortEntryToList
```
public static <K,V> List<Map.Entry<K,V>> sortEntryToList(Collection<Map.Entry<K,V>> collection)
```
    将Set排序（根据Entry的值）
    
    类型参数:
    K - 键类型
    V - 值类型
    参数:
    collection - 被排序的Collection
    
    返回:
    排序后的Set
  - forEach
```
public static <T> void forEach(Iterator<T> iterator,
               CollUtil.Consumer<T> consumer)
```
    循环遍历 Iterator，使用CollUtil.Consumer 接受遍历的每条数据，并针对每条数据做处理
    
    类型参数:
    T - 集合元素类型
    参数:
    iterator - Iterator
    consumer - CollUtil.Consumer 遍历的每条数据处理器
  - forEach
```
public static <T> void forEach(Enumeration<T> enumeration,
               CollUtil.Consumer<T> consumer)
```
    循环遍历 Enumeration，使用CollUtil.Consumer 接受遍历的每条数据，并针对每条数据做处理
    
    类型参数:
    T - 集合元素类型
    参数:
    enumeration - Enumeration
    consumer - CollUtil.Consumer 遍历的每条数据处理器
  - forEach
```
public static <K,V> void forEach(Map<K,V> map,
                 CollUtil.KVConsumer<K,V> kvConsumer)
```
    循环遍历Map，使用CollUtil.KVConsumer 接受遍历的每条数据，并针对每条数据做处理
    
    类型参数:
    K - Key类型
    V - Value类型
    参数:
    map - Map
    kvConsumer - CollUtil.KVConsumer 遍历的每条数据处理器
  - group
```
public static <T> List<List<T>> group(Collection<T> collection,
                      CollUtil.Hash<T> hash)
```
    分组，按照CollUtil.Hash接口定义的hash算法，集合中的元素放入hash值对应的子列表中
    
    类型参数:
    T - 元素类型
    参数:
    collection - 被分组的集合
    hash - Hash值算法，决定元素放在第几个分组的规则
    
    返回:
    分组后的集合
  - groupByField
```
public static <T> List<List<T>> groupByField(Collection<T> collection,
                             String fieldName)
```
    根据元素的指定字段名分组，非Bean都放在第一个分组中
    
    类型参数:
    T - 元素类型
    参数:
    collection - 集合
    fieldName - 元素Bean中的字段名，非Bean都放在第一个分组中
    
    返回:
    分组列表
  - reverse
```
public static <T> List<T> reverse(List<T> list)
```
    反序给定List，会在原List基础上直接修改
    
    类型参数:
    T - 元素类型
    参数:
    list - 被反转的List
    
    返回:
    反转后的List
    从以下版本开始:
    
    4.0.6
  - reverseNew
```
public static <T> List<T> reverseNew(List<T> list)
```
    反序给定List，会创建一个新的List，原List数据不变
    
    类型参数:
    T - 元素类型
    参数:
    list - 被反转的List
    
    返回:
    反转后的List
    从以下版本开始:
    
    4.0.6
  - setOrAppend
```
public static <T> List<T> setOrAppend(List<T> list,
                      int index,
                      T element)
```
    设置或增加元素。当index小于List的长度时，替换指定位置的值，否则在尾部追加
    
    参数:
    list - List列表
    index - 位置
    element - 新元素
    
    返回:
    原List
    从以下版本开始:
    
    4.1.2
  - keySet
```
public static <K> Set<K> keySet(Collection<Map<K,?>> mapCollection)
```
    获取指定Map列表中所有的Key
    
    类型参数:
    K - 键类型
    参数:
    mapCollection - Map列表
    
    返回:
    key集合
    从以下版本开始:
    
    4.5.12
  - values
```
public static <V> List<V> values(Collection<Map<?,V>> mapCollection)
```
    获取指定Map列表中所有的Value
    
    类型参数:
    V - 值类型
    参数:
    mapCollection - Map列表
    
    返回:
    Value集合
    从以下版本开始:
    
    4.5.12

类 CollUtil

嵌套类概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

CollUtil

方法详细资料

union

union

intersection

intersection

disjunction

contains

containsAny

containsAll

countMap

join

join

popPart

popPart

newHashMap

newHashMap

newHashMap

newHashSet

newLinkedHashSet

newHashSet

newHashSet

newHashSet

newHashSet

newHashSet

list

list

list

list

list

list

newArrayList

toList

newArrayList

newArrayList

newArrayList

newArrayList

newLinkedList

newCopyOnWriteArrayList

newBlockingQueue

create

createMap

distinct

sub

sub

sub

sub

split

filter

filter

filter

filter

removeNull

removeAny

removeEmpty

removeBlank

extract

extract

getFieldValues

getFieldValues

getFieldValues

findOne

findOneByField

filter

filter

count

isEmpty

isEmpty

isEmpty

isEmpty

isEmpty

isNotEmpty

isNotEmpty

isNotEmpty