代码——Apache集合类和amp;字符串工具包实用的API

本篇介绍Apache集合类&字符串工具包中实用的API，很多sonar中的NPE问题都可以用Apache工具包来解决，代码的可读性也会得到提升；

Maven依赖

1.  
   <dependency>
2.  
   <groupId>commons-collections</groupId>
3.  
   <artifactId>commons-collections4</artifactId>
4.  
   </dependency>
5.  
   <dependency>
6.  
   <groupId>org.apache.commons</groupId>
7.  
   <artifactId>commons-lang3</artifactId>
8.  
   </dependency>

1. MapUtils

Map判空：MapUtils.isNotEmpty，API已经帮我们做了非空判断，无需自己写非空判断；

示例：

1.  
   @Test
2.  
   public void testMapUtils() {
3.  
   final HashMap<Object, Object> emptyMap = Maps.newHashMap();
4.  
   final HashMap<Object, Object> nullMap = null;
5.  
    
6.  
   System.out.println(MapUtils.isNotEmpty(emptyMap));
7.  
   System.out.println(MapUtils.isNotEmpty(emptyMap));
8.  
   // MapUtils.isNotEmpty等价于下面的写法 直接使用java.util.HashMap#isEmpty可能会导致NPE
9.  
   System.out.println(nullMap != null && !emptyMap.isEmpty());
10.  
    }

Map取值：MapUtils.getIntValue之类，帮助完成Map取value时的类型转换，无需自己写XX.valueOf(xx)或类型强转；

示例：

1.  
   @Test
2.  
   public void testMapUtils2() {
3.  
   final HashMap<String, Object> map = Maps.newHashMap();
4.  
   map.put("int", 123);
5.  
   map.put("long", 99999L);
6.  
   map.put("string", "hello");
7.  
   map.put("boolean", Boolean.TRUE);
8.  
   map.put("booleanInt", 0);
9.  
    
10.  
    final int anInt = MapUtils.getIntValue(map, "int", 0);
11.  
    // MapUtils.getIntValue等价于下面的写法 且类型强转可能抛出异常
12.  
    int intValue = map.get("int") == null ? 0 : (Integer) map.get("int");
13.  
     
14.  
    System.out.println(anInt); // [输出]123
15.  
    System.out.println(intValue); // [输出]123
16.  
     
17.  
    final boolean booleanValue = MapUtils.getBooleanValue(map, "int");
18.  
    final boolean booleanIntValue = MapUtils.getBooleanValue(map, "booleanInt");
19.  
    // 注意getBoolean的逻辑：若为Boolean型/boolean字符串则直接转换，否则判断是否数值型——不等于0返回true，等于0返回false；都不满足则返回默认的false
20.  
    System.out.println(map.get("int") "的getBooleanValue的结果: " booleanValue); // [输出]123的getBooleanValue的结果: true
21.  
    System.out.println(map.get("booleanInt") "的getBooleanValue的结果: " booleanIntValue); // [输出]0的getBooleanValue的结果: false
22.  
    }

需要注意的是，类型转换中，尽管MapUtils封装了对类型转换异常的捕获以及赋值默认值，还需要注意特殊类型Boolean的取值逻辑，如果强行对数值型取boolean，会有判断非零的逻辑，见上面的例子；

2. CollectionUtils

集合判空：CollectionUtils.isNotEmpty，最常用的就是List和Set，实际上实现了Collection接口的集合类都可以判断，包含判null和空集合；

示例：

1.  
   @Test
2.  
   public void testCollectionUtils() {
3.  
   final List<String> list = Lists.newArrayList("a","a","b","c");
4.  
   final Set<String> set = Sets.newHashSet(list);
5.  
   final List<String> emptyList = Collections.emptyList();
6.  
    
7.  
   System.out.println(CollectionUtils.isNotEmpty(list)); // [输出]true
8.  
   System.out.println(CollectionUtils.isNotEmpty(set)); // [输出]true
9.  
   System.out.println(CollectionUtils.isNotEmpty(emptyList)); // [输出]false
10.  
    }

集合相等判断：CollectionUtils.isEqualCollection，对于List或Set，判断元素集是否一致，这个方法很实用，自己少写很多代码；

示例：

1.  
   @Test
2.  
   public void testCollectionUtils1() {
3.  
   final HashSet<String> setA = Sets.newHashSet();
4.  
   final HashSet<String> setA1 = Sets.newHashSet();
5.  
   final HashSet<String> setB = Sets.newHashSet();
6.  
    
7.  
   setA.add("a");
8.  
   setA.add("b");
9.  
   setA.add("c");
10.  
     
11.  
    setA1.add("b");
12.  
    setA1.add("a");
13.  
    setA1.add("c");
14.  
     
15.  
    setB.add("b");
16.  
    setB.add("c");
17.  
    setB.add("d");
18.  
     
19.  
    final ArrayList<String> listA = Lists.newArrayList("a", "b", "c");
20.  
    final ArrayList<String> listA1 = Lists.newArrayList("c", "a", "b");
21.  
     
22.  
    System.out.println(JSON.toJSONString(CollectionUtils.isEqualCollection(setA, setB))); // [输出]false
23.  
    System.out.println(JSON.toJSONString(CollectionUtils.isEqualCollection(setA, setA1))); // [输出]true
24.  
    // 集合相等判断与元素顺序无关
25.  
    System.out.println(JSON.toJSONString(CollectionUtils.isEqualCollection(listA, listA1))); // [输出]true
26.  
    // 集合相等判断与元素数量有关
27.  
    listA1.add("a");
28.  
    System.out.println(JSON.toJSONString(CollectionUtils.isEqualCollection(listA, listA1))); // [输出]false
29.  
    // 集合相等判断可以跨类型 如List与Set
30.  
    System.out.println(JSON.toJSONString(CollectionUtils.isEqualCollection(listA, setA))); // [输出]true
31.  
     
32.  
    }

是否子集判断：CollectionUtils.isSubCollection，对于List或Set，判断A是否B的子集，这个方法也很实用；子集的定义：若A是B的子集，则A中每个元素的数量都小于或等于该元素在B中的数量； 还有一个方法CollectionUtils.isProperSubCollection，判断A是否B的严格子集，即在A是B的子集的基础上，要求集合A的总元素数量必须小于B集合；

示例：

1.  
   @Test
2.  
   public void testCollectionUtils1() {
3.  
    
4.  
   final HashSet<String> setSub = Sets.newHashSet();
5.  
   final HashSet<String> setAll = Sets.newHashSet();
6.  
   setSub.add("a");setSub.add("b");setSub.add("c");
7.  
   setAll.add("a");setAll.add("b");setAll.add("c");setAll.add("d");
8.  
    
9.  
   // 子集的定义是：若A是B的子集，则A中每个元素的数量都小于等于该元素在B中的数量；
10.  
    System.out.println(JSON.toJSONString("是否子集：" CollectionUtils.isSubCollection(setSub, setAll)));
11.  
    // 严格子集的定义是：在子集的基础上，A的元素数量要小于B；
12.  
    System.out.println(JSON.toJSONString("是否严格子集：" CollectionUtils.isSubCollection(setSub, setSub)));
13.  
    System.out.println(JSON.toJSONString("是否严格子集：" CollectionUtils.isSubCollection(setSub, setAll)));
14.  
    // 若A中某元素在B中不存在，则必不是子集
15.  
    setSub.add("e");
16.  
    System.out.println(JSON.toJSONString("是否子集：" CollectionUtils.isSubCollection(setSub, setAll)));
17.  
    // 子集判断可以跨类型 如List与Set
18.  
    final ArrayList<String> listSub = Lists.newArrayList("a", "b");
19.  
    System.out.println(JSON.toJSONString("是否子集：" CollectionUtils.isSubCollection(listSub, setAll)));
20.  
    listSub.add("a");
21.  
    System.out.println(JSON.toJSONString("是否子集：" CollectionUtils.isSubCollection(listSub, setAll)));
22.  
     
23.  
    }

差集：CollectionUtils.subtract，集合A相比集合B，多出来的元素；

交集：CollectionUtils.intersection，集合A和集合B的交集；

示例：

1.  
   @Test
2.  
   public void testCollectionUtils1() {
3.  
   final HashSet<String> setA = Sets.newHashSet();
4.  
   final HashSet<String> setB = Sets.newHashSet();
5.  
    
6.  
   setA.add("a");
7.  
   setA.add("b");
8.  
   setA.add("c");
9.  
    
10.  
    setB.add("b");
11.  
    setB.add("c");
12.  
    setB.add("d");
13.  
     
14.  
    final ArrayList<String> listA = Lists.newArrayList("a", "b", "c");
15.  
    final ArrayList<String> listB = Lists.newArrayList("c", "a", "b", "e");
16.  
     
17.  
    // 差集-A比B多的元素
18.  
    System.out.println(JSON.toJSONString(CollectionUtils.subtract(setA, setB))); // [输出] ["a"]
19.  
    // 差集-B比A多的元素
20.  
    System.out.println(JSON.toJSONString(CollectionUtils.subtract(setB, setA))); // [输出] ["d"]
21.  
     
22.  
    System.out.println(JSON.toJSONString(CollectionUtils.subtract(listB, listA))); // [输出] ["e"]
23.  
    System.out.println(JSON.toJSONString(CollectionUtils.subtract(listA, listB))); // [输出] []
24.  
     
25.  
    // A与B的交集
26.  
    System.out.println(JSON.toJSONString(CollectionUtils.intersection(setB, setA))); // [输出] ["b","c"]
27.  
    }

3. StringUtils

字符串相等：StringUtils.equals，含判空逻辑，避免使用 == 或 equal() 导致的NPE问题，非常实用；

非空串判断：StringUtils.isNotEmpty，null及空字符串都会判为true；

非空串及空格判断：StringUtils.isNotBlank，null及空字符串、全空格都会判为true；

示例：

1.  
   @Test
2.  
   public void testStringUtils() {
3.  
   String nullStr1 = null;
4.  
   String nullStr2 = null;
5.  
   String strA = "A";
6.  
   String strB = "B";
7.  
    
8.  
   // 字符串等值判断 含null值判断
9.  
   System.out.println(StringUtils.equals(nullStr1, nullStr2)); // [输出]true
10.  
    System.out.println(StringUtils.equals(strA, nullStr2)); // [输出]false
11.  
    System.out.println(StringUtils.equals(strA, strB)); // [输出]false
12.  
     
13.  
    String emptyStr = "";
14.  
    String blankStr1 = " ";
15.  
    String blankStr2 = "\n\t";
16.  
     
17.  
    // 字符串非空串判断 空格和控制符都不算空串
18.  
    System.out.println(StringUtils.isNotEmpty(nullStr1)); // [输出]false
19.  
    System.out.println(StringUtils.isNotEmpty(emptyStr)); // [输出]false
20.  
    System.out.println(StringUtils.isNotEmpty(blankStr1)); // [输出]true
21.  
    System.out.println(StringUtils.isNotEmpty(blankStr2)); // [输出]true
22.  
     
23.  
    // 字符串非空串及空格判断 空格和控制符都满足过滤条件
24.  
    System.out.println(StringUtils.isNotBlank(nullStr1)); // [输出]false
25.  
    System.out.println(StringUtils.isNotBlank(emptyStr)); // [输出]false
26.  
    System.out.println(StringUtils.isNotBlank(blankStr1)); // [输出]false
27.  
    System.out.println(StringUtils.isNotBlank(blankStr2)); // [输出]false
28.  
    }

去除字符串首尾的控制符：StringUtils.trim，含判空，无需调用可能导致NPE的String#trim；

去除字符串中所有的空白符：StringUtils.isNotBlank，含判空，无需调用可能导致NPE的String#replaceAll；

字符串简单反转：StringUtils.reverse，含判空，将指定字符串的字符倒序输出；

示例：

1.  
   @Test
2.  
   public void testStringUtils1() {
3.  
   String nullStr1 = null;
4.  
   String str1 = " a b \n\t c \n";
5.  
   String str2 = "abc \n\t efg";
6.  
    
7.  
   // 去除首尾空串和控制符
8.  
   System.out.println(str1);
9.  
   System.out.println(StringUtils.trim(str1));
10.  
    // 兼容null
11.  
    System.out.println(nullStr1);
12.  
    System.out.println(StringUtils.trim(nullStr1)); // 输出null，无需自己做判空逻辑
13.  
    /* System.out.println(nullStr1.trim()); 会产生NPE*/
14.  
     
15.  
    // 去除全部空串和控制符
16.  
    System.out.println(str1);
17.  
    System.out.println(StringUtils.deleteWhitespace(str1));
18.  
    // 兼容null
19.  
    System.out.println(nullStr1);
20.  
    System.out.println(StringUtils.deleteWhitespace(nullStr1)); // 输出null，无需自己做判空逻辑
21.  
     
22.  
    // 字符反转且控制符也会反转
23.  
    System.out.println(str2);
24.  
    System.out.println(StringUtils.reverse(str2));
25.  
    // 兼容null
26.  
    System.out.println(nullStr1);
27.  
    System.out.println(StringUtils.reverse(nullStr1)); // 输出null，无需自己做判空逻辑
28.  
    }

本文仅介绍使用过的认为常用的API，Apache工具包中还有一些功能更强大的API，这里不再展开一个一个地介绍，有兴趣可以自己去看源码学习；

这篇好文章是转载于：学新通技术网