Java 8 Stream 中使用 toMap 实现多字段分组并合并对象

本文介绍如何利用 java 8 stream 的 `collectors.tomap` 替代嵌套 `groupingby`，以简洁、高效地按多个字段（如 id + date）对订单列表分组，并合并同组订单金额，最终直接得到合并后的 `order` 对象列表。

在实际业务中，我们常需对具有相同业务标识（如订单 ID 和日期）的记录进行聚合计算（如金额累加）。传统做法是嵌套使用 groupingBy —— 先按 id 分组，再对每个子组按 date 二次分组，并配合自定义 Collector 合并元素。这种方式逻辑清晰但代码冗长、可读性差，且易引入中间集合（如 Map>），增加内存开销与维护成本。

更优解是将多字段组合为唯一键，并直接使用 Collectors.toMap 完成“分组 + 合并”一步到位。关键在于：

• ✅ 定义不可变复合键（推荐使用 record，简洁安全）；
• ✅ 使用 toMap(keyMapper, valueMapper, mergeFunction)，其中 mergeFunction 负责同键下两个 Order 的合并逻辑；
• ✅ 最终通过 .values() 提取合并结果，转为 List。

以下是完整实现示例：

// 1. 定义轻量级复合键（Java 14+ record，若用低版本可用普通类或 Pair）
record IdAndDate(Integer id, LocalDate date) {}

// 2. 主聚合逻辑：一行流式操作完成分组与合并
List result = new ArrayList<>(
    orders.stream()
        .collect(Collectors.toM
ap(
            order -> new IdAndDate(order.getId(), order.getDate()), // 键：id+date 组合
            Function.identity(),                                     // 值：原始 Order 对象
            Order::combine                                           // 冲突时合并：累加 amount
        ))
        .values()
);

⚠️ 重要注意事项：

• 当前 Order.combine(Order other) 方法是就地修改（mutating）：它复用第一个 Order 实例并修改其字段，返回 this。这意味着原始列表中的某些对象状态会被改变。若业务要求数据不可变（recommended for functional style），请重构 combine 为纯函数式：

public Order combine(Order other) {
    return new Order(
        this.id, 
        this.date, 
        this.amount + other.getAmount()
    );
}

同时确保 Order 类具备合适的构造函数（或使用 Builder 模式）。此时 toMap 中的 mergeFunction 将返回全新实例，彻底避免副作用。

✅ 优势总结：

• 更少嵌套、更高可读性：单层 stream().collect(...) 替代双层 groupingBy；
• 更低内存占用：无需中间 List 或多层 Map 结构；
• 更强表达力：toMap 的三参数形式天然契合“键冲突即合并”的语义；
• 易于扩展：如需添加时间戳、状态等更多分组维度，只需扩展 IdAndDate 即可。

该方案兼顾简洁性与工程健壮性，是 Java 8+ 流式聚合场景下的推荐实践。