flatMap的核心作用是“一对多映射 + 扁平化”,将每个元素转为流并合并成单一流;适用于List展平、Optional链式安全取值、订单→商品等关联数据展开,且参数必须返回Stream。

Java中flatMap的核心作用是“一对多映射 + 扁平化”,它把每个元素转换成一个流,再把所有子流合并成一个单一的流。和map不同,flatMap不保留嵌套结构,而是彻底摊平。
flatMap的基本用法:从集合到元素流
常见场景是把一个List转成>
Stream:
List> nested = Arrays.asList( Arrays.asList("a", "b"), Arrays.asList("c"), Arrays.asList("d", "e", "f") ); List
flat = nested.stream() .flatMap(list -> list.stream()) // 每个子列表 → 其自身流,再自动合并 .collect(Collectors.toList()); // 结果:["a", "b", "c", "d", "e", "f"]
处理Optional时用flatMap避免空指针和嵌套
Optional.flatMap和Stream.flatMap逻辑一致:防止出现Optional,直接返回内层Optional:
- 用
map会得到Optional(可能为> Optional.empty()) - 用
flatMap直接返回Optional,更安全简洁
示例:
立即学习“Java免费学习笔记(深入)”;
Optionaluser = Optional.of(new User("Alice")); Optional name = user.flatMap(u -> Optional.ofNullable(u.getName()));
结合业务对象展开关联数据(如订单→商品列表)
假设有Order类含List字段,想一次性获取所有商品:
Listorders = ...; List - allItems = orders.stream() .flatMap(order -> order.getItems().stream()) // 每个订单 → 其商品流 .collect(Collectors.toList());
还可链式继续处理,比如过滤高价商品:
.flatMap(order -> order.getItems().stream()) .filter(item -> item.getPrice() > 100) .map(Item::getName) .collect(Collectors.toList());
注意返回值必须是Stream,不能是普通集合或null
flatMap函数的参数必须返回Stream>,否则编译失败:
- ✅ 正确:
list -> list.stream()、s -> Stream.of(s.toUpperCase()) - ❌ 错误:
s -> s.split(" ")(返回String[])、_ -> null - ⚠️ 安全写法处理可能为空的集合:
order.getItems() != null ? order.getItems().stream() : Stream.empty()
基本上就这些。用对flatMap,嵌套结构处理就变得干净又直观。










