JDBC Apache-DBUtils实现CRUD操作（7）

1 Apache-DBUtils简介

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

• API介绍：

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

2 主要API的使用

2.1 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 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。

2.2 QueryRunner类

• 该类简单化了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);

}

2.3 ResultSetHandler接口及实现类

• 该接口用于处理 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：**查询单个值对象

• 测试

	/**
	 * 
	 * @Description BeanHandler
	 * @author wkq
	 * @date 2020年4月8日下午11:37:39
	 * @throws Exception
	 */
	@Test
	public void testQuery1() throws Exception {
		QueryRunner runner = new QueryRunner();
		Connection conn = DruidUtile.getConnection();
		String sql = "SELECT id,name,email,birth from customers where name = ?";
		BeanHandler<Customer> handler = new BeanHandler<>(Customer.class);
		
		Customer query = runner.query(conn, sql, handler, "贝多芬");	
		System.out.println(query);
		DruidUtile.closeResource(null, conn);
	}

	/**
	 * 
	 * @Description BeanListHandler
	 * @author wkq
	 * @date 2020年4月9日上午12:35:31
	 * @throws Exception
	 */
	@Test
	public void testQuery2() throws Exception {
		QueryRunner runner = new QueryRunner();

		Connection conn = DruidUtile.getConnection();
			
		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);
		
		
			
		DruidUtile.closeResource(null,conn);
		
	}

	/**
	 * 
	 * @Description MapHandler
	 * @author wkq
	 * @date 2020年4月9日上午12:35:11
	 * @throws Exception
	 */
	@Test
	public void testQuery3() throws Exception {
		QueryRunner runner = new QueryRunner();
		Connection conn = DruidUtile.getConnection();
		
		String sql = "select id,name,email,birth from customers where id = ?";
		MapHandler handler = new MapHandler();
		Map<String, Object> query = runner.query(conn, sql, handler, 1);
		System.out.println(query);
		DruidUtile.closeResource(null, conn);
	}

/**
	 * 
	 * @Description MapListHandler
	 * @author wkq
	 * @date 2020年4月9日上午12:35:07
	 * @throws Exception
	 */
	@Test
	public void testQuery4() throws Exception {
		QueryRunner runner = new QueryRunner();
		Connection conn = DruidUtile.getConnection();
		
		String sql = "select id,name,email,birth from customers where id < ?";
		MapListHandler listHandler = new MapListHandler();
		List<Map<String, Object>> query = runner.query(conn, sql, listHandler,23);
		query.forEach(System.out::println);
	}

	
	/**
	 * 
	 * @Description ScalarHandler
	 * @author wkq
	 * @date 2020年4月9日上午12:35:07
	 * @throws Exception
	 */
	@Test
	public void testQuery5() throws Exception {
		QueryRunner runner = new QueryRunner();
		Connection conn = DruidUtile.getConnection();
		
		String sql = "select count(*) from customers where id < ?";
		ScalarHandler handler = new ScalarHandler();
		Object query = runner.query(conn, sql, handler,23);
		System.out.println(query);
	}

/**
	 * 
	 * @Description ResultSetHandler
	 * @author wkq
	 * @date 2020年4月9日上午12:35:07
	 * @throws Exception
	 */
	@Test
	public void testQuery6() throws Exception {
		QueryRunner runner = new QueryRunner();
		Connection conn = DruidUtile.getConnection();
		
		String sql = "select id,name,email,birth from customers where id = 1";
		ResultSetHandler<Customer> rsh = new ResultSetHandler<Customer>(){

			@Override
			public Customer handle(ResultSet rs) throws SQLException {
				// 获取结果集的元数据
				ResultSetMetaData rsmd = rs.getMetaData();
				// 获取结果集的列数
				int columnCount = rsmd.getColumnCount();
				if (rs.next()) {
					Customer customer = new Customer();
					// 5.获取当前结果集每个数据的值
					for (int i = 0; i < columnCount; i++) {
						Object columnValue = rs.getObject(i+1);
						
						// 获取每一列的列名
						String columnName = rsmd.getColumnName(i+1);
						try {
							Field field = Customer.class.getDeclaredField(columnName);
							field.setAccessible(true);
							field.set(customer, columnValue);
						} catch (Exception e) {
							// TODO Auto-generated catch block
							e.printStackTrace();
						} 
					}
					return customer;
				}
				return null;
			}
		};
		Customer query = runner.query(conn, sql, rsh);
		System.out.println(query);
	}