Apache—Java数据库DBUtils框架简介

一、简介

Apache—DBUtils框架简介：DbUtils类、QueryRunner类 、ResultSetHandler接口

    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

 

二、 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。

---

public static void commitAndCloseQuietly(Connection conn)：

用来提交连接，然后关闭连接，并且在关闭连接时不抛出SQL异常。

---

public static boolean loadDriver(java.lang.String driverClassName)：

这一方装载并注册JDBC驱动程序，如果成功就返回true。使用该方法，你不需要捕捉这个异常ClassNotFoundException。

 

三、QueryRunner类

   该类简单化了SQL查询，它与ResultSetHandler组合在一起使用可以完成大部分的数据库操作，能够大大减少编码量。

 

QueryRunner类提供了两个构造方法：

•        默认的构造方法

•        需要一个 javax.sql.DataSource 来作参数的构造方法。

 

四、QueryRunner类的主要方法

 

    public Object query(Connection conn, Stringsql, Object[] params, ResultSetHandler rsh) throws SQLException：执行一个查询操作，在这个查询中，对象数组中的每个元素值被用来作为查询语句的置换参数。该方法会自行处理 PreparedStatement 和 ResultSet 的创建和关闭。

---

public Object query(String sql,Object[] params, ResultSetHandler rsh) throws SQLException:　几乎与第一种方法一样；唯一的不同在于它不将数据库连接提供给方法，并且它是从提供给构造方法的数据源(DataSource) 或使用的setDataSource 方法中重新获得 Connection。

sql参数：sql语句
params参数：是给sql语句传递的参数，有的时候需要有的时候不需要，具体看你的sql语句是什么。例如你的sql语句是“SELECT * FROM tb_user”，那这时候就不需要params参数，而如果你的sql语句是“SELECT * FROM tb_user WHERE username=? AND userid = ?”，那这个时候就需要params参数了，params参数是一个Object类型的数组，数组长度取决于你sql语句中的“？”个数，例如上面那个sql语句，有两个“？”，那你就要放两个参数在这个数组里，并且顺序要匹配上sql语句中的“？”的顺序，例如上面那个语句，你的params就应该写成：Object[] params = { 用户名称，用户ID }。

rsh参数：这是一个ResultSetHandler类型
一般都是创建一个该类型的子类对象然后传进去，该类型有五个常用子类，而传递的子类对象会决定query这个方法的返回值。五个常用子类对象分别是：BeanHandler、BeanListHandler、MapHandler、MapListHandler、ScalarHandler。传递这五个子类对象后query的返回值分别是：一个JavaBean对象、一个装有多个JavaBean对象的List集合对象、一个装有一行结果集的Map对象（也就是一个Map，Map装着的是一行结果集）、一个装有多个一行结果集的Map的List集合对象（也就是List里有多个Map，每个Map都是一行结果集）、一个Object类型（这种一般运用在查询结果只有一行一列的情况）

---

public Object query(Connectionconn, String sql, ResultSetHandler rsh) throws SQLException :

执行一个不需要置换参数的查询操作。

---

public int update(Connectionconn, String sql, Object[] params) throws SQLException:

用来执行一个更新（插入、更新或删除）操作。

---

public int update(Connectionconn, String sql) throws SQLException：

用来执行一个不需要置换参数的更新操作。

 

  五、ResultSetHandler接口

  该接口用于处理 java.sql.ResultSet，将数据按要求转换为另一种形式。

ResultSetHandler接口提供了一个单独的方法：Objecthandle (java.sql.ResultSet .rs)。

 

六、ResultSetHandler接口的实现类

ArrayHandler：把结果集中的第一行数据转成对象数组。
ArrayListHandler：把结果集中的每一行数据都转成一个对象数组，再存放到List中。
BeanHandler：将结果集中的第一行数据封装到一个对应的JavaBean实例中。
BeanListHandler：将结果集中的每一行数据都封装到一个对应的JavaBean实例中，存放到List里。//重点
MapHandler：将结果集中的第一行数据封装到一个Map里，key是列名，value就是对应的值。//重点
MapListHandler：将结果集中的每一行数据都封装到一个Map里，然后再存放到List
ColumnListHandler：将结果集中某一列的数据存放到List中。
KeyedHandler(name)：将结果集中的每一行数据都封装到一个Map里(List<Map>)，再把这些map再存到一个map里，其key为指定的列。
ScalarHandler:将结果集第一行的某一列放到某个对象中。//重点

七、应用案例：

c3p0配置文件c3p0-config.xml：

https://blog.csdn.net/weixin_41888813/article/details/81224565

---

使用C3p0获取数据源的工具类：

package com.imooc.utils;

import java.sql.SQLException;
import com.mchange.v2.c3p0.ComboPooledDataSource;
import com.mysql.jdbc.Connection;

public class JDBCUtils {
	
	/**
     * ComboPooledDataSource存储数据源接口池
     * 通过ComboPooledDataSource获取dateSource即数据源，可从中获取数据库的链接
     */
	//这个类是自己写的工具类在这里创建了一个连接池对象所有的连接都存在对象里这个对象就是连接池
    //定义一个连接池属性赋值为mull
    private static ComboPooledDataSource cpds = null;
    
    static {
        //创建一个连接池这里的创建的时候在构造函数里传入一个连接池名字它会自动的根据名字去找配置文件
        //在这里也可以不要这个配置文件可以创建对象以后对象会有一些方法同样可以设置配置文件里的东西
    	cpds = new ComboPooledDataSource("mysql");
    }
	   
    /**
     * 这个函数可以配合dbutils的构造函数使用
     * 因为dbuntils的构造函数参数是一个连接池
     *而这个函数正好返回一个连接池
     * @return 返回一个连接池就是上面创建的连接池
     */
    public static ComboPooledDataSource getDataSource(){
        //返回这个连接池
        return cpds;
    }
 
    /**
     * @return 返回一个从数据库里拿出来的连接
     * @throws SQLException
     */
    public static Connection getConnection() throws SQLException {
        //返回一条连接
        return (Connection) cpds.getConnection();
    }

}

insert操作：

package com.imooc.dao.impl;

import org.apache.commons.dbutils.QueryRunner;
import com.imooc.dao.UserDao;
import com.imooc.domain.User;
import com.imooc.utils.JDBCUtils;

public class UserDaoImpl implements UserDao {

	@Override
	public void regist(User user) {
		
		try {
			/**
			 * 该类简单化了SQL查询，它与ResultSetHandler组合在一起使用可以完成大部分的数据库操作，能够大大减少编码量。
			 * 
			 * QueryRunner类提供了两个构造方法：
			 * • 默认的构造方法
			 * • 需要一个 javax.sql.DataSource 来作参数的构造方法。
			 */
			QueryRunner queryRunner = new QueryRunner(JDBCUtils.getDataSource());
			String sql = "insert into user values (?,?,?,?,?,?,?)";
			Object[] params = {
					user.getUid(),
					user.getUsername(),
					user.getPassword(),
					user.getNickname(),
					user.getEmail(),
					user.getState(),
					user.getCode()	
			};
			queryRunner.update(sql, params);
		
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}

参考来源：

https://blog.csdn.net/damogu_arthur/article/details/40585999

https://www.jianshu.com/p/10241754cdd7

https://blog.csdn.net/zlx510tsde/article/details/9008281#