CollectionUtil (heaven 0.13.0 API)

java.lang.Object
- com.github.houbb.heaven.util.util.CollectionUtil

```
public final class CollectionUtil
extends Object
```
集合工具类

从以下版本开始:

0.0.1

作者:

bbhou

字段概要

字段
限定符和类型字段和说明

static List EMPTY_LIST
空列表

字段
限定符和类型	字段和说明
`static List`	`EMPTY_LIST` 空列表

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static <T> void`	`addAll(Collection<T> collection, Collection<T> addCollection)` 添加所有的元素
`static <T> void`	`addArray(Collection<T> collection, T[] array)` 将数组的内容添加到集合
`static <T> List<T>`	`append(List<T> list, T t)` 添加元素到列表
`static List<String>`	`arrayToList(String[] array)` 根据数组返回对应列表
`static <T,R> Collection<R>`	`buildCollection(Collection<T> targets, IHandler<T,R> handler)` 构建结果集合 1.
`static <T,R> List<R>`	`buildCollection(T[] targets, IHandler<T,R> handler)` 构建结果集合 1.
`static <T> List<T>`	`conditionList(Collection<T> list, ICondition<T> condition)` 执行列表过滤
`static boolean`	`containAny(Collection<String> firstList, Collection<String> secondList)` 包含任何一个
`static boolean`	`contains(Collection<?> collection, Object value)` 是否包含
`static <T> List<T>`	`copy(List<T> list)` 复制列表
`static <E> List<E>`	`difference(Collection<E> collectionOne, Collection<E> collectionTwo)` 集合的差集
`static <T> List<T>`	`distinct(Collection<T> collection)` 去重集合
`static <T extends Comparable> List<T>`	`distinctAndSort(Collection<T> collection)` 去重并且排序
`static List<Integer>`	`fill(int size)` 填充信息
`static <E> List<E>`	`fill(int size, E elem)` 填充信息
`static List<Integer>`	`fill(int size, int initValue)` 填充信息
`static <E> List<E>`	`fillList(List<E> values, IFiller<E> filler)` 遍历填充对象
`static <T> List<T>`	`filterList(Collection<T> list, IFilter<T> filter)` 执行列表过滤
`static <T> Optional<T>`	`firstNotNullElem(Collection<T> list)` 找到第一个不为 null 的元素
`static <E> void`	`foreach(Collection<E> collection, IHandler<E,Void> handler)` 循环处理集合
`static <E> void`	`foreachPrint(Collection<E> collection)` 循环处理集合
`static int`	`getEndIndex(int endIndex, Collection<?> collection)` 获取开始的下标（1）默认为0 （2）如果为负数，或者超过 arrays.length-1，则使用 arrays.length-1 （3）正常返回 endIndex
`static <E> E`	`getFirst(Collection<E> collection)` 获取第一个元素 1.
`static String`	`getLast(List<String> resultList)` 获取最后一行
`static <T extends Comparable> List<T>`	`getRepeatList(Collection<T> collection)` 获取重复列表
`static int`	`getStartIndex(int startIndex, Collection<?> collection)` 获取开始的下标（1）默认为0 （2）如果为负数，或者超过 arrays.length-1，则使用 0 （3）正常返回 startIndex
`static <T> List<T>`	`getTopK(Collection<T> collection, int size)` 获取指定的前几个元素
`static <T> T`	`head(List<T> list)` 获取第一个元素
`static <E> List<E>`	`interSection(Collection<E> collectionOne, Collection<E> collectionTwo)` 集合的差交集
`static boolean`	`isEmpty(Collection collection)` 是否为空
`static boolean`	`isNotEmpty(Collection collection)` 是否不为空
`static String`	`join(Collection<?> stringCollection)` 将字符串集合内容按照逗号连接起来
`static String`	`join(Collection<?> stringCollection, String connector)` 将字符串集合内容按照 connector 连接起来
`static <T> List<T>`	`list()` 空列表
`static <T> List<T>`	`list(T... ts)` 列表
`static <T> List<T>`	`list(T t)` 空列表
`static String[]`	`listToArray(List<String> stringList)` 列表转数组
`static <T> List<T>`	`pageList(Collection<T> collection, int pageNum, int pageSize)` 内存分页 ps: 类似 mysql 的分页模式，性能越往后越差。
`static <T> List<T>`	`pageList(List<T> list, int pageNum, int pageSize)` 内存分页
`static <T> T`	`random(Collection<T> collection)` 随机一个元素 loop 实现，性能比较差
`static <E> E`	`random(List<E> list)` 随机获取一个元素
`static List<String>`	`replaceAll(Collection<String> collection, String regex, String target)` 针对整个集合做替换处理
`static <T> List<T>`	`reverse(List<T> list, T t)` 反转列表
`static void`	`setLast(List<String> resultList, String line)` 设置最后一行
`static <T extends Comparable> List<T>`	`sort(List<T> collection)` 排序
`static List<String>`	`splitByAnyBlank(String string)` 按照任意空格拆分
`static <E> List<E>`	`subList(List<E> list, int offset, int limit)` 对原始列表进行截取
`static <T> T`	`tail(List<T> list)` 获取最后一个元素
`static <K,V> List<K>`	`toList(Iterable<V> values, IHandler<? super V,K> keyFunction)` 可遍历的元素对象的某个元素，转换为列表
`static <K,V> List<K>`	`toList(Iterator<V> values, IHandler<? super V,K> keyFunction)` 可遍历的元素对象的某个元素，转换为列表
`static List<String>`	`toStringList(List<?> pathList)` 对象列表转换为 toString 列表 1.
`static List<String>`	`trimCollection(Collection<String> stringList)` 对字符串列表每条字符串执行trim()操作。
`static <E> List<E>`	`union(Collection<E> collectionOne, Collection<E> collectionTwo)` 集合的并集

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

- 字段详细资料
  - EMPTY_LIST
```
public static final List EMPTY_LIST
```
    空列表
- 方法详细资料
  - isEmpty
```
public static boolean isEmpty(Collection collection)
```
    是否为空
    
    参数:
    
    collection - 集合
    
    返回:
    
    true 是
  - isNotEmpty
```
public static boolean isNotEmpty(Collection collection)
```
    是否不为空
    
    参数:
    
    collection - 集合
    
    返回:
    
    true 是
    
    从以下版本开始:
    
    1.1.2
  - arrayToList
```
public static List<String> arrayToList(String[] array)
```
    根据数组返回对应列表
    
    参数:
    
    array - string array
    
    返回:
    
    string list
  - listToArray
```
public static String[] listToArray(List<String> stringList)
```
    列表转数组
    
    参数:
    
    stringList - string list
    
    返回:
    
    string array
  - trimCollection
```
public static List<String> trimCollection(Collection<String> stringList)
```
    对字符串列表每条字符串执行trim()操作。 1. 空直接返回空列表
    
    参数:
    
    stringList - 原始的列表
    
    返回:
    
    trim 的字符串列表
    
    从以下版本开始:
    
    0.1.70
  - buildCollection
```
public static <T,R> Collection<R> buildCollection(Collection<T> targets,
                                                  IHandler<T,R> handler)
```
    构建结果集合 1. 如果转换的结果为 null，会被跳过。
    
    类型参数:
    
    T - 入参
    
    R - 出参
    
    参数:
    
    targets - 原始信息
    
    handler - 处理接口
    
    返回:
    
    结果
  - buildCollection
```
public static <T,R> List<R> buildCollection(T[] targets,
                                            IHandler<T,R> handler)
```
    构建结果集合 1. 如果转换的结果为 null，会被跳过。
    
    类型参数:
    
    T - 入参
    
    R - 出参
    
    参数:
    
    targets - 原始信息
    
    handler - 处理接口
    
    返回:
    
    结果
    
    从以下版本开始:
    
    0.0.2
  - addArray
```
public static <T> void addArray(Collection<T> collection,
                                T[] array)
```
    将数组的内容添加到集合
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    collection - 集合
    
    array - 数组
  - toList
```
public static <K,V> List<K> toList(Iterable<V> values,
                                   IHandler<? super V,K> keyFunction)
```
    可遍历的元素对象的某个元素，转换为列表
    
    类型参数:
    
    K - k 泛型
    
    V - v 泛型
    
    参数:
    
    values - 遍历对象
    
    keyFunction - 转换方式
    
    返回:
    
    结果列表
  - toList
```
public static <K,V> List<K> toList(Iterator<V> values,
                                   IHandler<? super V,K> keyFunction)
```
    可遍历的元素对象的某个元素，转换为列表
    
    类型参数:
    
    K - k 泛型
    
    V - v 泛型
    
    参数:
    
    values - 遍历对象
    
    keyFunction - 转换方式
    
    返回:
    
    结果列表
  - fillList
```
public static <E> List<E> fillList(List<E> values,
                                   IFiller<E> filler)
```
    遍历填充对象
    
    类型参数:
    
    E - e 泛型
    
    参数:
    
    values - 遍历对象
    
    filler - 对象填充器
    
    返回:
    
    返回类表
    
    从以下版本开始:
    
    0.1.10
  - splitByAnyBlank
```
public static List<String> splitByAnyBlank(String string)
```
    按照任意空格拆分
    
    参数:
    
    string - 字符串
    
    返回:
    
    拆分后的列表
    
    从以下版本开始:
    
    0.0.5
  - filterList
```
public static <T> List<T> filterList(Collection<T> list,
                                     IFilter<T> filter)
```
    执行列表过滤
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    list - 原始列表
    
    filter - 过滤器
    
    返回:
    
    过滤后的结果
    
    从以下版本开始:
    
    0.0.6
  - conditionList
```
public static <T> List<T> conditionList(Collection<T> list,
                                        ICondition<T> condition)
```
    执行列表过滤
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    list - 原始列表
    
    condition - 条件过滤器
    
    返回:
    
    过滤后的结果
    
    从以下版本开始:
    
    0.0.6
  - toStringList
```
public static List<String> toStringList(List<?> pathList)
```
    对象列表转换为 toString 列表 1. 会跳过所有的 null 对象。 2. 建议放在 collectUtil 下。
    
    参数:
    
    pathList - 原始对象
    
    返回:
    
    结果
    
    从以下版本开始:
    
    0.0.6
  - firstNotNullElem
```
public static <T> Optional<T> firstNotNullElem(Collection<T> list)
```
    找到第一个不为 null 的元素
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    list - 列表
    
    返回:
    
    不为 null 的元素
    
    从以下版本开始:
    
    0.1.6
  - join
```
public static String join(Collection<?> stringCollection,
                          String connector)
```
    将字符串集合内容按照 connector 连接起来
    
    参数:
    
    stringCollection - 字符串集合
    
    connector - 连接符号
    
    返回:
    
    结果
    
    从以下版本开始:
    
    0.1.6
  - join
```
public static String join(Collection<?> stringCollection)
```
    将字符串集合内容按照逗号连接起来
    
    参数:
    
    stringCollection - 字符串集合
    
    返回:
    
    结果
    
    从以下版本开始:
    
    0.1.46
  - foreach
```
public static <E> void foreach(Collection<E> collection,
                               IHandler<E,Void> handler)
```
    循环处理集合
    
    类型参数:
    
    E - 泛型元素
    
    参数:
    
    collection - 集合
    
    handler - 处理器
    
    从以下版本开始:
    
    0.1.8
  - foreachPrint
```
public static <E> void foreachPrint(Collection<E> collection)
```
    循环处理集合
    
    类型参数:
    
    E - 泛型元素
    
    参数:
    
    collection - 集合
    
    从以下版本开始:
    
    0.1.93
  - fill
```
public static <E> List<E> fill(int size,
                               E elem)
```
    填充信息
    
    类型参数:
    
    E - 泛型
    
    参数:
    
    size - 大小
    
    elem - 单个元素
    
    返回:
    
    列表
    
    从以下版本开始:
    
    0.1.9
  - fill
```
public static List<Integer> fill(int size,
                                 int initValue)
```
    填充信息
    
    参数:
    
    size - 大小
    
    initValue - 初始值
    
    返回:
    
    列表
    
    从以下版本开始:
    
    0.1.85
  - fill
```
public static List<Integer> fill(int size)
```
    填充信息
    
    参数:
    
    size - 大小
    
    返回:
    
    列表
    
    从以下版本开始:
    
    0.1.85
  - getFirst
```
public static <E> E getFirst(Collection<E> collection)
```
    获取第一个元素 1. 避免 NPE
    
    类型参数:
    
    E - 泛型
    
    参数:
    
    collection - 列表
    
    返回:
    
    结果
    
    从以下版本开始:
    
    0.1.10
  - distinct
```
public static <T> List<T> distinct(Collection<T> collection)
```
    去重集合
    
    类型参数:
    
    T - 集合元素类型
    
    参数:
    
    collection - 集合
    
    返回:
    
    ArrayList
    
    从以下版本开始:
    
    0.1.13
  - distinctAndSort
```
public static <T extends Comparable> List<T> distinctAndSort(Collection<T> collection)
```
    去重并且排序
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    collection - 原始集合
    
    返回:
    
    结果
    
    从以下版本开始:
    
    0.1.72
  - getRepeatList
```
public static <T extends Comparable> List<T> getRepeatList(Collection<T> collection)
```
    获取重复列表
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    collection - 集合
    
    返回:
    
    结果列表
    
    从以下版本开始:
    
    0.1.92
  - sort
```
public static <T extends Comparable> List<T> sort(List<T> collection)
```
    排序
    
    类型参数:
    
    T - 集合元素类型
    
    参数:
    
    collection - 集合
    
    返回:
    
    ArrayList
    
    从以下版本开始:
    
    0.1.13
  - getStartIndex
```
public static int getStartIndex(int startIndex,
                                Collection<?> collection)
```
    获取开始的下标（1）默认为0 （2）如果为负数，或者超过 arrays.length-1，则使用 0 （3）正常返回 startIndex
    
    参数:
    
    startIndex - 开始下标
    
    collection - 集合信息
    
    返回:
    
    尽可能安全的下标范围。如果为空，则返回 0;
    
    从以下版本开始:
    
    0.1.14
  - getEndIndex
```
public static int getEndIndex(int endIndex,
                              Collection<?> collection)
```
    获取开始的下标（1）默认为0 （2）如果为负数，或者超过 arrays.length-1，则使用 arrays.length-1 （3）正常返回 endIndex
    
    参数:
    
    endIndex - 结束下标
    
    collection - 集合信息
    
    返回:
    
    尽可能安全的下标范围。如果为空，则返回 0;
    
    从以下版本开始:
    
    0.1.14
  - union
```
public static <E> List<E> union(Collection<E> collectionOne,
                                Collection<E> collectionTwo)
```
    集合的并集
    
    类型参数:
    
    E - 泛型
    
    参数:
    
    collectionOne - 集合1
    
    collectionTwo - 集合2
    
    返回:
    
    结果集合
    
    从以下版本开始:
    
    0.1.16
  - difference
```
public static <E> List<E> difference(Collection<E> collectionOne,
                                     Collection<E> collectionTwo)
```
    集合的差集
    
    类型参数:
    
    E - 泛型
    
    参数:
    
    collectionOne - 集合1
    
    collectionTwo - 集合2
    
    返回:
    
    结果集合
    
    从以下版本开始:
    
    0.1.16
  - interSection
```
public static <E> List<E> interSection(Collection<E> collectionOne,
                                       Collection<E> collectionTwo)
```
    集合的差交集
    
    类型参数:
    
    E - 泛型
    
    参数:
    
    collectionOne - 集合1
    
    collectionTwo - 集合2
    
    返回:
    
    结果集合
    
    从以下版本开始:
    
    0.1.16
  - containAny
```
public static boolean containAny(Collection<String> firstList,
                                 Collection<String> secondList)
```
    包含任何一个
    
    参数:
    
    firstList - 第一个列表
    
    secondList - 第二个列表
    
    返回:
    
    是否包含
    
    从以下版本开始:
    
    0.1.70
  - getLast
```
public static String getLast(List<String> resultList)
```
    获取最后一行
    
    参数:
    
    resultList - 结果列表
    
    返回:
    
    最后一行
    
    从以下版本开始:
    
    0.1.70
  - setLast
```
public static void setLast(List<String> resultList,
                           String line)
```
    设置最后一行
    
    参数:
    
    resultList - 结果列表
    
    line - 最后一行内容
    
    从以下版本开始:
    
    0.1.70
  - getTopK
```
public static <T> List<T> getTopK(Collection<T> collection,
                                  int size)
```
    获取指定的前几个元素
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    collection - 集合
    
    size - 大小
    
    返回:
    
    结果
    
    从以下版本开始:
    
    0.1.79
  - replaceAll
```
public static List<String> replaceAll(Collection<String> collection,
                                      String regex,
                                      String target)
```
    针对整个集合做替换处理
    
    参数:
    
    collection - 集合
    
    regex - 正则
    
    target - 目标
    
    返回:
    
    结果
    
    从以下版本开始:
    
    0.1.85
  - subList
```
public static <E> List<E> subList(List<E> list,
                                  int offset,
                                  int limit)
```
    对原始列表进行截取
    
    类型参数:
    
    E - 泛型
    
    参数:
    
    list - 集合1
    
    offset - 偏移量
    
    limit - 大小
    
    返回:
    
    结果集合
    
    从以下版本开始:
    
    0.1.89
  - random
```
public static <E> E random(List<E> list)
```
    随机获取一个元素
    
    类型参数:
    
    E - 元素
    
    参数:
    
    list - 列表
    
    返回:
    
    结果
    
    从以下版本开始:
    
    0.1.100
  - list
```
public static <T> List<T> list()
```
    空列表
    
    类型参数:
    
    T - 泛型
    
    返回:
    
    空列表
    
    从以下版本开始:
    
    0.1.128
  - list
```
public static <T> List<T> list(T t)
```
    空列表
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    t - 实体
    
    返回:
    
    空列表
    
    从以下版本开始:
    
    0.1.128
  - list
```
public static <T> List<T> list(T... ts)
```
    列表
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    ts - 数组
    
    返回:
    
    空列表
    
    从以下版本开始:
    
    0.1.128
  - copy
```
public static <T> List<T> copy(List<T> list)
```
    复制列表
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    list - 列表
    
    返回:
    
    空列表
    
    从以下版本开始:
    
    0.1.128
  - head
```
public static <T> T head(List<T> list)
```
    获取第一个元素
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    list - 列表
    
    返回:
    
    空列表
    
    从以下版本开始:
    
    0.1.128
  - tail
```
public static <T> T tail(List<T> list)
```
    获取最后一个元素
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    list - 列表
    
    返回:
    
    空列表
    
    从以下版本开始:
    
    0.1.128
  - append
```
public static <T> List<T> append(List<T> list,
                                 T t)
```
    添加元素到列表
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    list - 列表
    
    t - 元素
    
    返回:
    
    空列表
    
    从以下版本开始:
    
    0.1.128
  - reverse
```
public static <T> List<T> reverse(List<T> list,
                                  T t)
```
    反转列表
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    list - 列表
    
    t - 元素
    
    返回:
    
    空列表
    
    从以下版本开始:
    
    0.1.128
  - addAll
```
public static <T> void addAll(Collection<T> collection,
                              Collection<T> addCollection)
```
    添加所有的元素
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    collection - 集合1
    
    addCollection - 集合2
    
    从以下版本开始:
    
    0.1.147
  - random
```
public static <T> T random(Collection<T> collection)
```
    随机一个元素 loop 实现，性能比较差
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    collection - 集合
    
    返回:
    
    结果
    
    从以下版本开始:
    
    0.1.158
  - pageList
```
public static <T> List<T> pageList(List<T> list,
                                   int pageNum,
                                   int pageSize)
```
    内存分页
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    list - 列表
    
    pageNum - 从1开始
    
    pageSize - 每一页大小
    
    返回:
    
    结果
    
    从以下版本开始:
    
    0.1.158
  - pageList
```
public static <T> List<T> pageList(Collection<T> collection,
                                   int pageNum,
                                   int pageSize)
```
    内存分页 ps: 类似 mysql 的分页模式，性能越往后越差。
    
    类型参数:
    
    T - 泛型
    
    参数:
    
    collection - 列表
    
    pageNum - 从1开始
    
    pageSize - 每一页大小
    
    返回:
    
    结果
    
    从以下版本开始:
    
    0.1.158
  - contains
```
public static boolean contains(Collection<?> collection,
                               Object value)
```
    是否包含
    
    参数:
    
    collection - 集合
    
    value - 值
    
    返回:
    
    结果
    
    从以下版本开始:
    
    0.7.0

类 CollectionUtil

字段概要

方法概要

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

字段详细资料

EMPTY_LIST

方法详细资料

isEmpty

isNotEmpty

arrayToList

listToArray

trimCollection

buildCollection

buildCollection

addArray

toList

toList

fillList

splitByAnyBlank

filterList

conditionList

toStringList

firstNotNullElem

join

join

foreach

foreachPrint

fill

fill

fill

getFirst

distinct

distinctAndSort

getRepeatList

sort

getStartIndex

getEndIndex

union

difference

interSection

containAny

getLast

setLast

getTopK

replaceAll

subList

random

list

list

list

copy

head

tail

append

reverse

addAll

random

pageList

pageList

contains