Apache Commons 工具包

Myth丶恋晨 2022-08-21 09:39 290阅读 0赞

### Apache Commons是一个非常有用的工具包，解决各种实际的通用问题，下面是一个简述表，详细信息访问[http://jakarta.apache.org/commons/index.html][http_jakarta.apache.org_commons_index.html] ###

**BeanUtils**  
Commons-BeanUtils 提供对 Java 反射和自省API的包装

**Betwixt**  
Betwixt提供将 JavaBean 映射至 XML 文档，以及相反映射的服务.

**Chain**  
Chain 提供实现组织复杂的处理流程的“责任链模式”.

**CLI**  
CLI 提供针对命令行参数，选项，选项组，强制选项等的简单API.

**Codec**  
Codec 包含一些通用的编码解码算法。包括一些语音编码器， Hex, Base64, 以及URL encoder.

**Collections**  
Commons-Collections 提供一个类包来扩展和增加标准的 Java Collection框架

**Configuration**  
Commons-Configuration 工具对各种各式的配置和参考文件提供读取帮助.

**Daemon**  
一种 unix-daemon-like java 代码的替代机制

**DBCP**  
Commons-DBCP 提供数据库连接池服务

**DbUtils**  
DbUtils 是一个 JDBC helper 类库，完成数据库任务的简单的资源清除代码.

**Digester**  
Commons-Digester 是一个 XML-Java对象的映射工具，用于解析 XML配置文件.

**Discovery**  
Commons-Discovery 提供工具来定位资源 (包括类) ，通过使用各种模式来映射服务/引用名称和资源名称。.

**EL**  
Commons-EL 提供在JSP2.0规范中定义的EL表达式的解释器.

**FileUpload**  
FileUpload 使得在你可以在应用和Servlet中容易的加入强大和高性能的文件上传能力

**HttpClient**  
Commons-HttpClient 提供了可以工作于HTTP协议客户端的一个框架.

**IO**  
IO 是一个 I/O 工具集

**Jelly**  
Jelly是一个基于 XML 的脚本和处理引擎。 Jelly 借鉴了 JSP 定指标签，Velocity, Cocoon和Xdoclet中的脚本引擎的许多优点。Jelly 可以用在命令行， Ant 或者 Servlet之中。

**Jexl**  
Jexl是一个表达式语言，通过借鉴来自于Velocity的经验扩展了JSTL定义的表达式语言。.

**JXPath**  
Commons-JXPath 提供了使用Xpath语法操纵符合Java类命名规范的 JavaBeans的工具。也支持 maps, DOM 和其他对象模型。.

**Lang**  
Commons-Lang 提供了许多许多通用的工具类集，提供了一些java.lang中类的扩展功能

**Latka**  
Commons-Latka 是一个HTTP 功能测试包，用于自动化的QA,验收和衰减测试.

**Launcher**  
Launcher 组件是一个交叉平台的Java 应用载入器。 Commons-launcher 消除了需要批处理或者Shell脚本来载入Java 类。.原始的 Java 类来自于Jakarta Tomcat 4.0 项目

**Logging**  
Commons-Logging 是一个各种 logging API实现的包裹类.

**Math**  
Math 是一个轻量的，自包含的数学和统计组件，解决了许多非常通用但没有及时出现在Java标准语言中的实践问题.

**Modeler**  
Commons-Modeler 提供了建模兼容JMX规范的 Mbean的机制.

**Net**  
Net 是一个网络工具集，基于 NetComponents 代码，包括 FTP 客户端等等。

**Pool**  
Commons-Pool 提供了通用对象池接口，一个用于创建模块化对象池的工具包，以及通常的对象池实现.

**Primitives**  
Commons-Primitives提供了一个更小，更快和更易使用的对Java基本类型的支持。当前主要是针对基本类型的 collection。.

**Validator**  
The commons-validator提供了一个简单的，可扩展的框架来在一个XML文件中定义校验器 (校验方法)和校验规则。支持校验规则的和错误消息的国际化。

Apache Commons包含了很多开源的工具，用于解决平时编程经常会遇到的问题，减少重复劳动。我选了一些比较常用的项目做简单介绍。文中用了很多网上现成的东西，我只是做了一个汇总整理。  
  
Commons BeanUtils  
[http://jakarta.apache.org/commons/beanutils/index.html][http_jakarta.apache.org_commons_beanutils_index.html]  
说明：针对Bean的一个工具集。由于Bean往往是有一堆get和set组成，所以BeanUtils也是在此基础上进行一些包装。  
使用示例：功能有很多，网站上有详细介绍。一个比较常用的功能是Bean Copy，也就是copy bean的属性。如果做分层架构开发的话就会用到，比如从PO（Persistent Object）拷贝数据到VO（Value Object）。  
传统方法如下：  
//得到TeacherForm  
TeacherForm teacherForm=(TeacherForm)form;  
//构造Teacher对象  
Teacher teacher=new Teacher();  
//赋值  
teacher.setName(teacherForm.getName());  
teacher.setAge(teacherForm.getAge());  
teacher.setGender(teacherForm.getGender());  
teacher.setMajor(teacherForm.getMajor());  
teacher.setDepartment(teacherForm.getDepartment());  
  
//持久化Teacher对象到数据库  
HibernateDAO= ;  
HibernateDAO.save(teacher);  
  
使用BeanUtils后，代码就大大改观了，如下所示：  
//得到TeacherForm  
TeacherForm teacherForm=(TeacherForm)form;  
//构造Teacher对象  
Teacher teacher=new Teacher();  
//赋值  
BeanUtils.copyProperties(teacher,teacherForm);  
//持久化Teacher对象到数据库  
HibernateDAO= ;  
HibernateDAO.save(teacher);  
  
Commons CLI  
[http://jakarta.apache.org/commons/cli/index.html][http_jakarta.apache.org_commons_cli_index.html]  
说明：这是一个处理命令的工具。比如main方法输入的string\[\]需要解析。你可以预先定义好参数的规则，然后就可以调用CLI来解析。  
使用示例：  
// create Options object  
Options options = new Options();  
// add t option, option is the command parameter, false indicates that  
// this parameter is not required.  
options.addOption(“t”, false, “display current time”);  
options.addOption("c", true, "country code");  
CommandLineParser parser = new PosixParser();  
CommandLine cmd = parser.parse( options, args);  
if(cmd.hasOption("t")) \{  
// print the date and time  
\}  
else \{  
// print the date  
\}  
// get c option value  
String countryCode = cmd.getOptionValue("c");  
  
if(countryCode == null) \{  
// print default date  
\}  
else \{  
// print date for country specified by countryCode  
\}  
  
Commons Codec  
[http://jakarta.apache.org/commons/codec/index.html][http_jakarta.apache.org_commons_codec_index.html]  
说明：这个工具是用来编码和解码的，包括Base64，URL，Soundx等等。用这个工具的人应该很清楚这些，我就不多介绍了。  
  
Commons Collections  
[http://jakarta.apache.org/commons/collections/][http_jakarta.apache.org_commons_collections]  
说明：你可以把这个工具看成是java.util的扩展。  
使用示例：举一个简单的例子  
OrderedMap map = new LinkedMap();  
map.put("FIVE", "5");  
map.put("SIX", "6");  
map.put("SEVEN", "7");  
map.firstKey(); // returns "FIVE"  
map.nextKey("FIVE"); // returns "SIX"  
map.nextKey("SIX"); // returns "SEVEN"  
  
Commons Configuration  
[http://jakarta.apache.org/commons/configuration/][http_jakarta.apache.org_commons_configuration]  
说明：这个工具是用来帮助处理配置文件的，支持很多种存储方式  
1. Properties files  
2. XML documents  
3. Property list files (.plist)  
4. JNDI  
5. JDBC Datasource  
6. System properties  
7. Applet parameters  
8. Servlet parameters  
使用示例：举一个Properties的简单例子  
\# usergui.properties, definining the GUI,  
colors.background = \#FFFFFF  
colors.foreground = \#000080  
  
window.width = 500  
window.height = 300  
  
PropertiesConfiguration config = new PropertiesConfiguration("usergui.properties");  
config.setProperty("colors.background", "\#000000);  
config.save();  
config.save("usergui.backup.properties);//save a copy  
Integer integer = config.getInteger("window.width");  
  
Commons DBCP  
[http://jakarta.apache.org/commons/dbcp/][http_jakarta.apache.org_commons_dbcp]  
说明：Database Connection pool, Tomcat就是用的这个，不用我多说了吧，要用的自己去网站上看说明。  
  
Commons DbUtils  
[http://jakarta.apache.org/commons/dbutils/][http_jakarta.apache.org_commons_dbutils]  
说明：我以前在写数据库程序的时候，往往把数据库操作单独做一个包。DbUtils就是这样一个工具，以后开发不用再重复这样的工作了。值得一体的是，这个工具并不是现在流行的OR-Mapping工具（比如Hibernate），只是简化数据库操作，比如  
QueryRunner run = new QueryRunner(dataSource);  
// Execute the query and get the results back from the handler  
Object\[\] result = (Object\[\]) run.query(  
"SELECT \* FROM Person WHERE name=?", "John Doe");  
  
Commons FileUpload  
[http://jakarta.apache.org/commons/fileupload/][http_jakarta.apache.org_commons_fileupload]  
说明：jsp的上传文件功能怎么做呢？  
使用示例：  
// Create a factory for disk-based file items  
FileItemFactory factory = new DiskFileItemFactory();  
  
// Create a new file upload handler  
ServletFileUpload upload = new ServletFileUpload(factory);  
  
// Parse the request  
List /\* FileItem \*/ items = upload.parseRequest(request);  
// Process the uploaded items  
Iterator iter = items.iterator();  
while (iter.hasNext()) \{  
FileItem item = (FileItem) iter.next();  
  
if (item.isFormField()) \{  
processFormField(item);  
\} else \{  
processUploadedFile(item);  
\}  
\}  
  
Commons HttpClient  
[http://jakarta.apache.org/commons/httpclient/][http_jakarta.apache.org_commons_httpclient]  
说明：这个工具可以方便通过编程的方式去访问网站。  
使用示例：最简单的Get操作  
GetMethod get = new GetMethod("http://jakarta.apache.org");  
// execute method and handle any error responses.  
...  
InputStream in = get.getResponseBodyAsStream();  
// Process the data from the input stream.  
get.releaseConnection();  
  
Commons IO  
http://jakarta.apache.org/commons/io/  
说明：可以看成是java.io的扩展，我觉得用起来非常方便。  
使用示例：  
1．读取Stream  
标准代码：  
InputStream in = new URL( "http://jakarta.apache.org" ).openStream();  
try \{  
InputStreamReader inR = new InputStreamReader( in );  
BufferedReader buf = new BufferedReader( inR );  
String line;  
while ( ( line = buf.readLine() ) != null ) \{  
System.out.println( line );  
\}  
\} finally \{  
in.close();  
\}  
使用IOUtils  
InputStream in = new URL( "http://jakarta.apache.org" ).openStream();  
try \{  
System.out.println( IOUtils.toString( in ) );  
\} finally \{  
IOUtils.closeQuietly(in);  
\}  
  
2．读取文件  
File file = new File("/commons/io/project.properties");  
List lines = FileUtils.readLines(file, "UTF-8");  
  
3．察看剩余空间  
long freeSpace = FileSystemUtils.freeSpace("C:/");  
  
  
Commons JXPath  
http://jakarta.apache.org/commons/jxpath/  
说明：Xpath你知道吧，那么JXpath就是基于Java对象的Xpath，也就是用Xpath对Java对象进行查询。这个东西还是很有想像力的。  
使用示例：  
Address address = (Address)JXPathContext.newContext(vendor).  
getValue("locations\[address/zipCode='90210'\]/address");  
上述代码等同于  
Address address = null;  
Collection locations = vendor.getLocations();  
Iterator it = locations.iterator();  
while (it.hasNext())\{  
Location location = (Location)it.next();  
String zipCode = location.getAddress().getZipCode();  
if (zipCode.equals("90210"))\{  
address = location.getAddress();  
break;  
\}  
\}  
  
  
Commons Lang  
http://jakarta.apache.org/commons/lang/  
说明：这个工具包可以看成是对java.lang的扩展。提供了诸如StringUtils, StringEscapeUtils, RandomStringUtils, Tokenizer, WordUtils等工具类。  
  
Commons Logging  
http://jakarta.apache.org/commons/logging/  
说明：你知道Log4j吗？  
  
Commons Math  
http://jakarta.apache.org/commons/math/  
说明：看名字你就应该知道这个包是用来干嘛的了吧。这个包提供的功能有些和Commons Lang重复了，但是这个包更专注于做数学工具，功能更强大。  
  
Commons Net  
http://jakarta.apache.org/commons/net/  
说明：这个包还是很实用的，封装了很多网络协议。  
1. FTP  
2. NNTP  
3. SMTP  
4. POP3  
5. Telnet  
6. TFTP  
7. Finger  
8. Whois  
9. rexec/rcmd/rlogin  
10. Time (rdate) and Daytime  
11. Echo  
12. Discard  
13. NTP/SNTP  
使用示例：  
TelnetClient telnet = new TelnetClient();  
telnet.connect( "192.168.1.99", 23 );  
InputStream in = telnet.getInputStream();  
PrintStream out = new PrintStream( telnet.getOutputStream() );  
...  
telnet.close();  
  
Commons Validator  
http://jakarta.apache.org/commons/validator/  
说明：用来帮助进行验证的工具。比如验证Email字符串，日期字符串等是否合法。  
使用示例：  
// Get the Date validator  
DateValidator validator = DateValidator.getInstance();  
// Validate/Convert the date  
Date fooDate = validator.validate(fooString, "dd/MM/yyyy");  
if (fooDate == null) \{  
// error...not a valid date  
return;  
\}  
  
Commons Virtual File System  
http://jakarta.apache.org/commons/vfs/  
说明：提供对各种资源的访问接口。支持的资源类型包括  
1. CIFS  
2. FTP  
3. Local Files  
4. HTTP and HTTPS  
5. SFTP  
6. Temporary Files  
7. WebDAV  
8. Zip, Jar and Tar (uncompressed, tgz or tbz2)  
9. gzip and bzip2  
10. res  
11. ram  
这个包的功能很强大，极大的简化了程序对资源的访问。  
使用示例：  
从jar中读取文件  
// Locate the Jar file  
FileSystemManager fsManager = VFS.getManager();  
FileObject jarFile = fsManager.resolveFile( "jar:lib/aJarFile.jar" );  
  
// List the children of the Jar file  
FileObject\[\] children = jarFile.getChildren();  
System.out.println( "Children of " + jarFile.getName().getURI() );  
for ( int i = 0; i < children.length; i++ )  
\{  
System.out.println( children\[ i \].getName().getBaseName() );  
\}  
从smb读取文件  
StaticUserAuthenticator auth = new StaticUserAuthenticator("username", "password", null);  
FileSystemOptions opts = new FileSystemOptions();  
DefaultFileSystemConfigBuilder.getInstance().setUserAuthenticator(opts, auth);  
FileObject fo = VFS.getManager().resolveFile("smb://host/anyshare/dir", opts);  
  
  
有人说Apache就像是丐帮，里面的项目多而杂。的确如此，Apache的项目水平参差不齐，而且不同的项目之间也常常会有功能重叠，甚至有撞车，比如Ant和Maven。不过Apache的优秀项目还是有很多的，比如Apache Http Server，Tomcat，Ant, Geronimo等等。Apache Commons是工具包，为其他项目提供支持，很多Commons中的项目就是从其他项目中抽取出来的。希望我的介绍能对你有所帮助，有些我提到的Commons中的项目我也没有用过，只是现学现卖，难免错误和疏漏，希望谅解。

[http_jakarta.apache.org_commons_index.html]: http://jakarta.apache.org/commons/index.html
[http_jakarta.apache.org_commons_beanutils_index.html]: http://jakarta.apache.org/commons/beanutils/index.html
[http_jakarta.apache.org_commons_cli_index.html]: http://jakarta.apache.org/commons/cli/index.html
[http_jakarta.apache.org_commons_codec_index.html]: http://jakarta.apache.org/commons/codec/index.html
[http_jakarta.apache.org_commons_collections]: http://jakarta.apache.org/commons/collections/
[http_jakarta.apache.org_commons_configuration]: http://jakarta.apache.org/commons/configuration/
[http_jakarta.apache.org_commons_dbcp]: http://jakarta.apache.org/commons/dbcp/
[http_jakarta.apache.org_commons_dbutils]: http://jakarta.apache.org/commons/dbutils/
[http_jakarta.apache.org_commons_fileupload]: http://jakarta.apache.org/commons/fileupload/
[http_jakarta.apache.org_commons_httpclient]: http://jakarta.apache.org/commons/httpclient/