目录一、工具类功能二、所需环境三、方法与调用示例按需调用四、工具类源码可直接复制一、工具类功能一次遍历把集合摊成 Map按键分组、按键分组并只抽取某个属性、一个键只对应一个值三种形态都有键与组内元素保持原始顺序允许 null 键与 null 值。二、所需环境JDK 17或以上三、方法与调用示例按需调用方法序号1方法用途把一个集合按某个键摊成「键到整组元素」的 Map后面反复按键取比Collectors.groupingBy皮实键为null照样成一组不会当场抛异常方法定义public static T, K MapK, ListT groupBy(Collection? extends T source, Function? super T, ? extends K keyMapper)️入参解释public static T, K MapK, ListT groupBy(源集合, 键提取器)返回值解释MapK, ListT键到该组元素列表键按首次出现顺序排列边界口径结果是新建的LinkedHashMap组内列表也是新对象改结果不回写源集合键提取器返回null时null就是一个正常的键元素本身是null时怎么走由提取器决定兜得住就成组写成User::dept这种方法引用就抛NullPointerExceptionsource传null或空集合都返回可变的空 Map能直接put不会一会儿能用一会儿抛keyMapper传null抛NullPointerException: keyMapper 不能为 null方法示例groupBy(users, User::dept)按部门分组拿到{tech[User[id1, depttech, nameTom, age30], User[id3, depttech, nameBen, age28]], sale[User[id2, deptsale, nameAmy, agenull]], hr[User[id4, depthr, nameCid, age30]]}groupBy(List.of(new User(9L, null, 新同事, 25)), User::dept)拿到{null[User[id9, deptnull, name新同事, age25]]}部门为空也正常成一组groupBy(dirty, u - u null ? 无 : u.dept())拿到多出的一条无[null]null元素归进兜底键下groupBy(dirty, User::dept)抛NullPointerException提取器没兜住null元素groupBy(null, User::dept)之后put(x, new ArrayList())写得进去拿到{x[]}groupBy(users, null)抛NullPointerException: keyMapper 不能为 null方法序号2方法用途按键分组的同时只抽出想要的那个属性得到「键到属性列表」按部门看名单、按订单号看 SKU 这类投影不用先分组再对每组 map 一遍方法定义public static T, K, V MapK, ListV groupValueBy(Collection? extends T source, Function? super T, ? extends K keyMapper, Function? super T, ? extends V valueMapper)️入参解释public static T, K, V MapK, ListV groupValueBy(源集合, 键提取器, 值提取器)返回值解释MapK, ListV键到抽取出来的值列表边界口径值提取器返回null时列表里就是一个null元素位置保留、不会被抹掉键与组的顺序口径同方法1组内列表同样是新对象改它不影响源集合source为null返回可变的空 MapkeyMapper或valueMapper传null抛NullPointerException消息带上参数名方法示例groupValueBy(users, User::dept, User::name)拿到{tech[Tom, Ben], sale[Amy], hr[Cid]}groupValueBy(users, User::dept, User::age)拿到{tech[30, 28], sale[null], hr[30]}Amy 的年龄是null也占一位groupValueBy(users, User::dept, User::name)之后往tech那组add一个名字源集合大小仍是 4groupValueBy(users, User::dept, null)抛NullPointerException: valueMapper 不能为 null方法序号3方法用途把一个集合摊成「一键一值」的索引 Map键重复时留后出现的值建好 ID 到姓名这类索引后按键直接取比每次stream().filter()扫一遍省事方法定义public static T, K, V MapK, V toMap(Collection? extends T source, Function? super T, ? extends K keyMapper, Function? super T, ? extends V valueMapper)️入参解释public static T, K, V MapK, V toMap(源集合, 键提取器, 值提取器)返回值解释MapK, V键到单值键按首次出现顺序排列边界口径重复键保留后出现的值前一个直接被覆盖不抛IllegalStateException值可以是null键也可以是null这与Collectors.toMap遇null值就抛NullPointerException相反值为null时键仍然存在containsKey给trueget拿到的是null键的顺序按首次出现算后面重复把值换掉也不会把它挪到末尾source为null返回可变的空 Map两个提取器任一为null抛NullPointerException方法示例toMap(users, User::id, User::name)拿到{1Tom, 2Amy, 3Ben, 4Cid}toMap(users, User::id, User::age)拿到{130, 2null, 328, 430}键2的containsKey是truetoMap(dup, User::id, User::name)拿到{1后者}重复键留后面那条toMap(rows, User::id, User::name)拿到{3三重, 1一}键 3 重复过也仍排在第一位toMap(rows, User::id, User::name)拿到{null没ID, 1Tom}null键照样收toMap(null, User::id, User::name)之后put(9, 新)写得进去拿到{9新}toMap(users, null, User::name)抛NullPointerException: keyMapper 不能为 null方法序号4方法用途摊成「一键一值」的 Map同时把重复键怎么合交给自己的合并函数重复键不再只能二选一留首个、求和、拼接都能一行写完方法定义public static T, K, V MapK, V toMap(Collection? extends T source, Function? super T, ? extends K keyMapper, Function? super T, ? extends V valueMapper, BinaryOperatorV mergeFunction)️入参解释public static T, K, V MapK, V toMap(源集合, 键提取器, 值提取器, 重复键合并函数)返回值解释MapK, V键到合并后的单值边界口径合并函数的两个入参依次是「Map 里已有的值」与「这次的 new 值」多条重复按从左往右依次折叠合并函数返回null时这个键仍然存在、只是值为null与Map#merge返回null就删键不同实现是按containsKey判重的方法3 就是把这个参数写成「取新值」的快捷入口source为null返回可变的空 Map三个函数任一为null抛NullPointerException方法示例toMap(duplicated, User::id, User::name, (oldValue, newValue) - oldValue)拿到{1首个}重复键改成留第一个toMap(List.of(1, 2, 1, 3, 2), n - n, n - n, Integer::sum)拿到{12, 24, 33}同一个数出现几次就加几次toMap(three, User::id, User::name, (oldValue, newValue) - oldValue / newValue)拿到{1首个/后者/第三个}三条重复值从左往右依次折叠toMap(dup, User::id, User::name, (oldValue, newValue) - null)拿到{1null}键没被删掉containsKey仍是truetoMap(users, User::id, User::name, null)抛NullPointerException: mergeFunction 不能为 null四、工具类源码可直接复制领取方式 关注点赞收藏私信回复「java工具类」可领取100个工具类「Java企业级工具类全家桶1-100」的完整源码。 工具类已调试通过复制粘贴即可使用省时省力 可保存到自己网盘永久有效觉得对您有帮助麻烦点点关注啦您的关注是我创作的最大动力~