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 而非手动循环