Java中Collectors.mapping使用技巧

Collectors.mapping用于将元素转换后传递给下游收集器，常与groupingBy等组合使用，实现分组后字段提取、去重收集及嵌套转换，如按部门分组并收集员工姓名列表，其核心是“先映射，再收集”，适用于复杂聚合场景。

在Java 8引入的Stream API中，Collectors.mapping 是一个非常实用但容易被忽视的收集器工具。它通常用于嵌套收集场景中，将元素转换后再交给下游收集器处理。与 map() 操作不同，Collectors.mapping 不是直接作用于Stream流，而是作为 Collectors.collectingAndThen 或 Collectors.groupingBy 等复合收集器的一部分使用。

什么是 Collectors.mapping？

方法签名如下：

public static
Collector mapping(
  Function mapper,
  Collector downstream
)

它的作用是：将每个输入元素通过 mapper 函数转换成新类型U，然后将转换后的结果传递给下游收集器（downstream）进行进一步收集。

简单理解：先映射，再收集。常用于 groupingBy、flatMapping 等结构中。

实际应用场景示例

1. 分组后提取特定字段

假设我们有一个员工列表，想按部门分组，并收集每个部门所有员工的姓名：

class Employee {
    String name;
    String department;
    int salary;
    // 构造函数、getter省略
}

使用 mapping 实现：

Map> namesByDept = employees.stream()
    .collect(Collectors.groupingBy(
        Employee::getDepartment,
        Collectors.mapping(Employee::getName, Collectors.toList())
    ));

这里的关键是第二个参数：Collectors.mapping(Employee::getName, Collectors.toList()) 表示对每个员工取名字，然后收集为列表。如果不使用 mapping，就需要在 group 后额外遍历处理，代码更复杂。

2. 转换后去重收集

如果只想获取每个部门的员工姓名集合（不重复）：

Map> uniqueNamesByDept = employees.stream()
    .collect(Collectors.groupingBy(
        Employee::getDepartment,
        Collectors.mapping(Employee::getName, Collectors.toSet())
    ));

自动去重，简洁明了。

3. 嵌套收集中的层级转换

比如统计每个部门的薪资等级分布（高/中/低）：

Map> salaryLevelByDept = employees.stream()
    .collect(Collectors.groupingBy(
        Employee::getDepartment,
        Collectors.groupingBy(emp -> {
            if (emp.getSalary() >= 20000) return "高";
            else if (emp.getSalary() >= 10000) return "中";
            else return "低";
        }, Collectors.counting())
    ));

虽然没直接用 mapping，但如果我们要统计的是“每个部门中高薪员工的姓名”，就可以结合使用：

Map> highEarnerNames = employees.stream()
    .filter(e -> e.getSalary() > 20000)
    .collect(Collectors.groupingBy(
        Employee::getDepartment,
        Collectors.mapping(Employee::getName, Collectors.toList())
    ));

常见误区与注意事项

• 不要和 Stream.map 混淆：多数情况下用 stream.map().collect() 更直观。只有在嵌套收集（如 groupingBy 后续操作）时才需要用 Collectors.mapping。
• 空值处理：若 mapper 返回 null，下游收集器会保留 null（如 toList 会包含 null），需提前用 filter 过滤或 map 转换避免。
• 性能考量：多层嵌套收集可能影响可读性和性能，建议拆解复杂逻辑或添加注释说明意图。

基本上就这些。Collectors.mapping 的价值在于让复杂的集合转换更声明式、更紧凑，尤其适合数据聚合场景。掌握它能让你的 Stream 代码更优雅，尤其是在处理分组、分类统计时。关键是理解它“配合下游收集器工作”的定位，而不是替代 map 操作。