Collectors.mapping用于流元素的二次转换，先通过mapper函数转换元素，再由downstream收集器收集；常用于提取属性、分组后映射、嵌套结构处理等场景，如与toList、groupingBy结合使用，提升代码可读性。
在Java中，Collectors.mapping 是一个非常实用的收集器工具，用于对流（Stream）中的元素进行二次转换，尤其是在嵌套结构或需要进一步处理映射值的场景中。它通常与其他收集器（如 toList、toSet、groupingBy 等）配合使用，实现更灵活的数据转换。
Collectors.mapping 的基本语法
mapping 方法定义如下：
public static <T, U, A, R>Collector<T, ?, R> mapping(
Function<? super T, ? extends U> mapper,
Collector<? super U, A, R> downstream
)
它的作用是：
- 先用第一个参数 mapper 函数将流中的每个元素转换为另一种类型。
- 再将转换后的结果传递给第二个参数 downstream 收集器进行最终收集。
实际应用场景示例
1. 提取对象属性并收集为列表
假设有一个用户类：
private String name;
private int age;
// 构造方法、getter 省略
}
现在有一个用户流，想提取所有用户的姓名并收集为 List：
List<String> names = users.stream().collect(Collectors.mapping(User::getName, Collectors.toList()));
这里先通过 User::getName 映射成字符串，再由 toList() 收集。
立即学习“Java免费学习笔记（深入）”；
2. 与 groupingBy 配合使用
比如按年龄分组，但只保留每组用户的姓名列表：
.collect(Collectors.groupingBy(
User::getAge,
Collectors.mapping(User::getName, Collectors.toList())
));
外层按年龄分组，内层使用 mapping 将用户转为姓名后再收集。
3. 多重映射：嵌套结构处理
如果有 Department 类包含员工列表：
private String deptName;
private List<User> users;
// getter... }
想要得到每个部门的所有用户姓名列表：
Map<String, List<String>> deptNames = departments.stream().collect(Collectors.toMap(
Department::getDeptName,
d -> d.getUsers().stream()
.collect(Collectors.mapping(User::getName, Collectors.toList()))
));
这里内部流使用了 mapping 完成从 User 到姓名的转换。
常见搭配的下游收集器
mapping 本身不完成最终收集，必须搭配下游收集器。常用组合包括：
-
Collectors.toList()—— 转换后收集为列表 -
Collectors.toSet()—— 去重收集为集合 -
Collectors.joining()—— 转为字符串拼接 -
Collectors.summarizingInt()—— 统计数值信息 -
Collectors.collectingAndThen()—— 转换后附加操作
例如，将用户名转为大写并拼接成字符串：
String result = users.stream().collect(Collectors.mapping(
u -> u.getName().toUpperCase(),
Collectors.joining(", ")
));
基本上就这些。合理使用 Collectors.mapping 可以让流操作更清晰，避免中间 collect 或 map 步骤，提升代码表达力和可读性。
