commons-lang使用

跟java.lang这个包的作用类似，Commons Lang这一组API也是提供一些基础的、通用的操作和处理，如自动生成toString()的结果、自动实现hashCode()和equals()方法、数组操作、枚举、日期和时间的处理等等。

 

这一组API的所有包名都以org.apache.commons.lang开头，共有如下8个包：

 

org.apache.commons.lang

org.apache.commons.lang.builder

org.apache.commons.lang.enum

org.apache.commons.lang.enums

org.apache.commons.lang.exception

org.apache.commons.lang.math

org.apache.commons.lang.mutable

org.apache.commons.lang.time

 

其中的lang.enum已不建议使用，替代它的是紧随其后的lang.enums包。 lang包主要是一些可以高度重用的Util类；lang.builder包包含了一组用于产生每个Java类中都常使用到的toString()、hashCode()、equals()、compareTo()等等方法的构造器；lang.enums包顾名思义用于处理枚举；lang.exception包用于处理Java标准API中的exception，为1.4之前版本提供Nested Exception功能；lang.math包用于处理数字；lang.mutable用于包装值型变量；lang.time包提供处理日期和时间的功能。

 

由于Commons的包和类实在很多，不可能一个一个讲了，在接下来的专题文章中我就只分别过一下lang、lang.builder、lang.math和lang.time这几个包和常见的用法，其他的我们可以在用到时临时参考一下Javadoc。位置就在安装路径的

…/commons-lang-2.1/docs/api/index.html

 

我们首先来看org.apache.commons.lang包，这个包提供了一些有用的包含static方法的Util类。除了6个Exception类和2个已经deprecated的数字类之外，commons.lang包共包含了17个实用的类：

 

ArrayUtils – 用于对数组的操作，如添加、查找、删除、子数组、倒序、元素类型转换等；

BitField – 用于操作位元，提供了一些方便而安全的方法；

BooleanUtils – 用于操作和转换boolean或者Boolean及相应的数组；

CharEncoding – 包含了Java环境支持的字符编码，提供是否支持某种编码的判断；

CharRange – 用于设定字符范围并做相应检查；

CharSet – 用于设定一组字符作为范围并做相应检查；

CharSetUtils – 用于操作CharSet；

CharUtils – 用于操作char值和Character对象；

ClassUtils – 用于对Java类的操作，不使用反射；

ObjectUtils – 用于操作Java对象，提供null安全的访问和其他一些功能；

RandomStringUtils – 用于生成随机的字符串；

SerializationUtils – 用于处理对象序列化，提供比一般Java序列化更高级的处理能力；

StringEscapeUtils – 用于正确处理转义字符，产生正确的Java、JavaScript、HTML、XML和SQL代码；

StringUtils – 处理String的核心类，提供了相当多的功能；

SystemUtils – 在java.lang.System基础上提供更方便的访问，如用户路径、Java版本、时区、操作系统等判断；

Validate – 提供验证的操作，有点类似assert断言；

WordUtils – 用于处理单词大小写、换行等。

 

下面讲下最常用的两个类

ArrayUtils

数组是我们经常需要使用到的一种数据结构，但是由于Java本身并没有提供很好的API支持，使得很多操作实际上做起来相当繁琐，以至于我们实际编码中甚至会不惜牺牲性能去使用Collections API，用Collection当然能够很方便的解决我们的问题，但是我们一定要以性能为代价吗？ArrayUtils帮我们解决了处理类似情况的大部分问题。来看一个例子：

[java]  view plain copy

1. package sean.study.jakarta.commons.lang;  
2.   
3.    
4.   
5. import java.util.Map;  
6.   
7. import org.apache.commons.lang.ArrayUtils;  
8.   
9.    
10.   
11. public class ArrayUtilsUsage {  
12.   
13.    
14.   
15.     public static void main(String[] args) {  
16.   
17.    
18.   
19.         // data setup  
20.   
21.         int[] intArray1 = { 2, 4, 8, 16 };  
22.   
23.         int[][] intArray2 = { { 1, 2 }, { 2, 4 }, { 3, 8 }, { 4, 16 } };  
24.   
25.         Object[][] notAMap = {   
26.   
27.                 { "A", new Double(100) },  
28.   
29.                 { "B", new Double(80) },   
30.   
31.                 { "C", new Double(60) },  
32.   
33.                 { "D", new Double(40) },   
34.   
35.                 { "E", new Double(20) }   
36.   
37.         };  
38.   
39.    
40.   
41.         // printing arrays  
42.   
43.         System.out.println("intArray1: " + ArrayUtils.toString(intArray1));  
44.   
45.         System.out.println("intArray2: " + ArrayUtils.toString(intArray2));  
46.   
47.         System.out.println("notAMap: " + ArrayUtils.toString(notAMap));  
48.   
49.    
50.   
51.         // finding items  
52.   
53.         System.out.println("intArray1 contains '8'? "  
54.   
55.                 + ArrayUtils.contains(intArray1, 8));  
56.   
57.         System.out.println("intArray1 index of '8'? "  
58.   
59.                 + ArrayUtils.indexOf(intArray1, 8));  
60.   
61.         System.out.println("intArray1 last index of '8'? "  
62.   
63.                 + ArrayUtils.lastIndexOf(intArray1, 8));  
64.   
65.    
66.   
67.         // cloning and resversing  
68.   
69.         int[] intArray3 = ArrayUtils.clone(intArray1);  
70.   
71.         System.out.println("intArray3: " + ArrayUtils.toString(intArray3));  
72.   
73.         ArrayUtils.reverse(intArray3);  
74.   
75.         System.out.println("intArray3 reversed: "  
76.   
77.                 + ArrayUtils.toString(intArray3));  
78.   
79.    
80.   
81.         // primitive to Object array  
82.   
83.         Integer[] integerArray1 = ArrayUtils.toObject(intArray1);  
84.   
85.         System.out.println("integerArray1: "  
86.   
87.                 + ArrayUtils.toString(integerArray1));  
88.   
89.    
90.   
91.         // build Map from two dimensional array  
92.   
93.         Map map = ArrayUtils.toMap(notAMap);  
94.   
95.         Double res = (Double) map.get("C");  
96.   
97.         System.out.println("get 'C' from map: " + res);  
98.   
99.    
100.   
101.     }  
102.   
103.    
104.   
105. }  
106.   
107.    
108.   
109. 以下是运行结果：  
110.   
111.    
112.   
113. intArray1: {2,4,8,16}  
114.   
115. intArray2: {{1,2},{2,4},{3,8},{4,16}}  
116.   
117. notAMap: {{A,100.0},{B,80.0},{C,60.0},{D,40.0},{E,20.0}}  
118.   
119. intArray1 contains '8'? true  
120.   
121. intArray1 index of '8'? 2  
122.   
123. intArray1 last index of '8'? 2  
124.   
125. intArray3: {2,4,8,16}  
126.   
127. intArray3 reversed: {16,8,4,2}  
128.   
129. integerArray1: {2,4,8,16}  
130.   
131. get 'C' from map: 60.0  

这段代码说明了我们可以如何方便的利用ArrayUtils类帮我们完成数组的打印、查找、克隆、倒序、以及值型/对象数组之间的转换等操作。

 

StringUtils

处理文本对Java应用来说应该算是家常便饭了，在1.4出现之前，Java自身提供的API非常有限，如String、StringTokenizer、StringBuffer，操作也比较单一。无非就是查找substring、分解、合并等等。到1.4的出现可以说Java的文字处理上了一个台阶，因为它支持regular expression了。这可是个重量级而方便的东东啊，缺点是太复杂，学习起来有一定难度。相较而言，Jakarta Commons提供的StringUtils和WordUtils至今还维持着那种简洁而强大的美，使用起来也很顺手。来看一个例子： 

[java]  view plain copy

1. package sean.study.jakarta.commons.lang;  
2.   
3.    
4.   
5. import org.apache.commons.lang.StringUtils;  
6.   
7.    
8.   
9. public class StringUtilsAndWordUtilsUsage {  
10.   
11.    
12.   
13.     public static void main(String[] args) {  
14.   
15.           
16.   
17.         // data setup  
18.   
19.         String str1 = "";  
20.   
21.         String str2 = " ";  
22.   
23.         String str3 = "/t";  
24.   
25.         String str4 = null;  
26.   
27.         String str5 = "123";  
28.   
29.         String str6 = "ABCDEFG";  
30.   
31.         String str7 = "It feels good to use Jakarta Commons./r/n";  
32.   
33.           
34.   
35.         // check for empty strings  
36.   
37.         System.out.println("==============================");  
38.   
39.         System.out.println("Is str1 blank? " + StringUtils.isBlank(str1));  
40.   
41.         System.out.println("Is str2 blank? " + StringUtils.isBlank(str2));  
42.   
43.         System.out.println("Is str3 blank? " + StringUtils.isBlank(str3));  
44.   
45.         System.out.println("Is str4 blank? " + StringUtils.isBlank(str4));  
46.   
47.           
48.   
49.         // check for numerics  
50.   
51.         System.out.println("==============================");  
52.   
53.         System.out.println("Is str5 numeric? " + StringUtils.isNumeric(str5));  
54.   
55.         System.out.println("Is str6 numeric? " + StringUtils.isNumeric(str6));  
56.   
57.           
58.   
59.         // reverse strings / whole words  
60.   
61.         System.out.println("==============================");  
62.   
63.         System.out.println("str6: " + str6);  
64.   
65.         System.out.println("str6 reversed: " + StringUtils.reverse(str6));  
66.   
67.         System.out.println("str7: " + str7);  
68.   
69.         String str8 = StringUtils.chomp(str7);  
70.   
71.         str8 = StringUtils.reverseDelimited(str8, ' ');  
72.   
73.         System.out.println("str7 reversed whole words : /r/n" + str8);  
74.   
75.           
76.   
77.         // build header (useful to print log messages that are easy to locate)  
78.   
79.         System.out.println("==============================");  
80.   
81.         System.out.println("print header:");  
82.   
83.         String padding = StringUtils.repeat("=", 50);  
84.   
85.         String msg = StringUtils.center(" Customised Header ", 50, "%");  
86.   
87.         Object[] raw = new Object[]{padding, msg, padding};  
88.   
89.         String header = StringUtils.join(raw, "/r/n");  
90.   
91.         System.out.println(header);  
92.   
93.    
94.   
95.     }  
96.   
97. }  
98.   
99.    
100.   
101. 输出的结果如下：  
102.   
103.    
104.   
105. ==============================  
106.   
107. Is str1 blank? true  
108.   
109. Is str2 blank? true  
110.   
111. Is str3 blank? true  
112.   
113. Is str4 blank? true  
114.   
115. ==============================  
116.   
117. Is str5 numeric? true  
118.   
119. Is str6 numeric? false  
120.   
121. ==============================  
122.   
123. str6: ABCDEFG  
124.   
125. str6 reversed: GFEDCBA  
126.   
127. str7: It feels good to use Jakarta Commons.  
128.   
129.    
130.   
131. str7 reversed whole words :   
132.   
133. Commons. Jakarta use to good feels It  
134.   
135. ==============================  
136.   
137. print header:  
138.   
139. ==================================================  
140.   
141. %%%%%%%%%%%%%%% Customised Header %%%%%%%%%%%%%%%%  
142.   
143. ==================================================  

从代码中我们可以大致了解到这个StringUtils类简单而强大的处理能力，从检查空串（对null的情况处理很得体），到分割子串，到生成格式化的字符串，使用都很简洁，也很直截了当。

1)Commons Lang是对JDK中java.lang包的补充，提供了各种各样的Utilities工具类，这里说说最常用的几个工具类。

版本：commons-lang3-3.1.jar 

1、字符串的空判断 

?

1 2 3 4 5 6 7 8 9 10 11 12 13

//isEmpty System.out.println(StringUtils.isEmpty( null ));       // true System.out.println(StringUtils.isEmpty( "" ));         // true System.out.println(StringUtils.isEmpty( " " ));        // false System.out.println(StringUtils.isEmpty( "bob" ));      // false System.out.println(StringUtils.isEmpty( "  bob  " ));  // false   //isBlank System.out.println(StringUtils.isBlank( null ));       // true System.out.println(StringUtils.isBlank( "" ));         // true System.out.println(StringUtils.isBlank( " " ));        // true System.out.println(StringUtils.isBlank( "bob" ));      // false System.out.println(StringUtils.isBlank( "  bob  " ));  // false

2、字符串的Trim  

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23

//trim System.out.println(StringUtils.trim( null ));  // null System.out.println(StringUtils.trim( "" ));  // "" System.out.println(StringUtils.trim( "     " ));  // "" System.out.println(StringUtils.trim( "abc" ));  // "abc" System.out.println(StringUtils.trim( "    abc" ));  // "abc" System.out.println(StringUtils.trim( "    abc  " ));  // "abc" System.out.println(StringUtils.trim( "    ab c  " ));  // "ab c"   //strip System.out.println(StringUtils.strip( null ));  // null System.out.println(StringUtils.strip( "" ));  // "" System.out.println(StringUtils.strip( "   " ));  // "" System.out.println(StringUtils.strip( "abc" ));  // "abc" System.out.println(StringUtils.strip( "  abc" ));  // "abc" System.out.println(StringUtils.strip( "abc  " ));  // "abc" System.out.println(StringUtils.strip( " abc " ));  // "abc" System.out.println(StringUtils.strip( " ab c " ));  // "ab c"    System.out.println(StringUtils.strip( "  abcyx" ,  "xyz" ));  // "  abc"   System.out.println(StringUtils.stripStart( "yxabcxyz  " ,  "xyz" ));  // "abcxyz  " System.out.println(StringUtils.stripEnd( "  xyzabcyx" ,  "xyz" ));  // "  xyzabc"

3、字符串的分割  

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42

//默认半角空格分割 String str1 =  "aaa bbb ccc" ; String[] dim1 = StringUtils.split(str1);  // => ["aaa", "bbb", "ccc"]   System.out.println(dim1.length); //3 System.out.println(dim1[0]); //"aaa" System.out.println(dim1[1]); //"bbb" System.out.println(dim1[2]); //"ccc"   //指定分隔符 String str2 =  "aaa,bbb,ccc" ; String[] dim2 = StringUtils.split(str2,  "," );  // => ["aaa", "bbb", "ccc"]   System.out.println(dim2.length); //3 System.out.println(dim2[0]); //"aaa" System.out.println(dim2[1]); //"bbb" System.out.println(dim2[2]); //"ccc"   //去除空字符串 String str3 =  "aaa,,bbb" ; String[] dim3 = StringUtils.split(str3,  "," );  // => ["aaa", "bbb"]   System.out.println(dim3.length); //2 System.out.println(dim3[0]); //"aaa" System.out.println(dim3[1]); //"bbb"   //包含空字符串 String str4 =  "aaa,,bbb" ; String[] dim4 = StringUtils.splitPreserveAllTokens(str4,  "," );  // => ["aaa", "", "bbb"]   System.out.println(dim4.length); //3 System.out.println(dim4[0]); //"aaa" System.out.println(dim4[1]); //"" System.out.println(dim4[2]); //"bbb"   //指定分割的最大次数（超过后不分割） String str5 =  "aaa,bbb,ccc" ; String[] dim5 = StringUtils.split(str5,  "," , 2);  // => ["aaa", "bbb,ccc"]   System.out.println(dim5.length); //2 System.out.println(dim5[0]); //"aaa" System.out.println(dim5[1]); //"bbb,ccc"

4、字符串的连接  

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14

//数组元素拼接 String[] array = { "aaa" ,  "bbb" ,  "ccc" }; String result1 = StringUtils.join(array,  "," );   System.out.println(result1); //"aaa,bbb,ccc"   //集合元素拼接 List<String> list =  new ArrayList<String>(); list.add( "aaa" ); list.add( "bbb" ); list.add( "ccc" ); String result2 = StringUtils.join(list,  "," );   System.out.println(result2); //"aaa,bbb,ccc"

5、字符串的Escape  

?

1 2 3 4 5 6 7 8 9 10

System.out.println(StringEscapeUtils.escapeCsv( "测试测试哦" )); //"测试测试哦" System.out.println(StringEscapeUtils.escapeCsv( "测试,测试哦" )); //"\"测试,测试哦\"" System.out.println(StringEscapeUtils.escapeCsv( "测试\n测试哦" )); //"\"测试\n测试哦\""   System.out.println(StringEscapeUtils.escapeHtml4( "测试测试哦 " )); //"<p>测试测试哦</p>" System.out.println(StringEscapeUtils.escapeJava( "\"rensaninng\"，欢迎您！" )); //"\"rensaninng\"\uFF0C\u6B22\u8FCE\u60A8\uFF01"   System.out.println(StringEscapeUtils.escapeEcmaScript( "测试'测试哦" )); //"\u6D4B\u8BD5\'\u6D4B\u8BD5\u54E6" System.out.println(StringEscapeUtils.escapeXml( "<tt>\"bread\" & \"butter\"</tt>" )); //"<tt>"bread" &amp; "butter"</tt>"

6、随机数  

?

1 2 3 4 5 6 7 8 9 10 11

// 10位英字 System.out.println(RandomStringUtils.randomAlphabetic(10));   // 10位英数 System.out.println(RandomStringUtils.randomAlphanumeric(10));   // 10位ASCII码 System.out.println(RandomStringUtils.randomAscii(10));   // 指定文字10位 System.out.println(RandomStringUtils.random(10,  "abcde" ));

7、数组  

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80

// 追加元素到数组尾部 int[] array1 = {1, 2}; array1 = ArrayUtils.add(array1, 3);  // => [1, 2, 3]   System.out.println(array1.length); //3 System.out.println(array1[2]); //3   // 删除指定位置的元素 int[] array2 = {1, 2, 3}; array2 = ArrayUtils.remove(array2, 2);  // => [1, 2]   System.out.println(array2.length); //2   // 截取部分元素 int[] array3 = {1, 2, 3, 4}; array3 = ArrayUtils.subarray(array3, 1, 3);  // => [2, 3]   System.out.println(array3.length); //2   // 数组拷贝 String[] array4 = { "aaa" ,  "bbb" ,  "ccc" }; String[] copied = (String[]) ArrayUtils.clone(array4);  // => {"aaa", "bbb", "ccc"}           System.out.println(copied.length); //3         // 判断是否包含某元素 String[] array5 = { "aaa" ,  "bbb" ,  "ccc" ,  "bbb" }; boolean result1 = ArrayUtils.contains(array5,  "bbb" );  // => true     System.out.println(result1); //true   // 判断某元素在数组中出现的位置（从前往后，没有返回-1） int result2 = ArrayUtils.indexOf(array5,  "bbb" );  // => 1     System.out.println(result2); //1   // 判断某元素在数组中出现的位置（从后往前，没有返回-1） int result3 = ArrayUtils.lastIndexOf(array5,  "bbb" );  // => 3 System.out.println(result3); //3   // 数组转Map Map<Object, Object> map = ArrayUtils.toMap( new String[][]{      { "key1" ,  "value1" },      { "key2" ,  "value2" } }); System.out.println(map.get( "key1" )); //"value1" System.out.println(map.get( "key2" )); //"value2"   // 判断数组是否为空 Object[] array61 =  new Object[0]; Object[] array62 =  null ; Object[] array63 =  new Object[]{ "aaa" };   System.out.println(ArrayUtils.isEmpty(array61)); //true System.out.println(ArrayUtils.isEmpty(array62)); //true System.out.println(ArrayUtils.isNotEmpty(array63)); //true   // 判断数组长度是否相等 Object[] array71 =  new Object[]{ "aa" ,  "bb" ,  "cc" }; Object[] array72 =  new Object[]{ "dd" ,  "ee" ,  "ff" };   System.out.println(ArrayUtils.isSameLength(array71, array72)); //true   // 判断数组元素内容是否相等 Object[] array81 =  new Object[]{ "aa" ,  "bb" ,  "cc" }; Object[] array82 =  new Object[]{ "aa" ,  "bb" ,  "cc" };   System.out.println(ArrayUtils.isEquals(array81, array82));   // Integer[] 转化为 int[] Integer[] array9 =  new Integer[]{1, 2}; int[] result = ArrayUtils.toPrimitive(array9);   System.out.println(result.length); //2 System.out.println(result[0]); //1   // int[] 转化为 Integer[] int[] array10 =  new int[]{1, 2}; Integer[] result10 = ArrayUtils.toObject(array10);   System.out.println(result.length); //2 System.out.println(result10[0].intValue()); //1

8、日期  

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

// 生成Date对象 Date date = DateUtils.parseDate( "2010/01/01 11:22:33" ,  new String[]{ "yyyy/MM/dd HH:mm:ss" });   // 10天后 Date tenDaysAfter = DateUtils.addDays(date, 10);  // => 2010/01/11 11:22:33 System.out.println(DateFormatUtils.format(tenDaysAfter,  "yyyy/MM/dd HH:mm:ss" ));   // 前一个月 Date prevMonth = DateUtils.addMonths(date, -1);  // => 2009/12/01 11:22:33 System.out.println(DateFormatUtils.format(prevMonth,  "yyyy/MM/dd HH:mm:ss" ));   // 判断是否是同一天 Date date1 = DateUtils.parseDate( "2010/01/01 11:22:33" ,  new String[]{ "yyyy/MM/dd HH:mm:ss" }); Date date2 = DateUtils.parseDate( "2010/01/01 22:33:44" ,  new String[]{ "yyyy/MM/dd HH:mm:ss" }); System.out.println(DateUtils.isSameDay(date1, date2)); // true   // 日期格式化 System.out.println(DateFormatUtils.format( new Date(),  "yyyy/MM/dd HH:mm:ss" ));

复制去Google翻译 翻译结果