JDBC：（九）Apache-DBUtils实现CRUD操作

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

• API介绍：

  • org.apache.commons.dbutils.QueryRunner
  • org.apache.commons.dbutils.ResultSetHandler
  • 工具类：org.apache.commons.dbutils.DbUtils

• API包说明：

• 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 commitAndClose(Connection conn)throws SQLException： 用于提交连接的事务，然后关闭连接
  • public static void commitAndCloseQuietly(Connection conn)： 用于提交连接，然后关闭连接，关闭连接时不抛出SQL异常。
  • public static void rollback(Connection conn)throws SQLException：允许conn为null，因为方法内部做出了判断
  • public static void rollbackAndClose(Connection conn)throws SQLException
  • rollbackAndCloseQuietly(Connection)
  • public static boolean loadDriver(java.lang.String driverClassName)：这一方装载并注册JDBC如果驱动程序成功，请返回true。使用这种方法，你不需要捕捉这种异常ClassNotFoundException。

• 这种简化SQL查询，它与ResultSetHandler组合使用可以完成大部分数据库操作，可以大大降低编码量。

• QueryRunner类别提供两个结构器：

  • 默认结构器
  • 需要一个 javax.sql.DataSource 构造器作为参数

• QueryRunner类的主要方法：

  • 更新
    • public int update(Connection conn, String sql, Object… params) throws SQLException:用于更新(插入、更新或删除)。
    • …
  • 插入
    • public T insert(Connection conn,String sql,ResultSetHandler rsh, Object… params) throws SQLException：只支持INSERT语句，其中 rsh - The handler used to create the result object from the ResultSet of auto-generated keys. 返回值: An object generated by the handler.即自动生成的键值
    • …
  • 批处理
    • public int[] batch(Connection conn,String sql,Object[][] params)throws SQLException： INSERT, UPDATE, or DELETE语句
    • public T insertBatch(Connection conn,String sql,ResultSetHandler rsh,Object[][] params)throws SQLException：只支持INSERT语句
    • …
  • 查询
    • public Object query(Connection conn, String sql, ResultSetHandler rsh,Object… params) throws SQLException：执行查询操作，用于查询对象数组中的每个元素值作为查询句的替换参数。该方法将自行处理 PreparedStatement 和 ResultSet 创造和关闭。
    • …

• 测试

// 测试添加 @Test public void testInsert() throws Exception { 
          QueryRunner runner = new QueryRunner();  Connection conn = JDBCUtils.getConnection3();
	String sql = "insert into customers(name,email,birth)values(?,?,?)";
	int count = runner.update(conn, sql, "何成飞", "he@qq.com", "1992-09-08");

	System.out.println("添加了" + count + "条记录");
		
	JDBCUtils.closeResource(conn, null);

}

// 测试删除
@Test
public void testDelete() throws Exception { 
        
	QueryRunner runner = new QueryRunner();
	Connection conn = JDBCUtils.getConnection3();
	String sql = "delete from customers where id < ?";
	int count = runner.update(conn, sql,3);

	System.out.println("删除了" + count + "条记录");
		
	JDBCUtils.closeResource(conn, null);

}

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

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

• 接口的主要实现类：

  • ArrayHandler：把结果集中的第一行数据转成对象数组。

  • ArrayListHandler：把结果集中的每一行数据都转成一个数组，再存放到List中。

  • BeanHandler：将结果集中的第一行数据封装到一个对应的JavaBean实例中。

  • BeanListHandler：将结果集中的每一行数据都封装到一个对应的JavaBean实例中，存放到List里。

  • ColumnListHandler：将结果集中某一列的数据存放到List中。

  • KeyedHandler(name)：将结果集中的每一行数据都封装到一个Map里，再把这些map再存到一个map里，其key为指定的key。

  • MapHandler：将结果集中的第一行数据封装到一个Map里，key是列名，value就是对应的值。

  • MapListHandler：将结果集中的每一行数据都封装到一个Map里，然后再存放到List

  • ScalarHandler：查询单个值对象

• 测试

/* * 测试查询:查询一条记录 * * 使用ResultSetHandler的实现类：BeanHandler */
@Test
public void testQueryInstance() throws Exception{ 
        
	QueryRunner runner = new QueryRunner();

	Connection conn = JDBCUtils.getConnection3();
		
	String sql = "select id,name,email,birth from customers where id = ?";
		
	//
	BeanHandler<Customer> handler = new BeanHandler<>(Customer.class);
	Customer customer = runner.query(conn, sql, handler, 23);
	System.out.println(customer);	
	JDBCUtils.closeResource(conn, null);
}

/* * 测试查询:查询多条记录构成的集合 * * 使用ResultSetHandler的实现类：BeanListHandler */
@Test
public void testQueryList() throws Exception{ 
        
	QueryRunner runner = new QueryRunner();

	Connection conn = JDBCUtils.getConnection3();
		
	String sql = "select id,name,email,birth from customers where id < ?";
		
	//
	BeanListHandler<Customer> handler = new BeanListHandler<>(Customer.class);
	List<Customer> list = runner.query(conn, sql, handler, 23);
	list.forEach(System.out::println);
		
	JDBCUtils.closeResource(conn, null);
}

总结
@Test
public void testUpdateWithTx() { 
        
		
	Connection conn = null;
	try { 
        
		//1.获取连接的操作（
		//① 手写的连接：JDBCUtils.getConnection();
		//② 使用数据库连接池：C3P0;DBCP;Druid
		//2.对数据表进行一系列CRUD操作
		//① 使用PreparedStatement实现通用的增删改、查询操作（version 1.0 \ version 2.0)
//version2.0的增删改public void update(Connection conn,String sql,Object ... args){}
//version2.0的查询 public <T> T getInstance(Connection conn,Class<T> clazz,String sql,Object ... args){}
		//② 使用dbutils提供的jar包中提供的QueryRunner类
			
		//提交数据
		conn.commit();
			
	
	} catch (Exception e) { 
        
		e.printStackTrace();
			
			
		try { 
        
			//回滚数据
			conn.rollback();
		} catch (SQLException e1) { 
        
			e1.printStackTrace();
		}
			
	}finally{ 
        
		//3.关闭连接等操作
		//① JDBCUtils.closeResource();
		//② 使用dbutils提供的jar包中提供的DbUtils类提供了关闭的相关操作
			
	}
}