DbUtils开源组件--源码研究和应用实践小结

Apache Common DbUtils是操作数据库的组件，对传统操作数据库的类(JDBC)进行二次封装，可以把结果集转化成List。DbUtils封装了对JDBC的操作，简化了JDBC操作，可以少写代码。

官方网站：http://commons.apache.org/dbutils/

下载地址：http://commons.apache.org/dbutils/download_dbutils.cgi

官方例子：http://commons.apache.org/dbutils/examples.html(可能有个别错误)

个人例子：http://download.csdn.net/detail/fansunion/4840246





源码研究小结

一、概述

版本：1.4

包：3个，org.apache.commons.dbutils，

org.apache.commons.handlers,

org.apache.commons.dbutils.wrappers

接口：2个

类：22个（不包含package-info.java）

package-info.java:3个



二、org.apache.commons.dbutils包和类的解读

包含一些些核心类和接口，DbUtils, QueryRunner和ResultSetHandler接口最值得关注。



①DbUtils工具类

主要功能：

1.关闭资源(Connection,Statement,ResultSet)

2.提交与回滚(commit,rooback)

3.加载驱动(loadDriver)

4.打印堆栈和警告(printStackTrace,printWarnings)



②处理器

RowProcessor接口:将ResultSet的行转换为各种类型的对象。

BasicRowProcessor:RowProcessor接口的基本实现。

BeanProcessor：将列名和Bean的属性名进行匹配，将ResultSet的列转换成Bean属性。

子类可以覆盖这些方法，在处理链中，实现自定义行为。



③ProxyFactory（代理工厂）：



创建JDBC 7个接口的代理实现，避免了JDBC2和JDBC3接口的不兼容。

7个接口:Driver,Connection,Statement,PreparedStatement,CallableStatement,ResultSet,ResultSetMetaData



核心方法：newProxyInstance

public <T> T newProxyInstance(Class<T> type, InvocationHandler handler) {

return type.cast(Proxy.newProxyInstance(handler.getClass()

.getClassLoader(), new Class<?>[] { type }, handler));

}



④查询执行器

AbstractQueryRunner:QueryRunner 和AsyncQueryRunner的父类。

QueryRunner:查询处理器，执行query,update,batch操作。

AsyncQueryRunner:异步的查询处理器，执行query,update,batch操作。





⑤查询加载器

QueryLoader：查询集合的注册中心，多个相同的查询副本不必要全都加载到内存中。

这个实现加载属性文件,文件内容是 查询名到SQL的映射 。

主要方法：load,unload



⑥结果集迭代器

ResultSetIterator:把ResultSet包装进Iterator中。当你想存在一个非数据库应用层 带有模型中立的数据时，

这是非常有用的。这个实现类需要 ResultSet的isLast()方法已经被实现。



⑦ResultSetHandler接口

这个接口的实现类将ResultSet转换成其它的对象。

三、org.apache.commons.dbutils.handlers包和类的解读



ResultSetHandler接口的实现类（2个抽象类，9个具体类）

①KeydHandler

AbstractKeydHandler(KeyHandler)：返回Map.

将ResultSet的行转换成对象，存储在Map中，在指定的Key下。

KeyHandler：返回Map<Map>.

将ResultSet的行转换成Map，存储在Map中，在指定的Key下。



②ListHandler

AbstractListHander(ArrayListHandler,ColumnListHandler,MapListHandler)：

抽象类，简化ResultSetHandler类的开发，将ResultSet转换成List。

ArrayListHandler：将结果集转换成List<Object>.

ColumnListHandler：将结果集的某一列转换成List<Object>.

MapListHandler：将结果集转换成List<Map>.



③其它Handler

ArrayHandler：将结果集转换成Object[]。

BeanHandler<T>：将结果集的第一行转换成一个JavaBean.

BeanListHandler<T>：将结果集转换成List<Bean>.

MapHandler：将结果集的第一行转换成一个Map。

ScalarHandler：将结果集的某一列转换成Objects。

列通过columnIndex或columnName指定。



四、package org.apache.commons.dbutils.wrappers包和类的解读

包装类，给java.sql中的类增加功能。ResultSet的2个包装类。

①SqlNullCheckedResultSet：

包装ResultSet，使得调用每一个getXXX方法时，检查SQL NULL值。

如果通过getXXX方法获得的列值不是SQL NULL,返回列值，否则，代替值被返回。

该代替值默认为Java的null值，可以被类的实例覆盖。



使用示例：

Connection conn = // somehow get a connection
 Statement stmt = conn.createStatement();
 ResultSet rs = stmt.executeQuery("SELECT col1, col2 FROM table1");

 // Wrap the result set for SQL NULL checking
 SqlNullCheckedResultSet wrapper = new SqlNullCheckedResultSet(rs);
 wrapper.setNullString("---N/A---"); // Set null string
 wrapper.setNullInt(-999); // Set null integer
 rs = ProxyFactory.instance().createResultSet(wrapper);

 while (rs.next()) {
     // If col1 is SQL NULL, value returned will be "---N/A---"
     String col1 = rs.getString("col1");
     // If col2 is SQL NULL, value returned will be -999
     int col2 = rs.getInt("col2");
 }
 rs.close();

②StringTrimedResultSet：

包装ResultSet，使得通过getString() and getObject()获得的String，经过String.trim()方法处理。



使用示例：

ResultSet rs = // somehow get a ResultSet;

 // Substitute wrapped ResultSet with additional behavior for real ResultSet
 rs = StringTrimmedResultSet.wrap(rs);

 // Pass wrapped ResultSet to processor
 List list = new BasicRowProcessor().toBeanList(rs);

应用实践小结：



源码地址：http://download.csdn.net/detail/fansunion/4840246



一、cn.fansunion.dbutils.example，5个独立的例子。

1.AsyncUpdateExample.java,演示如何执行异步更新。

2.BeanHandlerExample.java,演示如何使用BeanHandler，将结果集的一行转换成一个JavaBean。

3.BeanListHandlerExample.java,演示BeanListHandler如何使用，BeanListHandler实现类将结果集转换成指定对象类型的集合。

4.InsertUpdateExample.java,演示如何执行添加和更新。

5.ResultSetHandlerExample.java,演示结果集处理器如何使用。



二、cn.fansunion.dbutils.example.connection，数据库连接。

1.ConnectionProvider.java,数据库连接的提供类。

2.PropertyReader.java,读取配置属性。

3.jdbc.properties 属性配置。



三、cn.fansunion.dbutils.example.common，公共资源。

1.DbUtilsExampleBase.java，DbUtils例子的父类，包含了一些常用的方法，获得连接、关闭连接、打印对象。

2.MyDataSource.java，自定义的数据源实现类。

3.Person.java，数据库表对应的实体类。

4.person.sql，数据库表建表脚本。