当前位置：首页 > news >正文

Java集合操作：Apache Commons Collections4启示录

news 2025/8/29 6:21:48

01 引言

Java标准库（java.util.Collections）提供了丰富的集合操作工具，但在实际开发中，我们常常会遇到一些更复杂、更繁琐的场景，需要编写大量样板代码。

虽然随着JDK版本的升级，集合的流式操作也变的简洁。但是开发者依然习惯第三方的集合操作工具，用起来更加顺手，如Guava、Hutool、Commons-collections4等。

小编习惯使用Commons-collections4的CollectionUtils.isNotEmpty()来判空，却从未关注里面的其他方法。它里面的很多方法都可以和Guava、HUtool媲美，我们一起看看吧！

02 核心工具类

既然是集合工具类，自然少不了List、Set、Map三大集合的操作，除此之外还有队列、包等工具：

CollectionUtils
ListUtils
SetUtils
MapUtils
ArrayUtils
BagUtils
IterableUtils
QueueUtils

还有其他的一些小的工具类，就不一一列举了。小编就介绍一些被小编遗漏的一些好用的Utils。

<dependency><groupId>org.apache.commons</groupId><artifactId>commons-collections4</artifactId><version>4.4</version> 
</dependency>

2.1 `ListUtils`工具类

这个工具类真的是太香了，不仅可以实现集合的交集、差集、合集、并集等，还可以进行集合分割、检测等操作。

@Test
void listTest() {List<Integer> list = List.of(1, 2, 3, 4, 5);// 集合分割List<List<Integer>> partition = ListUtils.partition(list, 2);System.out.println(partition);// [[1, 2], [3, 4], [5]]List<Integer> list1 = List.of(1, 2, 3);List<Integer> list2 = List.of(3, 4, 5);// 合集[去重]List<Integer> sum = ListUtils.sum(list1, list2);System.out.println(sum);// [1, 2, 3, 4, 5]// 差集List<Integer> subtract = ListUtils.subtract(list1, list2);System.out.println(subtract);// [1, 2]// 并集【不去重】List<Integer> union = ListUtils.union(list1, list2);System.out.println(union);// [1, 2, 3, 3, 4, 5]// 交集List<Integer> intersection = ListUtils.intersection(list1, list2);System.out.println(intersection);// [3]System.out.println("------------------");// 过滤List<Integer> select = ListUtils.select(list, item -> item > 2);System.out.println(select);// [3, 4, 5]List<Integer> list3 = ListUtils.selectRejected(list, item -> item > 2);System.out.println(list3);// [1, 2]// 校验集合List<Integer> list5 = ListUtils.predicatedList(list, item -> item > 0);System.out.println(list5);// [1, 2, 3, 4, 5]// 不影響原來的集合ListUtils.transformedList(list, input -> input + 2).forEach(System.out::println);// 固定集合List<Integer> list7 = ListUtils.fixedSizeList(list);System.out.println(list7);// [1, 2, 3, 4, 5]list7.add(99);// java.lang.UnsupportedOperationException: List is fixed size
}

里面虽然有一些可以通过JDK的流式操作，但不妨碍它的优秀。

2.2 `SetUtils`工具类

少不了的集合操作

@Test
void SetTest() {// 创建Set<Integer> sets = SetUtils.hashSet(1,5,8,9,8);System.out.println(sets);// [1, 5, 8, 9]Set<Integer> set1 = Set.of(1, 2, 5);Set<Integer> set2 = Set.of(2, 3, 6);// 交集SetView<Integer> intersection = SetUtils.intersection(set1, set2);System.out.println(intersection); // [2]// 合集SetView<Integer> union = SetUtils.union(set1, set2);System.out.println(union);// [5, 2, 1, 6, 3]// set1与set2不同的元素SetView<Integer> difference = SetUtils.difference(set1, set2);System.out.println(difference);// [5, 1]// 有序Set<Integer> sets2 = SetUtils.orderedSet(sets);sets2.add(10);sets2.add(7);sets2.forEach(System.out::println);// 1、5、8、9、10、7// 检测Set<Integer> integers = SetUtils.predicatedSet(sets, item -> item > 0);System.out.println(integers);// [1, 5, 7, 8, 9, 10]
}

2.3 `MapUtils`工具类

MapUtils方便主要在于取值，如果Value值为Object类型，就可以直接获取指定类型的值。

@Test
void MapTest() {Map<String, Object> map = Map.of("test1", 1, "test2", 2, "test3", 3);// 取值System.out.println(MapUtils.getString(map, "test1"));// 1// 校验if (MapUtils.isNotEmpty(map)) {// 转化Map<Object, String> objectStringMap = MapUtils.invertMap(map);System.out.println(objectStringMap);// {1=test1, 2=test2, 3=test3}}// 转propertiesProperties properties = MapUtils.toProperties(map);System.out.println(properties);// 空值编程空字符串Map<String, Object> map2 = new HashMap<>(map);MapUtils.safeAddToMap(map2, "test4", null);System.out.println(map2);// {test4=, test2=2, test3=3, test1=1}
}

2.4 `MultiSet`

MultiSet是扩展的集合类，可以存储重复的值，会自动统计个数。

@Test
void mutiSetTest() {MultiSet<String> sets = new HashMultiSet();sets.add("上海");sets.add("北京");sets.add("西安");sets.add("上海");sets.add("西安");System.out.println(sets);// [上海:2, 西安:2, 北京:1]int sh = sets.getCount("上海");System.out.println(sh);// 2
}

2.5 `MultiValuedMap`

MultiValuedMap同样是扩展的Map，相同的Key，对应的值为自动变成List。

@Test
void multiMapTest() {MultiValuedMap<String, Integer> map = new HashSetValuedHashMap<>();map.put("test1", 1);map.put("test2", 2);map.put("test3", 3);map.put("test2", 5);System.out.println(map);// {test2=[5, 2], test3=[3], test1=[1]}List<Integer> valuesAsList = MultiMapUtils.getValuesAsList(map, "test2");System.out.println(valuesAsList);// [5, 2]
}