stream.flatmap 用于将嵌套结构扁平化为单层流，配合 map 实现空值安全、层级跳转与类型收敛；适用于 optional、list、自定义包装类等多级代理场景，提升代码声明性与健壮性。
Stream.flatMap 可以把嵌套结构“拍平”成一层流，特别适合从多级代理（比如 Optional>、Optional
> 等）中提取最终的目标对象。关键不是“扁平化”动作本身，而是用好 map + flatMap 的组合逻辑，让空值安全、层级跳转、类型收敛自然发生。
处理多层 Optional：避免 isPresent() 嵌套
当对象链形如 User → Optional<profile> → Optional<address> → String city</address></profile>，直接调用 .get() 容易抛出 NoSuchElementException，而层层 isPresent 判断又冗长。flatMap 能把 Optional 当作“可为空的容器”，天然支持短路：
String city = Optional.ofNullable(user)
.flatMap(u -> u.getProfile()) // 返回 Optional<profile>
.flatMap(p -> p.getAddress()) // 返回 Optional<address>
.map(a -> a.getCity()) // 返回 Optional<string>
.orElse("未知城市");
</string>
</address></profile>
说明：
• 每次 flatMap 接收一个 Optional<x></x>，返回另一个 Optional<y></y>，若上游为 empty，则整个链自动终止；
• map 用于最后一步非 Optional 类型转换（如 String）；
• 不要用 get() 或 orElseThrow() 中途打断链式。
展开 List> 或 List>
常见于查询结果聚合：比如每个订单有多个子订单，每个子订单可能关联一个优惠券（Optional），要汇总所有实际使用的优惠券 ID：
List<string> couponIds = orders.stream()
.flatMap(order -> order.getSubOrders().stream()) // List<suborder> → Stream<suborder>
.flatMap(sub -> sub.getCoupon().stream()) // Optional<coupon> → Stream<coupon>
.map(Coupon::getId) // Stream<coupon> → Stream<string>
.collect(Collectors.toList());
</string></coupon></coupon></coupon></suborder></suborder></string>
说明：
• optional.stream() 是关键技巧：empty Optional 生成空 Stream，非空则生成含 1 个元素的 Stream；
• 第一个 flatMap 把“订单列表”摊成“子订单流”，第二个 flatMap 把“每个子订单的优惠券 Optional”摊成“零或一个优惠券的流”；
• 整体效果等价于双重 for 循环 + if (coupon != null)，但更声明式、无副作用。
混合嵌套场景：List>>
例如 API 返回一批用户数据，每个用户的标签列表字段是 Optional<list>></list>，需提取全部非空标签：
List<tag> allTags = users.stream()
.flatMap(user -> user.getTags().orElse(Collections.emptyList()).stream())
.collect(Collectors.toList());
</tag>
或者更安全地结合 flatMap 处理 Optional：
List<tag> allTags = users.stream()
.flatMap(user -> user.getTags().stream()) // Optional<list>> → Stream<list>>
.flatMap(list -> list.stream()) // List<tag> → Stream<tag>
.collect(Collectors.toList());
</tag></tag></list></list></tag>
说明：
• 第一个 flatMap 把 Optional 展开为 0 或 1 个 List；
• 第二个 flatMap 把每个 List 再展开为元素流；
• 这种写法完全规避了 null 和空集合判空，也无需提前 .orElse(...) 构造默认集合。
自定义代理类型（如 Result、Response）的适配
如果项目中用了封装类如 Result<user></user> 或 ApiResponse<profile></profile>，只要它提供类似 flatMap(Function<t result>>)</t> 或 stream() 方法，就能接入 Stream 流程。推荐统一添加 stream() 辅助方法：
public class Result<t> {
private final T data;
private final boolean success;
public Stream<t> stream() {
return success && data != null ? Stream.of(data) : Stream.empty();
}
}
</t></t>
之后即可：
List<string> names = results.stream()
.flatMap(Result::stream) // Result<user> → Stream<user>
.map(User::getName)
.collect(Collectors.toList());
</user></user></string>
说明：
• 不强求代理类实现 Optional 风格 API，只需能转成 Stream；
• 所有自定义包装类型都可以通过 stream() 方法“接入”函数式链条，保持风格统一；
• 避免在流中混用 try-catch 或 if-else 分支判断成功/失败状态。
核心就三点：把每层代理看作“可展开的容器”，用 flatMap 表达“从这层取下一层”的依赖关系，用 map 完成最终值提取。只要容器支持转 Stream（或提供 flatMap），多深的嵌套都能线性表达，既安全又简洁。
