常用jar包之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幫我們解決了處理類似情況的大部分問題。來看一個例子：

package sean.study.jakarta.commons.lang;</p><p>import java.util.Map;</p><p>import org.apache.commons.lang.ArrayUtils;</p><p>public class ArrayUtilsUsage {</p><p> public static void main(String[] args) {</p><p> // data setup</p><p> int[] intArray1 = { 2, 4, 8, 16 };</p><p> int[][] intArray2 = { { 1, 2 }, { 2, 4 }, { 3, 8 }, { 4, 16 } };</p><p> Object[][] notAMap = { </p><p> { "A", new Double(100) },</p><p> { "B", new Double(80) }, </p><p> { "C", new Double(60) },</p><p> { "D", new Double(40) }, </p><p> { "E", new Double(20) } </p><p> };</p><p> // printing arrays</p><p> System.out.println("intArray1: " + ArrayUtils.toString(intArray1));</p><p> System.out.println("intArray2: " + ArrayUtils.toString(intArray2));</p><p> System.out.println("notAMap: " + ArrayUtils.toString(notAMap));</p><p> // finding items</p><p> System.out.println("intArray1 contains '8'? "</p><p> + ArrayUtils.contains(intArray1, 8));</p><p> System.out.println("intArray1 index of '8'? "</p><p> + ArrayUtils.indexOf(intArray1, 8));</p><p> System.out.println("intArray1 last index of '8'? "</p><p> + ArrayUtils.lastIndexOf(intArray1, 8));</p><p> // cloning and resversing</p><p> int[] intArray3 = ArrayUtils.clone(intArray1);</p><p> System.out.println("intArray3: " + ArrayUtils.toString(intArray3));</p><p> ArrayUtils.reverse(intArray3);</p><p> System.out.println("intArray3 reversed: "</p><p> + ArrayUtils.toString(intArray3));</p><p> // primitive to Object array</p><p> Integer[] integerArray1 = ArrayUtils.toObject(intArray1);</p><p> System.out.println("integerArray1: "</p><p> + ArrayUtils.toString(integerArray1));</p><p> // build Map from two dimensional array</p><p> Map map = ArrayUtils.toMap(notAMap);</p><p> Double res = (Double) map.get("C");</p><p> System.out.println("get 'C' from map: " + res);</p><p> }</p><p>}</p><p>以下是運行結果：</p><p>intArray1: {2,4,8,16}</p><p>intArray2: {{1,2},{2,4},{3,8},{4,16}}</p><p>notAMap: {{A,100.0},{B,80.0},{C,60.0},{D,40.0},{E,20.0}}</p><p>intArray1 contains '8'? true</p><p>intArray1 index of '8'? 2</p><p>intArray1 last index of '8'? 2</p><p>intArray3: {2,4,8,16}</p><p>intArray3 reversed: {16,8,4,2}</p><p>integerArray1: {2,4,8,16}</p><p>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至今還維持著那種簡潔而強大的美，使用起來也很順手。來看一個例子： 

package sean.study.jakarta.commons.lang;</p><p>import org.apache.commons.lang.StringUtils;</p><p>public class StringUtilsAndWordUtilsUsage {</p><p> public static void main(String[] args) {</p><p> // data setup</p><p> String str1 = "";</p><p> String str2 = " ";</p><p> String str3 = "/t";</p><p> String str4 = null;</p><p> String str5 = "123";</p><p> String str6 = "ABCDEFG";</p><p> String str7 = "It feels good to use Jakarta Commons./r/n";</p><p> // check for empty strings</p><p> System.out.println("==============================");</p><p> System.out.println("Is str1 blank? " + StringUtils.isBlank(str1));</p><p> System.out.println("Is str2 blank? " + StringUtils.isBlank(str2));</p><p> System.out.println("Is str3 blank? " + StringUtils.isBlank(str3));</p><p> System.out.println("Is str4 blank? " + StringUtils.isBlank(str4));</p><p> // check for numerics</p><p> System.out.println("==============================");</p><p> System.out.println("Is str5 numeric? " + StringUtils.isNumeric(str5));</p><p> System.out.println("Is str6 numeric? " + StringUtils.isNumeric(str6));</p><p> // reverse strings / whole words</p><p> System.out.println("==============================");</p><p> System.out.println("str6: " + str6);</p><p> System.out.println("str6 reversed: " + StringUtils.reverse(str6));</p><p> System.out.println("str7: " + str7);</p><p> String str8 = StringUtils.chomp(str7);</p><p> str8 = StringUtils.reverseDelimited(str8, ' ');</p><p> System.out.println("str7 reversed whole words : /r/n" + str8);</p><p> // build header (useful to print log messages that are easy to locate)</p><p> System.out.println("==============================");</p><p> System.out.println("print header:");</p><p> String padding = StringUtils.repeat("=", 50);</p><p> String msg = StringUtils.center(" Customised Header ", 50, "%");</p><p> Object[] raw = new Object[]{padding, msg, padding};</p><p> String header = StringUtils.join(raw, "/r/n");</p><p> System.out.println(header);</p><p> }</p><p>}</p><p>輸出的結果如下：</p><p>==============================</p><p>Is str1 blank? true</p><p>Is str2 blank? true</p><p>Is str3 blank? true</p><p>Is str4 blank? true</p><p>==============================</p><p>Is str5 numeric? true</p><p>Is str6 numeric? false</p><p>==============================</p><p>str6: ABCDEFG</p><p>str6 reversed: GFEDCBA</p><p>str7: It feels good to use Jakarta Commons.</p><p>str7 reversed whole words : </p><p>Commons. Jakarta use to good feels It</p><p>==============================</p><p>print header:</p><p>==================================================</p><p>%%%%%%%%%%%%%%% Customised Header %%%%%%%%%%%%%%%%</p><p>==================================================

從代碼中我們可以大致瞭解到這個StringUtils類簡單而強大的處理能力，從檢查空串（對null的情況處理很得體），到分割子串，到產生格式化的字串，使用都很簡潔，也很直截了當。