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
3ff7
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);
}
}