Collectors.mapping用于将元素转换后传递给下游收集器，常与groupingBy等组合使用，实现分组后字段提取、去重收集及嵌套转换，如按部门分组并收集员工姓名列表，其核心是“先映射，再收集”，适用于复杂聚合场景。
在Java 8引入的Stream API中，Collectors.mapping 是一个非常实用但容易被忽视的收集器工具。它通常用于嵌套收集场景中，将元素转换后再交给下游收集器处理。与 map() 操作不同，Collectors.mapping 不是直接作用于Stream流，而是作为 Collectors.collectingAndThen 或 Collectors.groupingBy 等复合收集器的一部分使用。
什么是 Collectors.mapping？
方法签名如下：
public static <T, U, A, R><br>Collector<T, ?, R> mapping(<br> Function<? super T, ? extends U> mapper,<br> Collector<? super U, A, R> downstream<br>)
它的作用是：将每个输入元素通过 mapper 函数转换成新类型U，然后将转换后的结果传递给下游收集器（downstream）进行进一步收集。
立即学习“Java免费学习笔记（深入）”；
简单理解：先映射，再收集。常用于 groupingBy、flatMapping 等结构中。
实际应用场景示例
1. 分组后提取特定字段
假设我们有一个员工列表，想按部门分组，并收集每个部门所有员工的姓名：
class Employee {
String name;
String department;
int salary;
// 构造函数、getter省略
}
使用 mapping 实现：
Map<String, List<String>> namesByDept = employees.stream()
.collect(Collectors.groupingBy(
Employee::getDepartment,
Collectors.mapping(Employee::getName, Collectors.toList())
));
这里的关键是第二个参数：Collectors.mapping(Employee::getName, Collectors.toList()) 表示对每个员工取名字，然后收集为列表。如果不使用 mapping，就需要在 group 后额外遍历处理，代码更复杂。
2. 转换后去重收集
如果只想获取每个部门的员工姓名集合（不重复）：
Map<String, Set<String>> uniqueNamesByDept = employees.stream()
.collect(Collectors.groupingBy(
Employee::getDepartment,
Collectors.mapping(Employee::getName, Collectors.toSet())
));
自动去重，简洁明了。
3. 嵌套收集中的层级转换
比如统计每个部门的薪资等级分布（高/中/低）：
Map<String, Map<String, Long>> 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<String, List<String>> 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 操作。
