zoukankan      html  css  js  c++  java
  • 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的情况处理很得体),到分割子串,到生成格式化的字符串,使用都很简洁,也很直截了当。

  • 相关阅读:
    【Python图像特征的音乐序列生成】解析ABC格式的文件(修改版)
    【Python图像特征的音乐序列生成】关于数据库到底在哪里下载
    假期周进度报告2
    假期周进度报告1
    河北省科技创新平台系统头脑风暴会
    问题账户需求分析
    2018年春季个人阅读计划
    软件需求与分析读后感
    《需求工程——软件建模与分析》读后感3
    《需求工程——软件建模与分析》读后感2
  • 原文地址:https://www.cnblogs.com/dangzhenjiuhao/p/5188945.html
Copyright © 2011-2022 走看看