Java Stream 实用技巧：List 与 Map 的花式转换

mumu — Thu, 03 Jun 2021 00:00:00 +0000

前言

Java 8 引入的 Stream API 彻底改变了我们处理集合数据的方式。相比传统的 for 循环，Stream 提供了声明式、链式、可组合的数据处理风格，代码更简洁，意图更清晰。

在日常开发中，我们经常面对这样的场景：从数据库查出一个 List，需要转成按某个 key 分组的 Map；两个接口返回的列表需要按 id 合并；或者需要对字段做批量转换。这些需求用 Stream 几行代码就能搞定，而传统写法往往要写一堆临时变量和嵌套循环。

本文整理了 7 个实用的 Stream 技巧，每个都附带完整可运行的示例代码，希望能帮助你在实际项目中写出更优雅的集合操作。

一、List 转 Map（key 冲突处理）

基础也常见的操作。假设有一个用户列表，需要按 id 建索引：

        
        
        
    
import java.util.*;
import java.util.stream.*;

List<Map<String, Object>> users = new ArrayList<>();
users.add(new HashMap<String, Object>() {{ put("id", 1L); put("name", "Alice"); }});
users.add(new HashMap<String, Object>() {{ put("id", 2L); put("name", "Bob"); }});
users.add(new HashMap<String, Object>() {{ put("id", 3L); put("name", "Charlie"); }});

// 基本转换
Map<Long, Map<String, Object>> result = users.stream()
    .collect(Collectors.toMap(
        m -> (Long) m.get("id"),   // key mapper
        m -> m                      // value mapper
    ));

System.out.println(result);
// {1={name=Alice, id=1}, 2={name=Bob, id=2}, 3={name=Charlie, id=3}}

踩坑提示：如果 key 有重复，toMap 会抛 IllegalStateException。解决方案是提供第三个参数，合并函数：

常用工具类汇总：SM2/SM4/拼音/文件/HTTP 全覆盖

mumu — Fri, 10 Oct 2025 00:00:00 +0000

📅 2026-05-15 | 🏷️ Java, 工具类, 国密, Hutool | 📖 阅读约 18 分钟

一、背景

多年项目中积累了不少高频使用的工具代码。它们不算复杂，但每次要用的时候都得翻老项目找，效率很低。这篇文章把它们整理出来，统一收录，方便查阅和复用。

每个工具都包含：使用场景 → 完整代码 → 调用示例。

不要重复造轮子

在动手写工具类之前，先看看成熟库是否已经提供了：

Hutool 5.8.44（2026-03-11）：国人开发的 Java 工具库，覆盖字符串、日期、加密、HTTP、JSON 等 90% 的工具需求，API 简洁
Apache Commons：commons-lang3、commons-io、commons-collections 等，稳定可靠
Guava：Google 的 Java 工具库，集合、缓存、并发工具强大

本文在每个工具节的末尾都会给出"成熟库替代方案"，优先使用成熟库，只在特定需求时手写。

二、字符串工具

2.1 中文姓名转拼音生成邮箱账号

场景： 新员工入职系统自动生成企业邮箱，规则是"名.姓@company.com"，需要支持复姓（如诸葛孔明 → kongming.zhuge@company.com）。

        
        
        
    
import cn.hutool.extra.pinyin.PinyinUtil;

import java.util.Arrays;
import java.util.HashSet;
import java.util.Set;

/**
 * 中文姓名转拼音邮箱账号工具
 *
 * 支持：
 * - 单姓：张三 → san.zhang
 * - 复姓：诸葛孔明 → kongming.zhuge
 * - 单名：张伟 → wei.zhang
 */
public class PinyinEmailUtil {

    /**
     * 中国常见复姓集合（可根据需要扩充）
     */
    private static final Set<String> COMPOUND_SURNAMES = new HashSet<>(Arrays.asList(
            "欧阳", "太史", "端木", "上官", "司马", "东方", "独孤", "南宫",
            "万俟", "闻人", "夏侯", "诸葛", "尉迟", "公羊", "赫连", "澹台",
            "皇甫", "宗政", "濮阳", "公冶", "太叔", "申屠", "公孙", "慕容",
            "仲孙", "钟离", "长孙", "宇文", "司徒", "鲜于", "司空", "闾丘",
            "子车", "亓官", "司寇", "巫马", "公西", "颛孙", "壤驷", "公良",
            "漆雕", "乐正", "宰父", "谷梁", "拓跋", "夹谷", "轩辕", "令狐",
            "段干", "百里", "呼延", "东郭", "南门", "羊舌", "微生", "公户",
            "公玉", "公仪", "梁丘", "公仲", "公上", "公门", "公山", "公坚",
            "左丘", "公伯", "西门", "公祖", "第五", "公乘", "贯丘", "公皙",
            "南荣", "东里", "东宫", "仲长", "子书", "子桑", "即墨", "达奚",
            "褚师"
    ));

    /**
     * 将中文姓名转换为拼音邮箱账号
     *
     * @param chineseName 中文姓名（如 "诸葛孔明"）
     * @param domain      邮箱域名（如 "company.com"）
     * @return 邮箱账号（如 "kongming.zhuge@company.com"）
     */
    public static String toEmail(String chineseName, String domain) {
        if (chineseName == null || chineseName.length() < 2) {
            throw new IllegalArgumentException("姓名至少需要2个字符");
        }

        String surname;
        String givenName;

        // 判断是否为复姓（取前两个字匹配）
        String firstTwo = chineseName.substring(0, 2);
        if (COMPOUND_SURNAMES.contains(firstTwo)) {
            surname = firstTwo;
            givenName = chineseName.substring(2);
        } else {
            surname = chineseName.substring(0, 1);
            givenName = chineseName.substring(1);
        }

        // 转拼音（去掉声调，转小写）
        String surnamePinyin = PinyinUtil.getPinyin(surname, "");
        String givenNamePinyin = PinyinUtil.getPinyin(givenName, "");

        return givenNamePinyin + "." + surnamePinyin + "@" + domain;
    }

    /**
     * 仅生成邮箱前缀（不含域名）
     */
    public static String toEmailPrefix(String chineseName) {
        String prefix = toEmail(chineseName, "").replace("@", "");
        // 去除末尾可能多余的点号
        if (prefix.endsWith(".")) {
            prefix = prefix.substring(0, prefix.length() - 1);
        }
        return prefix;
    }
}

使用示例：

工具类 - tag - 沐木