【JavaWeb】common-long包简介

http://www.open-open.com/bbs/view/1318864045468

http://www.oschina.net/code/snippet_2765_14434

这一组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 – 用于处理单词大小写、换行等。

public class TestLangDemo {public void charSetDemo() {System.out.println("**CharSetDemo**");CharSet charSet = CharSet.getInstance("aeiou");String demoStr = "The quick brown fox jumps over the lazy dog.";int count = 0;for (int i = 0, len = demoStr.length(); i < len; i++) {if (charSet.contains(demoStr.charAt(i))) {count++;}}System.out.println("count: " + count);}public void charSetUtilsDemo() {System.out.println("**CharSetUtilsDemo**");System.out.println("计算字符串中包含某字符数.");System.out.println(CharSetUtils.count("The quick brown fox jumps over the lazy dog.", "aeiou"));System.out.println("删除字符串中某字符.");System.out.println(CharSetUtils.delete("The quick brown fox jumps over the lazy dog.", "aeiou"));System.out.println("保留字符串中某字符.");System.out.println(CharSetUtils.keep("The quick brown fox jumps over the lazy dog.", "aeiou"));System.out.println("合并重复的字符.");System.out.println(CharSetUtils.squeeze("a  bbbbbb     c dd", "b d"));}public void objectUtilsDemo() {System.out.println("**ObjectUtilsDemo**");System.out.println("Object为null时，默认打印某字符.");Object obj = null;System.out.println(ObjectUtils.defaultIfNull(obj, "空"));System.out.println("验证两个引用是否指向的Object是否相等,取决于Object的equals()方法.");Object a = new Object();Object b = a;Object c = new Object();System.out.println(ObjectUtils.equals(a, b));System.out.println(ObjectUtils.equals(a, c));System.out.println("用父类Object的toString()方法返回对象信息.");Date date = new Date();System.out.println(ObjectUtils.identityToString(date));System.out.println(date);System.out.println("返回类本身的toString()方法结果,对象为null时，返回0长度字符串.");System.out.println(ObjectUtils.toString(date));System.out.println(ObjectUtils.toString(null));System.out.println(date);}public void serializationUtilsDemo() {System.out.println("*SerializationUtils**");Date date = new Date();byte[] bytes = SerializationUtils.serialize(date);System.out.println(ArrayUtils.toString(bytes));System.out.println(date);Date reDate = (Date) SerializationUtils.deserialize(bytes);System.out.println(reDate);System.out.println(ObjectUtils.equals(date, reDate));System.out.println(date == reDate);FileOutputStream fos = null;FileInputStream fis = null;try {fos = new FileOutputStream(new File("d:/test.txt"));fis = new FileInputStream(new File("d:/test.txt"));SerializationUtils.serialize(date, fos);Date reDate2 = (Date) SerializationUtils.deserialize(fis);System.out.println(date.equals(reDate2));} catch (FileNotFoundException e) {e.printStackTrace();} finally {try {fos.close();fis.close();} catch (IOException e) {e.printStackTrace();}}}public void randomStringUtilsDemo() {System.out.println("**RandomStringUtilsDemo**");System.out.println("生成指定长度的随机字符串,好像没什么用.");System.out.println(RandomStringUtils.random(500));System.out.println("在指定字符串中生成长度为n的随机字符串.");System.out.println(RandomStringUtils.random(5, "abcdefghijk"));System.out.println("指定从字符或数字中生成随机字符串.");System.out.println(RandomStringUtils.random(5, true, false));System.out.println(RandomStringUtils.random(5, false, true));}public void stringUtilsDemo() {System.out.println("**StringUtilsDemo**");System.out.println("将字符串重复n次，将文字按某宽度居中，将字符串数组用某字符串连接.");String[] header = new String[3];header[0] = StringUtils.repeat("*", 50);header[1] = StringUtils.center("  StringUtilsDemo  ", 50, "^O^");header[2] = header[0];String head = StringUtils.join(header, "\n");System.out.println(head);System.out.println("缩短到某长度,用...结尾.");System.out.println(StringUtils.abbreviate("The quick brown fox jumps over the lazy dog.", 10));System.out.println(StringUtils.abbreviate("The quick brown fox jumps over the lazy dog.", 15, 10));System.out.println("返回两字符串不同处索引号.");System.out.println(StringUtils.indexOfDifference("aaabc", "aaacc"));System.out.println("返回两字符串不同处开始至结束.");System.out.println(StringUtils.difference("aaabcde", "aaaccde"));System.out.println("截去字符串为以指定字符串结尾的部分.");System.out.println(StringUtils.chomp("aaabcde", "de"));System.out.println("检查一字符串是否为另一字符串的子集.");System.out.println(StringUtils.containsOnly("aad", "aadd"));System.out.println("检查一字符串是否不是另一字符串的子集.");System.out.println(StringUtils.containsNone("defg", "aadd"));System.out.println("检查一字符串是否包含另一字符串.");System.out.println(StringUtils.contains("defg", "ef"));System.out.println(StringUtils.containsOnly("ef", "defg"));System.out.println("返回可以处理null的toString().");System.out.println(StringUtils.defaultString("aaaa"));System.out.println("?" + StringUtils.defaultString(null) + "!");System.out.println("去除字符中的空格.");System.out.println(StringUtils.deleteWhitespace("aa  bb  cc"));System.out.println("分隔符处理成数组.");String[] strArray = StringUtils.split("a,b,,c,d,null,e", ",");System.out.println(strArray.length);System.out.println(strArray.toString());System.out.println("判断是否是某类字符.");System.out.println(StringUtils.isAlpha("ab"));System.out.println(StringUtils.isAlphanumeric("12"));System.out.println(StringUtils.isBlank(""));System.out.println(StringUtils.isNumeric("123"));}public void systemUtilsDemo() {System.out.println(genHeader("SystemUtilsDemo"));System.out.println("获得系统文件分隔符.");System.out.println(SystemUtils.FILE_SEPARATOR);System.out.println("获得源文件编码.");System.out.println(SystemUtils.FILE_ENCODING);System.out.println("获得ext目录.");System.out.println(SystemUtils.JAVA_EXT_DIRS);System.out.println("获得java版本.");System.out.println(SystemUtils.JAVA_VM_VERSION);System.out.println("获得java厂商.");System.out.println(SystemUtils.JAVA_VENDOR);}public void classUtilsDemo() {System.out.println(genHeader("ClassUtilsDemo"));System.out.println("获取类实现的所有接口.");System.out.println(ClassUtils.getAllInterfaces(Date.class));System.out.println("获取类所有父类.");System.out.println(ClassUtils.getAllSuperclasses(Date.class));System.out.println("获取简单类名.");System.out.println(ClassUtils.getShortClassName(Date.class));System.out.println("获取包名.");System.out.println(ClassUtils.getPackageName(Date.class));System.out.println("判断是否可以转型.");System.out.println(ClassUtils.isAssignable(Date.class, Object.class));System.out.println(ClassUtils.isAssignable(Object.class, Date.class));}public void stringEscapeUtilsDemo() {System.out.println(genHeader("StringEcsapeUtils"));System.out.println("转换特殊字符.");System.out.println("html:" + StringEscapeUtils.escapeHtml3(" "));System.out.println("html:" + StringEscapeUtils.escapeHtml4(" "));System.out.println("html:" + StringEscapeUtils.unescapeHtml3("<p>"));System.out.println("html:" + StringEscapeUtils.unescapeHtml4("<p>"));}private final class BuildDemo {String name;int age;public BuildDemo(String name, int age) {this.name = name;this.age = age;}public String toString() {ToStringBuilder tsb = new ToStringBuilder(this, ToStringStyle.MULTI_LINE_STYLE);tsb.append("Name", name);tsb.append("Age", age);return tsb.toString();}public int hashCode() {HashCodeBuilder hcb = new HashCodeBuilder();hcb.append(name);hcb.append(age);return hcb.hashCode();}public boolean equals(Object obj) {if (!(obj instanceof BuildDemo)) {return false;}BuildDemo bd = (BuildDemo) obj;EqualsBuilder eb = new EqualsBuilder();eb.append(name, bd.name);eb.append(age, bd.age);return eb.isEquals();}}public void builderDemo() {System.out.println(genHeader("BuilderDemo"));BuildDemo obj1 = new BuildDemo("a", 1);BuildDemo obj2 = new BuildDemo("b", 2);BuildDemo obj3 = new BuildDemo("a", 1);System.out.println("toString()");System.out.println(obj1);System.out.println(obj2);System.out.println(obj3);System.out.println("hashCode()");System.out.println(obj1.hashCode());System.out.println(obj2.hashCode());System.out.println(obj3.hashCode());System.out.println("equals()");System.out.println(obj1.equals(obj2));System.out.println(obj1.equals(obj3));}public void numberUtils() {System.out.println(genHeader("NumberUtils"));System.out.println("字符串转为数字(不知道有什么用).");System.out.println(NumberUtils.toInt("ba", 33));System.out.println("从数组中选出最大值.");System.out.println(NumberUtils.max(new int[] { 1, 2, 3, 4 }));System.out.println("判断字符串是否全是整数.");System.out.println(NumberUtils.isDigits("123.1"));System.out.println("判断字符串是否是有效数字.");System.out.println(NumberUtils.isNumber("0123.1"));}public void dateFormatUtilsDemo() {System.out.println(genHeader("DateFormatUtilsDemo"));System.out.println("格式化日期输出.");System.out.println(DateFormatUtils.format(System.currentTimeMillis(), "yyyy-MM-dd HH:mm:ss"));System.out.println("秒表.");StopWatch sw = new StopWatch();sw.start();for (Iterator iterator = DateUtils.iterator(new Date(), DateUtils.RANGE_WEEK_CENTER); iterator.hasNext();) {Calendar cal = (Calendar) iterator.next();System.out.println(DateFormatUtils.format(cal.getTime(), "yy-MM-dd HH:mm"));}sw.stop();System.out.println("秒表计时:" + sw.getTime());}private String genHeader(String head) {String[] header = new String[3];header[0] = StringUtils.repeat("*", 50);header[1] = StringUtils.center("  " + head + "  ", 50, "^O^");header[2] = header[0];return StringUtils.join(header, "\n");}private void validateDemo() {String[] strarray = { "a", "b", "c" };System.out.println("验证功能");System.out.println(Validate.notEmpty(strarray));}private void wordUtilsDemo() {System.out.println("单词处理功能");String str1 = "wOrD";String str2 = "ghj\nui\tpo";System.out.println(WordUtils.capitalize(str1)); // 首字母大写System.out.println(WordUtils.capitalizeFully(str1)); // 首字母大写其它字母小写char[] ctrg = { '.' };System.out.println(WordUtils.capitalizeFully("i aM.fine", ctrg)); // 在规则地方转换System.out.println(WordUtils.initials(str1)); // 获取首字母System.out.println(WordUtils.initials("Ben John Lee", null)); // 取每个单词的首字母char[] ctr = { ' ', '.' };System.out.println(WordUtils.initials("Ben J.Lee", ctr)); // 按指定规则获取首字母System.out.println(WordUtils.swapCase(str1)); // 大小写逆转System.out.println(WordUtils.wrap(str2, 1)); // 解析\n和\t等字符}/** * @param args */public static void main(String[] args) {TestLangDemo langDemo = new TestLangDemo();langDemo.charSetDemo();langDemo.charSetUtilsDemo();langDemo.objectUtilsDemo();langDemo.serializationUtilsDemo();langDemo.randomStringUtilsDemo();langDemo.stringUtilsDemo();langDemo.systemUtilsDemo();langDemo.classUtilsDemo();langDemo.stringEscapeUtilsDemo();langDemo.builderDemo();langDemo.numberUtils();langDemo.dateFormatUtilsDemo();langDemo.validateDemo();langDemo.wordUtilsDemo();}}