flatMap用于将嵌套集合扁平化，通过映射每个元素为Stream并合并，实现多层结构转单层，如处理List<List<String>>或提取用户邮箱列表，使数据处理更简洁高效。

在Java中，flatMap 是 Stream API 提供的一个强大方法，用于将多个子集合“扁平化”为一个单一的流。它常用于处理嵌套集合（如 List>），将多层结构转换为单层结构。

flatMap 的作用与原理

flatMap 方法会先对集合中的每个元素应用一个函数（该函数返回一个 Stream），然后将这些 Stream 合并成一个统一的 Stream。相比 map 只做映射，flatMap 能“压平”嵌套结构。

其方法签名如下：

<R> Stream<R> flatMap(Function<? super T, ? extends Stream<? extends R>> mapper)

也就是说，它接收一个函数式接口，这个接口把原元素转成一个 Stream，最终所有子 Stream 被连接起来。

立即学习“Java免费学习笔记（深入）”；

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

实际使用示例：扁平化字符串列表

假设有一个包含多个单词列表的集合，我们想把所有单词提取出来组成一个单独的流：

List> nestedList = Arrays.asList(
    Arrays.asList("Java", "Stream"),
    Arrays.asList("flatMap", "example"),
    Arrays.asList("coding", "tutorial")
);

List flatList = nestedList.stream()
    .flatMap(subList -> subList.stream())
    .collect(Collectors.toList());

// 输出: [Java, Stream, flatMap, example, coding, tutorial]

这里，subList -> subList.stream() 将每个子列表转为 Stream，flatMap 再把这些 Stream 合并。

常见应用场景：提取对象属性中的集合

比如有用户类 User，每个用户有多个邮箱地址：

class User {
    private List emails;
    // 构造方法、getter 省略
}

List users = ... ; // 初始化用户列表

List allEmails = users.stream()
    .flatMap(user -> user.getEmails().stream())
    .collect(Collectors.toList());

这样就能把所有用户的邮箱合并成一个列表，避免了嵌套循环。

基本上就这些。flatMap 的核心就是“映射 + 扁平化”，特别适合处理集合中的集合，让数据结构更简洁。用好它，代码会更清晰高效。