Jakarta项目的commons包简介
转自：
http://www.blogjava.net/renyangok/articles/74008.html
commons分为3部分Commons Proper、Commons Sandbox和Commons Dormant
Commons Proper：提供了设计良好可重用的java组件，并都经过了广泛、严格的测试。
Commons Sandbox：处于实验、测试阶段的组件。
Commons Dormant：处于停滞状态，从Sandbox退出的，不活跃的组件，谨慎使用。
Commons Proper组件：
- Attributes—— 支持源代码级的元数据。
- BeanUtils——提供对 Java 反射和自省API的包装，处理javabean的工具。
- Betwixt——将JavaBeans与XML相互转换。
- Chain——对Chain of Responsibility（责任链）设计模式的实现。使多个对象都有机会处理请求， 从而避免请求的发送者和接收者之间的耦合关系。将这些对象连成一条链，并沿着这条链传递请求，直到有一个对象处理它为止。
- CLI——处理命令行的命令的解析。
- Codec——包含一些通用的编码解码算法。包括一些语音编码器， Hex, Base64, 以及URL encoder。
- Collections——扩展和增加标准的 Java Collection框架。
- Configuration——操作各种格式的配置文件。Properties文件 /XML文件 /JNDI /JDBC 数据源 /System properties /Applet parameters / Servlet parameters
- Daemon——创建类似unix守护线程的java代码，可以安全地执行一些后台操作，线程不被某个应用程序控制，而是由操作系统控制 类似windows的service，可以设置一个服务依赖于另一个服务，一个服务关闭前必须先执行另一个服务。
- DBCP——一个数据库连接池
- DbUtils——一个JDBC的工具类，比如可以将ResultSets生成javabean。
- Digester——基于规则的XML文档解析,主要用于XML到Java对象的映射.
- Discovery——提供工具来定位资源 (包括类) ，通过使用各种模式来映射服务/引用名称和资源名称。
- EL——JSP 2.0引入的表达式
- Email——处理e-mail
- FileUpload——web应用中的文件上传组件
- HttpClient——使用HTTP协议的客户端开发框架
- IO——帮助进行IO功能开发
- Jelly——Jelly能够把XML转换成可执行代码,所以Jelly是一个基于XML与Java的脚本和处理引擎。 Jelly借鉴了JSP定指标签，Velocity, Cocoon和Xdoclet中的脚本引擎的许多优点。Jelly可以用在命令行，Ant或者Servlet之中。
- Jexl——Jexl是一个表达式语言，通过借鉴来自于Velocity的经验扩展了JSTL定义的表达式语言。
- JXPath——使用XPath语法操作javabean的工具。
- Lang——提供对java.lang包的扩展。
- Launcher——跨平台的java程序的启动
- Logging——提供的是一个日志(Log)接口(interface)，同时兼顾轻量级和不依赖于具体的日志实现工具。 它提供给中间件/日志工具开发者一个简单的日志操作抽象，允许程序开发人员使用不同的具体日志实现工具。用户被假定已熟悉某种日志实现工具的更高级别的细节。JCL提供的接口，对其它一些日志工具，包括Log4J, Avalon LogKit, and JDK 1.4等，进行了简单的包装，此接口更接近于Log4J和LogKit的实现.
- Math——Math 是一个轻量的，自包含的数学和统计组件，解决了许多非常通用但没有及时出现在Java标准语言中的实践问题.
- Modeler—— 支持兼容JMX规范的MBeans开发。
- Net——集合了网络工具和协议工具的实现
- Pool——Commons-Pool 提供了通用对象池接口，一个用于创建模块化对象池的工具包，以及通常的对象池实现。
- Primitives——对java原始类型的支持。
- SCXML——处理SCXML
- Transaction——事务处理，实现了多层次锁、事务集合、事务文件的访问。
- Validator——提供了一个简单的，可扩展的框架来在一个XML文件中定义校验器 (校验方法)和校验规则。支持校验规则的和错误消息的国际化。
- VFS——访问各种文件系统，可以是本地文件、HTTP服务器上的文件、zip中的文件。
Commons Sandbox组件：
- Compress——处理压缩文件如tar, zip 和 bzip2 格式。
- CSV——处理CSV文件
- Exec——安全地处理外部进程
- Finder——实现类似UNIX find命令的功能
- I18n——处理软件的I18n功能
- Id——生成id号功能
- Javaflow——捕捉程序运行状态
- JCI——java编译接口
- OpenPGP——处理加密方法OpenPGP.
- Pipeline——处理类似工作队列的管道工具
- Proxy——生成动态代理
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－org.apache.commons.beanutils.PropertyUtils;
copyProperties(a,b);//把相同类型b的属性赋值给a
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
转载：org.apache.commons包
构架，业务实现和优化而不是具体实现及验证上，一言以蔽之，它能使我们避免重复的发明车轮。
org.apache.commons包的下载页面在:
http://jakarta.apache.org/site/downloads/downloads_commons-lang.cgi
其中源码大家可以借鉴一下，我觉得很有参考价值，尤其是有些函数在不用正则表达式下取得的效果。
取得commons-lang-2.1.jar后加入自己工程的lib目录就可以了.如果用户不允许使用commons，那末打开其源码把具体函数加入自己的代码也可以，当然需要尊重人家的知识产权。
以下代码经过测试,测试环境(WinXp+Eclipse3.1+JDK1.5+commons-lang-2.1)，我在有些地方修改了一下。
Jakarta Commons Cookbook—01—Manipulating Text
Commons之字符串操作
要利用Jakarta Commons来进行字符串操作,首先需要加载需要用到的包:
import org.apache.commons.lang.StringUtils;
import org.apache.commons.lang.WordUtils;
以下是StringUtils的各项用法
1.空字符串检查
使用函数: StringUtils.isBlank(testString)
函数介绍: 当testString为空,长度为零或者仅由空白字符(whitespace)组成时,返回True;否则返回False
例程:
String test = "";
String test2 = "\n\n\t";
String test3 = null;
String test4 = "Test";
System.out.println( "test blank? " + StringUtils.isBlank( test ) );
System.out.println( "test2 blank? " + StringUtils.isBlank( test2 ) );
System.out.println( "test3 blank? " + StringUtils.isBlank( test3 ) );
System.out.println( "test4 blank? " + StringUtils.isBlank( test4 ) );
输出如下:
test blank? true
test2 blank? true
test3 blank? true
test4 blank? False
函数StringUtils.isNotBlank(testString)的功能与StringUtils.isBlank(testString)相反.
2.清除空白字符
使用函数: StringUtils.trimToNull(testString)
函数介绍:清除掉testString首尾的空白字符,如果仅testString全由空白字符
(whitespace)组成则返回null
例程:
String test1 = "\t";
String test2 = " A Test ";
String test3 = null;
System.out.println( "test1 trimToNull: " + StringUtils.trimToNull( test1 ) );
System.out.println( "test2 trimToNull: " + StringUtils.trimToNull( test2 ) );
System.out.println( "test3 trimToNull: " + StringUtils.trimToNull( test3 ) );
输出如下:
test1 trimToNull: null
test2 trimToNull: A Test
test3 trimToNull: null
注意：函数StringUtils.trim(testString)与
StringUtils.trimToNull(testString)功能类似，但testString由空白字符
(whitespace)组成时返回零长度字符串。
3.取得字符串的缩写
使用函数: StringUtils.abbreviate(testString,width)和StringUtils.abbreviate(testString,offset，width)
函数介绍:在给定的width内取得testString的缩写,当testString的长度小于width则返回原字符串.
例程:
String test = "This is a test of the abbreviation.";
String test2 = "Test";
System.out.println( StringUtils.abbreviate( test, 15 ) );
System.out.println( StringUtils.abbreviate( test, 5,15 ) );
System.out.println( StringUtils.abbreviate( test2, 10 ) );
输出如下:
This is a te...
...is a test...
Test
4.劈分字符串
使用函数: StringUtils.split(testString,splitChars,arrayLength)
函数介绍:splitChars中可以包含一系列的字符串来劈分testString,并可以设定得
到数组的长度.注意设定长度arrayLength和劈分字符串间有抵触关系,建议一般情况下
不要设定长度.
例程:
String input = "A b,c.d|e";
String input2 = "Pharmacy, basketball funky";
String[] array1 = StringUtils.split( input, " ,.|");
String[] array2 = StringUtils.split( input2, " ,", 2 );
System.out.println( ArrayUtils.toString( array1 ) );
System.out.println( ArrayUtils.toString( array2 ) );
输出如下:
{A,b,c,d,e}
{Pharmacy,basketball funky}
5.查找嵌套字符串
使用函数:StringUtils.substringBetween(testString,header,tail)
函数介绍：在testString中取得header和tail之间的字符串。不存在则返回空
例程：
String htmlContent = "ABC1234ABC4567";
System.out.println(StringUtils.substringBetween(htmlContent, "1234", "4567"));
System.out.println(StringUtils.substringBetween(htmlContent, "12345", "4567"));
输出如下：
ABC
null
6.去除尾部换行符
使用函数:StringUtils.chomp(testString)
函数介绍:去除testString尾部的换行符
例程:
String input = "Hello\n";
System.out.println( StringUtils.chomp( input ));
String input2 = "Another test\r\n";
System.out.println( StringUtils.chomp( input2 ));
输出如下:
Hello
Another test
7.重复字符串
使用函数:StringUtils.repeat(repeatString,count)
函数介绍:得到将repeatString重复count次后的字符串
例程:
System.out.println( StringUtils.repeat( "*", 10));
System.out.println( StringUtils.repeat( "China ", 5));
输出如下:
**********
China China China China China
其他函数:StringUtils.center( testString, count,repeatString );
函数介绍:把testString插入将repeatString重复多次后的字符串中间,得到字符串
的总长为count
例程:
System.out.println( StringUtils.center( "China", 11,"*"));
输出如下:
***China***
8.颠倒字符串
使用函数:StringUtils.reverse(testString)
函数介绍:得到testString中字符颠倒后的字符串
例程:
System.out.println( StringUtils.reverse("ABCDE"));
输出如下:
EDCBA
9.判断字符串内容的类型
函数介绍:
StringUtils.isNumeric( testString ) :如果testString全由数字组成返回True
StringUtils.isAlpha( testString ) :如果testString全由字母组成返回True
StringUtils.isAlphanumeric( testString ) :如果testString全由数字或数字组
成返回True
StringUtils.isAlphaspace( testString ) :如果testString全由字母或空格组
成返回True
例程:
String state = "Virginia";
System.out.println( "Is state number? " + StringUtils.isNumeric(
state ) );
System.out.println( "Is state alpha? " + StringUtils.isAlpha( state )
);
System.out.println( "Is state alphanumeric? " +StringUtils.isAlphanumeric( state ) );
System.out.println( "Is state alphaspace? " + StringUtils.isAlphaSpace( state ) );
输出如下:
Is state number? false
Is state alpha? true
Is state alphanumeric? true
Is state alphaspace? true
10.取得某字符串在另一字符串中出现的次数
使用函数:StringUtils.countMatches(testString,seqString)
函数介绍:取得seqString在testString中出现的次数,未发现则返回零
例程:
System.out.println(StringUtils.countMatches( "Chinese People", "e"
));
输出:
4
11.部分截取字符串
使用函数:
StringUtils.substringBetween(testString,fromString,toString ):取得两字符
之间的字符串
StringUtils.substringAfter( ):取得指定字符串后的字符串
StringUtils.substringBefore( )：取得指定字符串之前的字符串
StringUtils.substringBeforeLast( )：取得最后一个指定字符串之前的字符串
StringUtils.substringAfterLast( )：取得最后一个指定字符串之后的字符串
函数介绍：上面应该都讲明白了吧。
例程：
String formatted = " 25 * (30,40) [50,60] | 30";
System.out.print("N0: " + StringUtils.substringBeforeLast( formatted, "*" ) );
System.out.print(", N1: " + StringUtils.substringBetween( formatted, "(", "," ) );
System.out.print(", N2: " + StringUtils.substringBetween( formatted, ",", ")" ) );
System.out.print(", N3: " + StringUtils.substringBetween( formatted, "[", "," ) );
System.out.print(", N4: " + StringUtils.substringBetween( formatted, ",", "]" ) );
System.out.print(", N5: " + StringUtils.substringAfterLast( formatted, "|" ) );
输出如下：
N0: 25 , N1: 30, N2: 40, N3: 50, N4: 40) [50,60, N5: 30