17370845950

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，更安全简洁

示例：

Optional user = Optional.of(new User("Alice"));
Optional name = user.flatMap(u -> Optional.ofNullable(u.getName()));

结合业务对象展开关联数据（如订单→商品列表）

假设有Order类含List字段，想一次性获取所有商品：

List orders = ...;
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，嵌套结构处理就变得干净又直观。