DbUtils开源组件--源码研究和应用实践小结
DbUtils开源组件--源码研究和应用实践小结
FansUnion 发表于3年前
DbUtils开源组件--源码研究和应用实践小结
  • 发表于 3年前
  • 阅读 4
  • 收藏 0
  • 点赞 0
  • 评论 0

移动开发云端新模式探索实践 >>>   

 

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,数据库表建表脚本。


 

版权声明:本文为博主原创文章,未经博主允许不得转载。

  • 打赏
  • 点赞
  • 收藏
  • 分享
共有 人打赏支持
粉丝 55
博文 857
码字总数 825464
×
FansUnion
如果觉得我的文章对您有用,请随意打赏。您的支持将鼓励我继续创作!
* 金额(元)
¥1 ¥5 ¥10 ¥20 其他金额
打赏人
留言
* 支付类型
微信扫码支付
打赏金额:
已支付成功
打赏金额: