Class CollStreamUtil
java.lang.Object
com.sure.tool.collection.CollStreamUtil
集合流式处理工具,参考 Hutool
CollStreamUtil 设计。
把高频的 Stream 样板(分组 / 聚合 / 去重 / 拼接)收敛为一行调用; 默认返回新结构且保持输入顺序(LinkedHashMap / List),不修改入参集合。
- Since:
- 1.18.0
- Author:
- suretool
-
Method Summary
Modifier and TypeMethodDescriptionstatic <T,K> List <T> distinct(Collection<T> data, Function<T, K> keyExtractor) 按提取键去重(首现保留),返回新 List 保持顺序。static <T> List<T> filter(Collection<T> data, Predicate<T> predicate) 过滤出新 List(保持顺序)。groupBy(Collection<T> data, Function<T, K> keyMapper) 按键分组:Map<键, List<元素>>,保持首次出现顺序。groupBy(Collection<T> data, Function<T, K> keyMapper, Supplier<M> mapSupplier) 按键分组到自定义容器。static <T,K, V> Map <K, V> groupByKeyValue(Collection<T> data, Function<T, K> keyMapper, Function<T, V> valueMapper) 按键聚合值:Map<键, 值>,同键后者覆盖前者。static <T> Stringjoin(Collection<T> data, Function<T, ?> extractor, String separator) 拼接元素:按提取函数取值后以分隔符连接,null 值跳过。static <T,R> List <R> map(Collection<T> data, Function<T, R> mapper) 映射出新 List(保持顺序,null 映射结果跳过)。static <T> LongSummaryStatisticssummaryStatistics(Collection<T> data, Function<T, Long> valueExtractor) 数值统计:一次性汇总 count / sum / min / max / average。static <T,K, V> Map <K, V> toMap(Collection<T> data, Function<T, K> keyMapper, Function<T, V> valueMapper) 转为唯一键 Map(GuavauniqueIndex语义):重复键抛IllegalArgumentException。static <T,K, V> Map <K, V> toMap(Collection<T> data, Function<T, K> keyMapper, Function<T, V> valueMapper, BinaryOperator<V> mergeFunction) 转为 Map,冲突时用合并函数处理。
-
Method Details
-
groupBy
按键分组:Map<键, List<元素>>,保持首次出现顺序。- Type Parameters:
T- 元素类型K- 键类型- Parameters:
data- 数据集合,null 返回空 MapkeyMapper- 键提取函数,null 抛IllegalArgumentException- Returns:
- 分组结果(LinkedHashMap)
-
groupBy
public static <T, K, M extends Map<K,List<T>>> M groupBy(Collection<T> data, Function<T, K> keyMapper, Supplier<M> mapSupplier) 按键分组到自定义容器。- Type Parameters:
T- 元素类型K- 键类型M- 结果 Map 类型- Parameters:
data- 数据集合,null 返回空容器(mapSupplier.get())keyMapper- 键提取函数,null 抛IllegalArgumentExceptionmapSupplier- 结果容器工厂,null 抛IllegalArgumentException- Returns:
- 分组结果
-
groupByKeyValue
public static <T,K, Map<K,V> V> groupByKeyValue(Collection<T> data, Function<T, K> keyMapper, Function<T, V> valueMapper) 按键聚合值:Map<键, 值>,同键后者覆盖前者。- Type Parameters:
T- 元素类型K- 键类型V- 值类型- Parameters:
data- 数据集合,null 返回空 MapkeyMapper- 键提取函数,null 抛IllegalArgumentExceptionvalueMapper- 值提取函数,null 抛IllegalArgumentException- Returns:
- 键值映射(LinkedHashMap 保序)
-
toMap
public static <T,K, Map<K,V> V> toMap(Collection<T> data, Function<T, K> keyMapper, Function<T, V> valueMapper) 转为唯一键 Map(GuavauniqueIndex语义):重复键抛IllegalArgumentException。- Type Parameters:
T- 元素类型K- 键类型V- 值类型- Parameters:
data- 数据集合,null 返回空 MapkeyMapper- 键提取函数,null 抛IllegalArgumentExceptionvalueMapper- 值提取函数,null 抛IllegalArgumentException- Returns:
- 键值映射
- Throws:
IllegalArgumentException- 存在重复键
-
toMap
public static <T,K, Map<K,V> V> toMap(Collection<T> data, Function<T, K> keyMapper, Function<T, V> valueMapper, BinaryOperator<V> mergeFunction) 转为 Map,冲突时用合并函数处理。- Type Parameters:
T- 元素类型K- 键类型V- 值类型- Parameters:
data- 数据集合,null 返回空 MapkeyMapper- 键提取函数,null 抛IllegalArgumentExceptionvalueMapper- 值提取函数,null 抛IllegalArgumentExceptionmergeFunction- 冲突合并函数,null 抛IllegalArgumentException- Returns:
- 键值映射
-
summaryStatistics
public static <T> LongSummaryStatistics summaryStatistics(Collection<T> data, Function<T, Long> valueExtractor) 数值统计:一次性汇总 count / sum / min / max / average。- Type Parameters:
T- 元素类型- Parameters:
data- 数据集合,null 或空返回全零统计valueExtractor- 取值函数(Long),null 抛IllegalArgumentException- Returns:
LongSummaryStatistics
-
filter
过滤出新 List(保持顺序)。- Type Parameters:
T- 元素类型- Parameters:
data- 数据集合,null 返回空 Listpredicate- 过滤条件,null 抛IllegalArgumentException- Returns:
- 过滤结果
-
distinct
按提取键去重(首现保留),返回新 List 保持顺序。- Type Parameters:
T- 元素类型K- 键类型- Parameters:
data- 数据集合,null 返回空 ListkeyExtractor- 去重键提取函数,null 抛IllegalArgumentException- Returns:
- 去重结果
-
join
拼接元素:按提取函数取值后以分隔符连接,null 值跳过。- Type Parameters:
T- 元素类型- Parameters:
data- 数据集合,null 返回空串extractor- 取值函数(null 值跳过),null 抛IllegalArgumentExceptionseparator- 分隔符,null 视为空串- Returns:
- 拼接结果
-
map
映射出新 List(保持顺序,null 映射结果跳过)。- Type Parameters:
T- 元素类型R- 结果类型- Parameters:
data- 数据集合,null 返回空 Listmapper- 映射函数,null 抛IllegalArgumentException- Returns:
- 映射结果
-