Collectors.mapping用于流元素的二次转换,先通过mapper函数转换元素,再由downstream收集器收集;常用于提取属性、分组后映射、嵌套结构处理等场景,如与toList、groupingBy结合使用,提升代码可读性。

在Java中,Collectors.mapping 是一个非常实用的收集器工具,用于对流(Stream)中的元素进行二次转换,尤其是在嵌套结构或需要进一步处理映射值的场景中。它通常与其他收集器(如 toList、toSet、groupingBy 等)配合使用,实现更灵活的数据转换。
Collectors.mapping 的基本语法
mapping 方法定义如下:
public staticCollector
Function super T, ? extends U> mapper,
Collector super U, A, R> downstream
)
它的作用是:
- 先用第一个参数 mapper 函数将流中的每个元素转换为另一种类型。
- 再将转换后的结果传递给第二个参数 downstream 收集器进行最终收集。
实际应用场景示例
1. 提取对象属性并收集为列表
假设有一个用户类:
private String name;
private int age;
// 构造方法、getter 省略
}
现在有一个用户流,想提取所有用户的姓名并收集为 List:
List.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
// getter... }
想要得到每个部门的所有用户姓名列表:
Map.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 步骤,提升代码表达力和可读性。










