快捷導(dǎo)航

Java編程Commons lang組件簡介

更新時(shí)間：2017年09月07日 09:57:25 作者：王甲評

這篇文章主要介紹了Java編程Commons lang組件的相關(guān)內(nèi)容，十分具有參考意義,需要的朋友可以了解下。

跟java.lang這個(gè)包的作用類似，Commons Lang這一組API也是提供一些基礎(chǔ)的、通用的操作和處理，如自動(dòng)生成toString()的結(jié)果、自動(dòng)實(shí)現(xiàn)hashCode()和equals()方法、數(shù)組操作、枚舉、日期和時(shí)間的處理等等。

這一組API的所有包名都以org.apache.commons.lang開頭，共有如下8個(gè)包：

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包包含了一組用于產(chǎn)生每個(gè)Java類中都常使用到的toString()、 hashCode()、equals()、compareTo()等等方法的構(gòu)造器；lang.enums包顧名思義用于處理枚舉；lang.exception包用于處理Java標(biāo)準(zhǔn)API中的exception，為1.4之前版本提供Nested Exception功能；lang.math包用于處理數(shù)字；lang.mutable用于包裝值型變量；lang.time包提供處理日期和時(shí)間的功能。

由于Commons的包和類實(shí)在很多，不可能一個(gè)一個(gè)講了，在接下來的專題文章中我就只分別過一下lang、lang.builder、lang.math和lang.time這幾個(gè)包和常見的用法，其他的我們可以在用到時(shí)臨時(shí)參考一下Javadoc。位置就在安裝路徑的

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

我們首先來看org.apache.commons.lang包，這個(gè)包提供了一些有用的包含static方法的Util類。除了6個(gè)Exception類和2個(gè)已經(jīng)deprecated的數(shù)字類之外，commons.lang包共包含了17個(gè)實(shí)用的類：

ArrayUtils – 用于對數(shù)組的操作，如添加、查找、刪除、子數(shù)組、倒序、元素類型轉(zhuǎn)換等；

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

BooleanUtils – 用于操作和轉(zhuǎn)換boolean或者Boolean及相應(yīng)的數(shù)組；

CharEncoding – 包含了Java環(huán)境支持的字符編碼，提供是否支持某種編碼的判斷；

CharRange – 用于設(shè)定字符范圍并做相應(yīng)檢查；

CharSet – 用于設(shè)定一組字符作為范圍并做相應(yīng)檢查；

CharSetUtils – 用于操作CharSet；

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

ClassUtils – 用于對Java類的操作，不使用反射；

ObjectUtils – 用于操作Java對象，提供null安全的訪問和其他一些功能；

RandomStringUtils – 用于生成隨機(jī)的字符串；

SerializationUtils – 用于處理對象序列化，提供比一般Java序列化更高級的處理能力；

StringEscapeUtils – 用于正確處理轉(zhuǎn)義字符，產(chǎn)生正確的Java、JavaScript、HTML、XML和SQL代碼；

StringUtils – 處理String的核心類，提供了相當(dāng)多的功能；

SystemUtils – 在java.lang.System基礎(chǔ)上提供更方便的訪問，如用戶路徑、Java版本、時(shí)區(qū)、操作系統(tǒng)等判斷；

Validate – 提供驗(yàn)證的操作，有點(diǎn)類似assert斷言；

WordUtils – 用于處理單詞大小寫、換行等。

下面講下最常用的兩個(gè)類

ArrayUtils

數(shù)組是我們經(jīng)常需要使用到的一種數(shù)據(jù)結(jié)構(gòu)，但是由于Java本身并沒有提供很好的API支持，使得很多操作實(shí)際上做起來相當(dāng)繁瑣，以至于我們實(shí)際編碼中甚至?xí)幌奚阅苋ナ褂肅ollections API，用Collection當(dāng)然能夠很方便的解決我們的問題，但是我們一定要以性能為代價(jià)嗎？ArrayUtils幫我們解決了處理類似情況的大部分問題。來看一個(gè)例子：

view plaincopy to clipboardprint?
package sean.study.jakarta.commons.lang; 
 
 
 
import java.util.Map; 
 
import org.apache.commons.lang.ArrayUtils; 
 
 
 
public class ArrayUtilsUsage { 
 
 
 
 public static void main(String[] args) { 
 
 
 
  // data setup 
 
  int[] intArray1 = { 2, 4, 8, 16 }; 
 
  int[][] intArray2 = { { 1, 2 }, { 2, 4 }, { 3, 8 }, { 4, 16 } }; 
 
  Object[][] notAMap = { 
 
    { "A", new Double(100) }, 
 
    { "B", new Double(80) }, 
 
    { "C", new Double(60) }, 
 
    { "D", new Double(40) }, 
 
    { "E", new Double(20) } 
 
  }; 
 
 
 
  // printing arrays 
 
  System.out.println("intArray1: " + ArrayUtils.toString(intArray1)); 
 
  System.out.println("intArray2: " + ArrayUtils.toString(intArray2)); 
 
  System.out.println("notAMap: " + ArrayUtils.toString(notAMap)); 
 
 
 
  // finding items 
 
  System.out.println("intArray1 contains '8'? " 
 
    + ArrayUtils.contains(intArray1, 8)); 
 
  System.out.println("intArray1 index of '8'? " 
 
    + ArrayUtils.indexOf(intArray1, 8)); 
 
  System.out.println("intArray1 last index of '8'? " 
 
    + ArrayUtils.lastIndexOf(intArray1, 8)); 
 
 
 
  // cloning and resversing 
 
  int[] intArray3 = ArrayUtils.clone(intArray1); 
 
  System.out.println("intArray3: " + ArrayUtils.toString(intArray3)); 
 
  ArrayUtils.reverse(intArray3); 
 
  System.out.println("intArray3 reversed: " 
 
    + ArrayUtils.toString(intArray3)); 
 
 
 
  // primitive to Object array 
 
  Integer[] integerArray1 = ArrayUtils.toObject(intArray1); 
 
  System.out.println("integerArray1: " 
 
    + ArrayUtils.toString(integerArray1)); 
 
 
 
  // build Map from two dimensional array 
 
  Map map = ArrayUtils.toMap(notAMap); 
 
  Double res = (Double) map.get("C"); 
 
  System.out.println("get 'C' from map: " + res); 
 
 
 
 } 
 
 
 
}

以下是運(yùn)行結(jié)果：
intArray1: {2,4,8,16}
intArray2: {{1,2},{2,4},{3,8},{4,16}}
notAMap: {{A,100.0},{B,80.0},{C,60.0},{D,40.0},{E,20.0}}
intArray1 contains '8'? true
intArray1 index of '8'? 2
intArray1 last index of '8'? 2
intArray3: {2,4,8,16}
intArray3 reversed: {16,8,4,2}
integerArray1: {2,4,8,16}
get 'C' from map: 60.0

package sean.study.jakarta.commons.lang;

import java.util.Map;

import org.apache.commons.lang.ArrayUtils;

public class ArrayUtilsUsage {

 public static void main(String[] args) {

  // data setup

  int[] intArray1 = { 2, 4, 8, 16 };

  int[][] intArray2 = { { 1, 2 }, { 2, 4 }, { 3, 8 }, { 4, 16 } };

  Object[][] notAMap = {

    { "A", new Double(100) },

    { "B", new Double(80) },

    { "C", new Double(60) },

    { "D", new Double(40) },

    { "E", new Double(20) }

  };

  // printing arrays

  System.out.println("intArray1: " + ArrayUtils.toString(intArray1));

  System.out.println("intArray2: " + ArrayUtils.toString(intArray2));

  System.out.println("notAMap: " + ArrayUtils.toString(notAMap));

  // finding items

  System.out.println("intArray1 contains '8'? "

    + ArrayUtils.contains(intArray1, 8));

  System.out.println("intArray1 index of '8'? "

    + ArrayUtils.indexOf(intArray1, 8));

  System.out.println("intArray1 last index of '8'? "

    + ArrayUtils.lastIndexOf(intArray1, 8));

  // cloning and resversing

  int[] intArray3 = ArrayUtils.clone(intArray1);

  System.out.println("intArray3: " + ArrayUtils.toString(intArray3));

  ArrayUtils.reverse(intArray3);

  System.out.println("intArray3 reversed: "

    + ArrayUtils.toString(intArray3));

  // primitive to Object array

  Integer[] integerArray1 = ArrayUtils.toObject(intArray1);

  System.out.println("integerArray1: "

    + ArrayUtils.toString(integerArray1));

  // build Map from two dimensional array

  Map map = ArrayUtils.toMap(notAMap);

  Double res = (Double) map.get("C");

  System.out.println("get 'C' from map: " + res);

 }

}

以下是運(yùn)行結(jié)果：

intArray1: {2,4,8,16}

intArray2: {{1,2},{2,4},{3,8},{4,16}}

notAMap: {{A,100.0},{B,80.0},{C,60.0},{D,40.0},{E,20.0}}

intArray1 contains '8'? true

intArray1 index of '8'? 2

intArray1 last index of '8'? 2

intArray3: {2,4,8,16}

intArray3 reversed: {16,8,4,2}

integerArray1: {2,4,8,16}

get 'C' from map: 60.0

這段代碼說明了我們可以如何方便的利用ArrayUtils類幫我們完成數(shù)組的打印、查找、克隆、倒序、以及值型/對象數(shù)組之間的轉(zhuǎn)換等操作。

StringUtils

處理文本對Java應(yīng)用來說應(yīng)該算是家常便飯了，在1.4出現(xiàn)之前，Java自身提供的API非常有限，如String、 StringTokenizer、StringBuffer，操作也比較單一。無非就是查找substring、分解、合并等等。到1.4的出現(xiàn)可以說 Java的文字處理上了一個(gè)臺(tái)階，因?yàn)樗С謗egular expression了。這可是個(gè)重量級而方便的東東啊，缺點(diǎn)是太復(fù)雜，學(xué)習(xí)起來有一定難度。相較而言，Jakarta Commons提供的StringUtils和WordUtils至今還維持著那種簡潔而強(qiáng)大的美，使用起來也很順手。來看一個(gè)例子：

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

輸出的結(jié)果如下：
==============================

Is str1 blank? true

Is str2 blank? true

Is str3 blank? true

Is str4 blank? true

==============================

Is str5 numeric? true

Is str6 numeric? false

==============================

str6: ABCDEFG

str6 reversed: GFEDCBA

str7: It feels good to use Jakarta Commons.



str7 reversed whole words :

Commons. Jakarta use to good feels It

==============================

print header:

==================================================

%%%%%%%%%%%%%%% Customised Header %%%%%%%%%%%%%%%%

==================================================

package sean.study.jakarta.commons.lang;

import org.apache.commons.lang.StringUtils;

public class StringUtilsAndWordUtilsUsage {

 public static void main(String[] args) {

  

  // data setup

  String str1 = "";

  String str2 = " ";

  String str3 = "\t";

  String str4 = null;

  String str5 = "123";

  String str6 = "ABCDEFG";

  String str7 = "It feels good to use Jakarta Commons.\r\n";

  

  // check for empty strings

  System.out.println("==============================");

  System.out.println("Is str1 blank? " + StringUtils.isBlank(str1));

  System.out.println("Is str2 blank? " + StringUtils.isBlank(str2));

  System.out.println("Is str3 blank? " + StringUtils.isBlank(str3));

  System.out.println("Is str4 blank? " + StringUtils.isBlank(str4));

  

  // check for numerics

  System.out.println("==============================");

  System.out.println("Is str5 numeric? " + StringUtils.isNumeric(str5));

  System.out.println("Is str6 numeric? " + StringUtils.isNumeric(str6));

  

  // reverse strings / whole words

  System.out.println("==============================");

  System.out.println("str6: " + str6);

  System.out.println("str6 reversed: " + StringUtils.reverse(str6));

  System.out.println("str7: " + str7);

  String str8 = StringUtils.chomp(str7);

  str8 = StringUtils.reverseDelimited(str8, ' ');

  System.out.println("str7 reversed whole words : \r\n" + str8);

  

  // build header (useful to print log messages that are easy to locate)

  System.out.println("==============================");

  System.out.println("print header:");

  String padding = StringUtils.repeat("=", 50);

  String msg = StringUtils.center(" Customised Header ", 50, "%");

  Object[] raw = new Object[]{padding, msg, padding};

  String header = StringUtils.join(raw, "\r\n");

  System.out.println(header);

 }

}

輸出的結(jié)果如下：

==============================

Is str1 blank? true

Is str2 blank? true

Is str3 blank? true

Is str4 blank? true

==============================

Is str5 numeric? true

Is str6 numeric? false

==============================

str6: ABCDEFG

str6 reversed: GFEDCBA