Hutool CollUtil 教程

Hutool 提供了强大的集合工具类 CollUtil ,位于 cn.hutool.core.collection.CollUtil 包下。以下是常用功能:

1. 集合判空/非空

java 复制代码
// 判断是否为null或空集合
CollUtil.isEmpty(list);     // true/false
CollUtil.isNotEmpty(list);  // 反向

// 判断是否为null
CollUtil.isNull(list);
CollUtil.isNotNull(list);

2. 创建集合

java 复制代码
// 创建ArrayList
List<String> list = CollUtil.newArrayList("a", "b", "c");

// 创建HashSet
Set<String> set = CollUtil.newHashSet("a", "b", "c");

// 创建ConcurrentHashMap
Map<String, String> map = CollUtil.newConcurrentHashMap();

// 创建阻塞队列
BlockingQueue<String> queue = CollUtil.newBlockingQueue(10);

3. 集合交并差操作

java 复制代码
List<String> list1 = CollUtil.newArrayList("a", "b", "c");
List<String> list2 = CollUtil.newArrayList("b", "c", "d");

// 交集 [b, c]
Collection<String> intersection = CollUtil.intersection(list1, list2);

// 并集 [a, b, c, d]
Collection<String> union = CollUtil.union(list1, list2);

// 差集(list1中有但list2中没有)[a]
Collection<String> subtract = CollUtil.subtract(list1, list2);

// 补集(对称差)[a, d]
Collection<String> disjunction = CollUtil.disjunction(list1, list2);

4. 分组和转换

java 复制代码
// 按条件分组
List<User> users = CollUtil.newArrayList(user1, user2, user3);
Map<String, List<User>> groupMap = CollUtil.groupBy(users, User::getDeptId);

// 集合转Map(key为某个属性)
Map<Long, User> userMap = CollUtil.toMap(users, User::getId, User::getName);

// 集合转数组
String[] array = CollUtil.toArray(list, String.class);

5. 安全获取元素

java 复制代码
// 安全获取第N个元素(支持负索引,从后往前)
String first = CollUtil.get(list, 0);
String last = CollUtil.get(list, -1);

// 获取第一个非null元素
String result = CollUtil.getFirstNoneNull(list);

// 获取最后一个元素
String last = CollUtil.last(list);

6. 集合排序和去重

java 复制代码
// 去重(保持顺序)
List<String> distinct = CollUtil.distinct(list);

// 反向排序
List<String> reverse = CollUtil.reverse(list);

// 根据字段排序
CollUtil.sortByProperty(userList, "age");      // 正序
CollUtil.sortByProperty(userList, "age", true); // 降序

7. 集合统计

java 复制代码
// 判断是否包含所有元素
boolean containsAll = CollUtil.containsAll(list1, list2);

// 获取元素出现次数
Map<String, Integer> countMap = CollUtil.countMap(list);

// 分组并计数
Map<String, Long> groupCount = CollUtil.groupByCount(users, User::getDeptId);

8. 其他实用方法

java 复制代码
// 两个列表合并
List<String> merged = CollUtil.addAll(list1, list2);

// 分页(每页10条)
List<List<String>> pages = CollUtil.splitList(list, 10);

// 过滤(保留符合条件的元素)
CollUtil.filter(list, t -> t.length() > 2);

// 转为字符串(分隔符)
String str = CollUtil.join(list, ",");  // "a,b,c"

// 移除null元素
CollUtil.removeNull(list);

9. 迭代器工具

java 复制代码
// 遍历迭代器
Iterator<String> it = list.iterator();
CollUtil.forEach(it, (index, value) -> {
    System.out.println(index + ":" + value);
});

// 将迭代器转为List
List<String> newList = CollUtil.toList(it);

推荐用法:

  • 日常判空用 CollUtil.isNotEmpty()

  • 创建集合用 CollUtil.newArrayList() 等,比 new ArrayList<>() 更简洁

  • 集合操作优先使用 CollUtil 而非手动循环

相关推荐
Dmz丶3 分钟前
前端转 AI 100 天 Day 49:文档切分——RAG 效果的隐形开关
python
一切皆有可能!!18 分钟前
【SoduWork测评】本机跑源码,找到并修了7个Bug
windows·开源·bug·ai编程·soduwork
jianqiang.xue26 分钟前
把Agent塞进MCU:工具次数和上下文长度怎么卡
java·前端·网络·单片机·esp32·ai编程
布莱克60530 分钟前
Swift 闭包详解:从语法到实战的完整指南
服务器·开发语言·ios·ssh·swift·闭包
xx z31 分钟前
打开游戏提示 d3dx9_43.dll 缺失怎么办(DirectX 修复步骤)
windows·游戏·工具·软件
青少儿编程课堂1 小时前
第十八届蓝桥杯青少组图形化真题 + 全国青少年信息素养大赛 + 电子学会图形化考级:校园泡泡堂大挑战解析
c++·python·算法·bfs·信息学竞赛
ikgy2 小时前
JAVA EE:4.多线程核心组件实战
java·java-ee
小七在进步2 小时前
string的实现(3)
开发语言·c++·笔记·visual studio
Starry-sky(jing)2 小时前
Hermes Agent 升级 v0.23.2:先辨更新渠道,再看 CLI 退出残留修复
人工智能·python·ai agent
杨凯凡2 小时前
IT日报|2026-11-19:Oracle Java 紧急补丁、Optimizely 供应链攻击、GitHub 安全评估升级
java·oracle·github