Apache DBUtils

• 简介

commons-dbutils 是 Apache 组织提供的一个开源 JDBC工具类库，它是对JDBC的简单封装，学习成本极低，并且使用dbutils能极大简化jdbc编码的工作量，同时也不会影响程序的性能。

• DbUtils API：
  1. DbUtils ：提供如关闭连接、装载JDBC驱动程序等常规工作的工具类，里面的所有方法都是静态的。主要方法如下：

lpublic static void close(…) throws java.sql.SQLException：　DbUtils类提供了三个重载的关闭方法。这些方法检查所提供的参数是不是NULL，如果不是的话，它们就关闭Connection、Statement和ResultSet。

lpublic static void closeQuietly(…): 这一类方法不仅能在Connection、Statement和ResultSet为NULL情况下避免关闭，还能隐藏一些在程序中抛出的SQLEeception。

lpublic static void commitAndClose(Connection conn)throws SQLException 用来提交连接的事务，然后关闭连接

lpublic static void commitAndCloseQuietly(Connection conn)： 用来提交连接的事务，然后关闭连接，并且在关闭连接时不抛出SQL异常。

lpublic static void rollback(Connection conn)throws SQLException允许conn为null，因为方法内部做了判断

lpublic static void rollbackAndClose(Connection conn)throws SQLException

lrollbackAndCloseQuietly(Connection)

lpublic static boolean loadDriver(java.lang.String driverClassName)：这一方装载并注册JDBC驱动程序，如果成功就返回true。使用该方法，你不需要捕捉这个异常ClassNotFoundException。

 

QueryRunner类：该类封装了SQL的执行，是线程安全的。

（1）可以实现增、删、改、查、批处理、

（2）考虑了事务处理需要共用Connection。

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

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

lQueryRunner()：默认的构造方法

lQueryRunner(DataSource ds)：需要一个 javax.sql.DataSource 来作参数的构造方法。

 

• 使用QueryRunner类实现更新（增、删、改、批处理）

（1）更新

public int update(Connection conn, String sql, Object... params) throws SQLException:用来执行一个更新（插入、更新或删除）操作。

public int update(Connection conn, String sql) throws SQLException：用来执行一个不需要置换参数的更新操作。

（2）插入

public <T> T insert(Connection conn,String sql,ResultSetHandler<T> rsh)throws SQLException：其中 rsh - The handler used to create the result object from the ResultSet of auto-generated keys.  返回值: An object generated by the handler.即自动生成的键值

public <T> T insert(Connection conn,String sql,ResultSetHandler<T> rsh, Object... params) throws SQLException：只支持INSERT

public <T> T insert(String sql,ResultSetHandler<T> rsh)throws SQLException：只支持INSERT

public <T> T insert(String sql,ResultSetHandler<T> rsh,Object... params)throws SQLException：只支持INSERT

（3）批处理

public int[] batch(Connection conn,String sql,Object[][] params)throws SQLException： INSERT, UPDATE, or DELETE语句

public int[] batch(String sql,Object[][] params)throws SQLException： INSERT, UPDATE, or DELETE语句

public <T> T insertBatch(Connection conn,String sql,ResultSetHandler<T> rsh,Object[][] params)throws SQLException：只支持INSERT

public <T> T insertBatch(String sql,ResultSetHandler<T> rsh,Object[][] params)throws SQLException：只支持INSERT

（4）是否需要传递Connection？

A：不需要传递Connection对象：

前提是不考虑事务而且QueryRunner对象创建时指定数据源，这样在QueryRunner的所有增删改查方法中都会从数据源中自己获取连接

B：必须传递Connection对象

如果有事务，必须传递Connection对象，因为同一个事务的多条语句必须在一个Connection连接中完成

（5）使用QueryRunner类实现查询

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

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

lpublic Object query(Connection conn, String sql, ResultSetHandler rsh) throws SQLException : 执行一个不需要置换参数的查询操作。

lpublic Object query( String sql, ResultSetHandler rsh) throws SQLException : 执行一个不需要置换参数的查询操作。

 

• JDBC修改成DbUtils版

package com.atguigu.utils;

import java.sql.Connection;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.Statement;

import org.apache.commons.dbutils.DbUtils;

import com.mchange.v2.c3p0.ComboPooledDataSource;

public class DBUtilsTool {
	//创建数据源，用的是c3p0-config.xml文件中<default-config>
	private static ComboPooledDataSource dataSource = new ComboPooledDataSource();
	
	//获取数据源对象
	public static ComboPooledDataSource getDataSource() {
		return dataSource;
	}

	//获取连接
	public static Connection getConnection() throws SQLException{
		return dataSource.getConnection();
	}
	
	public static void closeQuietly(Connection conn){
		DbUtils.closeQuietly(conn);
	}
	
	public static void closeQuietly(Statement st){
		DbUtils.closeQuietly(st);
	}
	
	public static void closeQuietly(ResultSet rs){
		DbUtils.closeQuietly(rs);
	}

}