Stream.flatMap()用于将嵌套集合展平为单层流，它对每个元素应用函数生成子流并自动合并；需注意null和空集合的安全处理，还可结合map保留原始上下文信息。
在 Java 中，Stream.flatMap() 是处理嵌套集合（比如“每个班级一个学生列表”）并展平为单层流的最自然方式。它的核心作用是：对流中每个元素执行一个函数，该函数返回一个新流，然后将所有这些子流“扁平化”合并成一个总流。
理解 flatMap 的输入与输出
flatMap 接收一个 Function<t stream>></t>：
- 每个原始元素（例如一个 ClassRoom 对象）被映射为一个 Stream<student></student>；
- 所有这些学生流被自动连接（concatenated），形成一个统一的 Stream<student></student>。
这和 map 不同：map 会产出 Stream<stream>></stream>，还需额外调用 flatMap(Function.identity()) 才能展平。
基础用法：从班级列表到学生流
假设有如下结构：
// 示例数据
立即学习“Java免费学习笔记（深入）”；
List
new ClassRoom("一班", List.of(new Student("张三"), new Student("李四"))),
new ClassRoom("二班", List.of(new Student("王五"), new Student("赵六"), new Student("钱七")))
);
只需一行即可合并所有学生：
Stream
.flatMap(room -> room.getStudents().stream());
之后可链式操作，如：
-
.filter(s -> s.getName().length() > 2)—— 筛选名字超两个字的学生 -
.map(Student::getName)—— 提取姓名流 -
.collect(Collectors.toList())—— 收集为列表
注意空集合与 null 安全
如果某个班级的 getStudents() 返回 null 或空列表，直接调用 .stream() 会抛出 NullPointerException 或产生无意义结果。推荐写法：
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
.flatMap(room -> Optional.ofNullable(room.getStudents())
.orElse(Collections.emptyList())
.stream())
或者更简洁地使用：
.flatMap(room -> room.getStudents() != null
? room.getStudents().stream()
: Stream.empty())
进阶：合并时附加班级信息
若需保留学生所属班级，可在 flatMap 内部做映射：
record StudentWithClass(String name, String className) {}
Stream
.flatMap(room -> room.getStudents().stream()
.map(s -> new StudentWithClass(s.getName(), room.getName())));
这样每个学生都携带了来源班级名，便于后续分组或标记。
