Class CollStreamUtil

java.lang.Object
com.sure.tool.collection.CollStreamUtil

public class CollStreamUtil extends Object
集合流式处理工具,参考 Hutool CollStreamUtil 设计。

把高频的 Stream 样板(分组 / 聚合 / 去重 / 拼接)收敛为一行调用; 默认返回新结构且保持输入顺序(LinkedHashMap / List),不修改入参集合。

Since:
1.18.0
Author:
suretool
  • Method Details

    • groupBy

      public static <T,K> Map<K,List<T>> groupBy(Collection<T> data, Function<T,K> keyMapper)
      按键分组:Map<键, List<元素>>,保持首次出现顺序。
      Type Parameters:
      T - 元素类型
      K - 键类型
      Parameters:
      data - 数据集合,null 返回空 Map
      keyMapper - 键提取函数,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 抛 IllegalArgumentException
      mapSupplier - 结果容器工厂,null 抛 IllegalArgumentException
      Returns:
      分组结果
    • groupByKeyValue

      public static <T,K,V> Map<K,V> groupByKeyValue(Collection<T> data, Function<T,K> keyMapper, Function<T,V> valueMapper)
      按键聚合值:Map<键, 值>,同键后者覆盖前者。
      Type Parameters:
      T - 元素类型
      K - 键类型
      V - 值类型
      Parameters:
      data - 数据集合,null 返回空 Map
      keyMapper - 键提取函数,null 抛 IllegalArgumentException
      valueMapper - 值提取函数,null 抛 IllegalArgumentException
      Returns:
      键值映射(LinkedHashMap 保序)
    • toMap

      public static <T,K,V> Map<K,V> toMap(Collection<T> data, Function<T,K> keyMapper, Function<T,V> valueMapper)
      转为唯一键 Map(Guava uniqueIndex 语义):重复键抛 IllegalArgumentException。
      Type Parameters:
      T - 元素类型
      K - 键类型
      V - 值类型
      Parameters:
      data - 数据集合,null 返回空 Map
      keyMapper - 键提取函数,null 抛 IllegalArgumentException
      valueMapper - 值提取函数,null 抛 IllegalArgumentException
      Returns:
      键值映射
      Throws:
      IllegalArgumentException - 存在重复键
    • toMap

      public static <T,K,V> Map<K,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 返回空 Map
      keyMapper - 键提取函数,null 抛 IllegalArgumentException
      valueMapper - 值提取函数,null 抛 IllegalArgumentException
      mergeFunction - 冲突合并函数,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

      public static <T> List<T> filter(Collection<T> data, Predicate<T> predicate)
      过滤出新 List(保持顺序)。
      Type Parameters:
      T - 元素类型
      Parameters:
      data - 数据集合,null 返回空 List
      predicate - 过滤条件,null 抛 IllegalArgumentException
      Returns:
      过滤结果
    • distinct

      public static <T,K> List<T> distinct(Collection<T> data, Function<T,K> keyExtractor)
      按提取键去重(首现保留),返回新 List 保持顺序。
      Type Parameters:
      T - 元素类型
      K - 键类型
      Parameters:
      data - 数据集合,null 返回空 List
      keyExtractor - 去重键提取函数,null 抛 IllegalArgumentException
      Returns:
      去重结果
    • join

      public static <T> String join(Collection<T> data, Function<T,?> extractor, String separator)
      拼接元素:按提取函数取值后以分隔符连接,null 值跳过。
      Type Parameters:
      T - 元素类型
      Parameters:
      data - 数据集合,null 返回空串
      extractor - 取值函数(null 值跳过),null 抛 IllegalArgumentException
      separator - 分隔符,null 视为空串
      Returns:
      拼接结果
    • map

      public static <T,R> List<R> map(Collection<T> data, Function<T,R> mapper)
      映射出新 List(保持顺序,null 映射结果跳过)。
      Type Parameters:
      T - 元素类型
      R - 结果类型
      Parameters:
      data - 数据集合,null 返回空 List
      mapper - 映射函数,null 抛 IllegalArgumentException
      Returns:
      映射结果