Jdbc系列十：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, 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：用来执行一个不需要置换参数的更新操作。
1、引入依赖

 <dependency>
	 <groupId>commons-dbutils</groupId>
     <artifactId>commons-dbutils</artifactId>
     <version>1.3</version>
</dependency>

2、 测试 QueryRunner 类的 update 方法。该方法可用于 INSERT, UPDATE 和 DELETE

@Test
public void testQueryRunnerUpdate() {
	//1. 创建 QueryRunner 的实现类
	QueryRunner queryRunner = new QueryRunner();
	
	String sql = "DELETE FROM user " +
			"WHERE id IN (?)";
	
	Connection connection = null;
	
	try {
		connection = JDBCTools.getConnection();
		//2. 使用其 update 方法
		queryRunner.update(connection, 
				sql, 1);
	} catch (Exception e) {
		e.printStackTrace();
	} finally{
		JDBCTools.releaseDB(null, null, connection);
	}
	
}

3、测试 QueryRunner 的 query 方法和ResultSetHandler接口

@SuppressWarnings({ "unchecked", "rawtypes" })
@Test
public void testResultSetHandler(){
	String sql = "SELECT id, name FROM user";
	
	//1. 创建 QueryRunner 对象
	QueryRunner queryRunner = new QueryRunner();
	
	Connection conn = null;
	
	try {
		conn = JDBCTools.getConnection();
		/**
		 * 2. 调用 query 方法:
		 * ResultSetHandler 参数的作用: query 方法的返回值直接取决于 
		 * ResultSetHandler 的 hanlde(ResultSet rs) 是如何实现的. 实际上, 在
		 * QueryRunner 类的 query 方法中也是调用了 ResultSetHandler 的 handle()
		 * 方法作为返回值的。
		 */
		Object object = queryRunner.query(conn, sql, 
				new ResultSetHandler(){
					@Override
					public Object handle(ResultSet rs) throws SQLException {
						List<User> users = new ArrayList<>();
						
						while(rs.next()){
							String id = rs.getString(1);
							String name = rs.getString(2);
							
							User user =
									new User(id, name);
							users.add(user);
						}
						
						return users;
					}
				}
		
				);			
		
		System.out.println(object); 
	} catch (Exception e) {
		e.printStackTrace();
	} finally{
		JDBCTools.releaseDB(null, null, conn);
	}
	
}	

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

1、测试 ResultSetHandler 的 BeanListHandler 实现类

/**
 * BeanListHandler: 把结果集转为一个 Bean 的 List. 该 Bean
 * 的类型在创建 BeanListHandler 对象时传入:
 * 		new BeanListHandler<>(User.class)
 */
@Test
public void testBeanListHandler(){
	String sql = "SELECT id, name FROM user";
	
	//1. 创建 QueryRunner 对象
	QueryRunner queryRunner = new QueryRunner();
	
	Connection conn = null;
	
	try {
		conn = JDBCTools.getConnection();
		
		Object object = queryRunner.query(conn, sql, 
				new BeanListHandler<>(User.class));
		
		System.out.println(object); 
	} catch (Exception e) {
		e.printStackTrace();
	} finally{
		JDBCTools.releaseDB(null, null, conn);
	}
}

2、测试 ResultSetHandler 的 MapHandler实现类

@Test
public void testMapHandler(){
	Connection connection = null;
	QueryRunner queryRunner = new QueryRunner();
	
	String sql = "SELECT id, name FROM user WHERE id = ?";
	
	try {
		connection = JDBCTools.getConnection();
		Map<String, Object> map = queryRunner.query(connection, 
				sql, new MapHandler(), 2);
		
		System.out.println(map); 
	} catch (Exception e) {
		e.printStackTrace();
	} finally{
		JDBCTools.releaseDB(null, null, connection);
	}
}

3、测试 ResultSetHandler 的 MapListHandler实现类

@Test
public void testMapListHandler(){
	Connection connection = null;
	QueryRunner queryRunner = new QueryRunner();
	
	String sql = "SELECT id, name FROM user";
	
	try {
		connection = JDBCTools.getConnection();
		List<Map<String, Object>> mapList = queryRunner.query(connection, 
				sql, new MapListHandler());
		
		System.out.println(mapList); 
	} catch (Exception e) {
		e.printStackTrace();
	} finally{
		JDBCTools.releaseDB(null, null, connection);
	}
}

/**
 * 1. ResultSetHandler 的作用: QueryRunner 的 query 方法的返回值最终取决于
 * query 方法的 ResultHandler 参数的 hanlde 方法的返回值.
 * 
 * 2. BeanListHandler: 把结果集转为一个 Bean 的 List, 并返回. Bean 的类型在
 * 创建 BeanListHanlder 对象时以 Class 对象的方式传入. 可以适应列的别名来映射 
 * JavaBean 的属性名: 
 * String sql = "SELECT id, name FROM user WHERE id = ?";
 * 
 * BeanListHandler(Class<T> type)
 * 
 * 3. BeanHandler: 把结果集转为一个 Bean, 并返回. Bean 的类型在创建 BeanHandler
 * 对象时以 Class 对象的方式传入
 * BeanHandler(Class<T> type) 
 * 
 * 4. MapHandler: 把结果集转为一个 Map 对象, 并返回. 若结果集中有多条记录, 仅返回
 * 第一条记录对应的 Map 对象. Map 的键: 列名(而非列的别名), 值: 列的值
 * 
 * 5. MapListHandler: 把结果集转为一个 Map 对象的集合, 并返回. 
 * Map 的键: 列名(而非列的别名), 值: 列的值
 * 
 * 6. ScalarHandler: 可以返回指定列的一个值或返回一个统计函数的值. 
 */
@Test
public void testScalarHandler(){
	Connection connection = null;
	QueryRunner queryRunner = new QueryRunner();
	
	String sql = "SELECT name FROM user WHERE id = ?";
	
	try {
		connection = JDBCTools.getConnection();
		Object count = queryRunner.query(connection, sql, 
				new ScalarHandler(), 2);
		
		System.out.println(count); 
	} catch (Exception e) {
		e.printStackTrace();
	} finally{
		JDBCTools.releaseDB(null, null, connection);
	}
}