1. 简介
commons-dbutils 是 Apache 组织提供的一个开源 JDBC工具类库,它是对JDBC的简单封装,学习成本极低,并且使用dbutils能极大简化jdbc编码的工作量,同时也不会影响程序的性能。因此dbutils成为很多不喜欢hibernate的公司的首选。
API介绍:
org.apache.commons.dbutils.QueryRunner --BDManager
org.apache.commons.dbutils.ResultSetHandler—处理结果集
工具类
org.apache.commons.dbutils.DbUtils、。
2. DbUtils类
DbUtils :提供如关闭连接、装载JDBC驱动程序等常规工作的工具类,里面的所有方法都是静态的。主要方法如下:
下面简单介绍一下其中方法,详细参考帮助文档。
public static void close(…) throws java.sql.SQLException: DbUtils类提供了三个重载的关闭方法。这些方法检查所提供的参数是不是NULL,如果不是的话,它们就关闭Connection、Statement和ResultSet。
public static void closeQuietly(…): 这一类方法不仅能在Connection、Statement和ResultSet为NULL情况下避免关闭,还能隐藏一些在程序中抛出的SQLEeception。即多添加了咱们自己做关闭方法时对con、rs、st是否为空的判读语句。
public static void commitAndCloseQuietly(Connection conn): 用来提交连接,然后关闭连接,并且在关闭连接时不抛出SQL异常。
public static boolean loadDriver(java.lang.String driverClassName):这一方装载并注册JDBC驱动程序,如果成功就返回true。使用该方法,你不需要捕捉这个异常ClassNotFoundException。
3.QueryRunner类
该类简单化了SQL查询,它与ResultSetHandler组合在一起使用可以完成大部分的数据库操作,能够大大减少编码量。
QueryRunner类提供了两个构造方法:
默认的构造方法
需要一个 javax.sql.DataSource 来作参数的构造方法。
public Object query(Connection conn, String sql, Object[] params, ResultSetHandler rsh) throws SQLException:执行一个查询操作,在这个查询中,对象数组中的每个元素值被用来作为查询语句的置换参数。该方法会自行处理 PreparedStatement 和 ResultSet 的创建和关闭。
public Object query(String sql, Object[] params, ResultSetHandler rsh) throws SQLException: 几乎与第一种方法一样;唯一的不同在于它不将数据库连接提供给方法,并且它是从提供给构造方法的数据源(DataSource) 或使用的setDataSource 方法中重新获得 Connection。
public Object query(Connection conn, String sql, ResultSetHandler rsh) throws SQLException : 执行一个不需要置换参数的查询操作。
public int update(Connection conn, String sql, Object[] params) throws SQLException:用来执行一个更新(插入、更新或删除)操作。
public int update(Connection conn, String sql) throws SQLException:用来执行一个不需要置换参数的更新操作。
4. ResultSetHandler接口
该接口用于处理 java.sql.ResultSet,将数据按要求转换为另一种形式。ResultSetHandler 接口提供了一个单独的方法:Object handle (java.sql.ResultSet .rs)。
ResultSetHandler接口实现类
ArrayHandler:把结果集中的第一行数据转成对象数组。
ArrayListHandler:把结果集中的每一行数据都转成一个数组,再存放到List中。
BeanHandler:将结果集中的第一行数据封装到一个对应的JavaBean实例中。
BeanListHandler:将结果集中的每一行数据都封装到一个对应的JavaBean实例中,存放到List里。
ColumnListHandler:将结果集中某一列的数据存放到List中。
KeyedHandler(name):将结果集中的每一行数据都封装到一个Map里,再把这些map再存到一个map里,其key为指定的key。
MapHandler:将结果集中的第一行数据封装到一个Map里,key是列名,value就是对应的值。
MapListHandler:将结果集中的每一行数据都封装到一个Map里,然后再存放到List
5. 以上知识点案例分析
对javabean的增删改查 package com.csdn.demo; import java.sql.SQLException; import java.util.List; import org.apache.commons.dbutils.QueryRunner; import org.apache.commons.dbutils.handlers.BeanHandler; import org.apache.commons.dbutils.handlers.BeanListHandler; import org.junit.Test; import com.csdn.domain.Users; import com.csdn.util.DBManager; public class Demo1 { @Test public void insert() throws SQLException{ QueryRunner qr = new QueryRunner(DBManager.getDataSource()); String sql = "insert into user (id,username,password) values (?,?,?)"; Object[] params = {3,"asd","asd"}; int i = qr.update(sql,params); if(i>0){ System.out.println("成功了"); } } @Test public void delete() throws SQLException{ QueryRunner qr = new QueryRunner(DBManager.getDataSource()); String sql = "delete from user where id = ?"; int i = qr.update(sql,17); if(i>0){ System.out.println("成功了"); } } @Test public void update() throws SQLException{ QueryRunner qr = new QueryRunner(DBManager.getDataSource()); String sql = "update user set username=? where id = ?"; Object[] params = {"aaaaa",3}; int i = qr.update(sql,params); if(i>0){ System.out.println("成功了"); } } @Test public void query() throws SQLException{ QueryRunner qr = new QueryRunner(DBManager.getDataSource()); String sql = "select id,username,password from user where id = ?"; Object[] params = {1}; Users user = (Users) qr.query(sql,params,new BeanHandler(Users.class)); System.out.println(user.getId()+"---"+user.getUsername()+"---"+user.getPassword()); } @Test public void queryAll() throws SQLException{ QueryRunner qr = new QueryRunner(DBManager.getDataSource()); String sql = "select id,username,password from user"; List<Users> list = (List<Users>) qr.query(sql,new BeanListHandler(Users.class)); for(Users users : list){ System.out.println(users.getId()+"---"+users.getUsername()+"---"+users.getPassword()); } } } 其他处理器的运用 package com.csdn.demo; import java.sql.SQLException; import java.util.Arrays; import java.util.List; import java.util.Map; import org.apache.commons.dbutils.QueryRunner; import org.apache.commons.dbutils.handlers.ArrayHandler; import org.apache.commons.dbutils.handlers.ArrayListHandler; import org.apache.commons.dbutils.handlers.ColumnListHandler; import org.apache.commons.dbutils.handlers.KeyedHandler; import org.apache.commons.dbutils.handlers.MapHandler; import org.apache.commons.dbutils.handlers.MapListHandler; import org.junit.Test; import com.csdn.util.DBManager; public class Demo2 { //改处理器只返回一行 @Test public void testArrayHandler () throws SQLException{ QueryRunner qr = new QueryRunner(DBManager.getDataSource()); String sql = "select id,username,password from user"; Object[] object = qr.query(sql, new ArrayHandler()); System.out.println(object.length); //列表输出,与下面的增强for循环效果一样 System.out.println(Arrays.asList(object)); // for(Object o : object){ // System.out.println(o); // } } @Test public void testArrayListHandler () throws SQLException{ QueryRunner qr = new QueryRunner(DBManager.getDataSource()); String sql = "select id,username,password from user"; List<Object[]> list = qr.query(sql, new ArrayListHandler()); System.out.println(list.size()); for(Object[] o : list){ System.out.println(Arrays.asList(o)); } } @Test public void testColumnListHandler () throws SQLException{ QueryRunner qr = new QueryRunner(DBManager.getDataSource()); String sql = "select id,username,password from user"; List list = qr.query(sql, new ColumnListHandler()); System.out.println(list); } @Test public void testKeyedHandler () throws SQLException{ QueryRunner qr = new QueryRunner(DBManager.getDataSource()); String sql = "select id,username,password from user"; Map<Object,Map<String,Object>> map = qr.query(sql, new KeyedHandler()); for(Map.Entry<Object,Map<String,Object>> me : map.entrySet()){ Map<String,Object> innerMe = me.getValue(); for(Map.Entry<String,Object> entry : innerMe.entrySet()){ System.out.println(entry.getKey()+"="+entry.getValue()); } } } @Test public void testMapHandler () throws SQLException{ QueryRunner qr = new QueryRunner(DBManager.getDataSource()); String sql = "select id,username,password from user"; Map map = qr.query(sql,new MapHandler()); System.out.println(map); } @Test public void testMapListHandler () throws SQLException{ QueryRunner qr = new QueryRunner(DBManager.getDataSource()); String sql = "select id,username,password from user"; List list = qr.query(sql,new MapListHandler()); System.out.println(list); } }