JDBC: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。 

DbUtils

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

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

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

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

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

QueryRunner

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

•QueryRunner类提供了两个构造方法：

–默认的构造方法

–需要一个 javax.sql.DataSource来作参数的构造方法。

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

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

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

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

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

ResultSetHandler
•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

一些例子
/**
     * 测试 QueryRunner 类的 update 方法
     * 该方法可用于 INSERT, UPDATE 和 DELETE
     */
    @Test
    public void testQueryRunnerUpdate() {
        //1. 创建 QueryRunner 的实现类
        QueryRunner queryRunner = new QueryRunner();
        
        String sql = "DELETE FROM customers " +
                "WHERE id IN (?,?)";
        
        Connection connection = null;
        
        try {
            connection = JDBCTools.getConnection();
            //2. 使用其 update 方法
            queryRunner.update(connection,
                    sql, 12, 13);
        } catch (Exception e) {
            e.printStackTrace();
        } finally{
            JDBCTools.releaseDB(null, null, connection);
        }
        
    }

/**
     * 测试 QueryRunner 的 query 方法
     */
    @SuppressWarnings({ "unchecked", "rawtypes" })
    @Test
    public void testResultSetHandler(){
        String sql = "SELECT id, name, email, birth " +
                "FROM customers";
        
        //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<Customer> customers = new ArrayList<>();
                            
                            while(rs.next()){
                                int id = rs.getInt(1);
                                String name = rs.getString(2);
                                String email = rs.getString(3);
                                Date birth = rs.getDate(4);
                                
                                Customer customer =
                                        new Customer(id, name, email, birth);
                                customers.add(customer);
                            }
                            
                            return customers;
                        }
                    }
            
                    );            
            
            System.out.println(object);
        } catch (Exception e) {
            e.printStackTrace();
        } finally{
            JDBCTools.releaseDB(null, null, conn);
        }
        
    }

    /**
     * 1. ResultSetHandler 的作用: QueryRunner 的 query 方法的返回值最终取决于
     * query 方法的 ResultHandler 参数的 hanlde 方法的返回值.
     *
     * 2. BeanListHandler: 把结果集转为一个 Bean 的 List, 并返回. Bean 的类型在
     * 创建 BeanListHanlder 对象时以 Class 对象的方式传入. 可以适应列的别名来映射
     * JavaBean 的属性名:
     * String sql = "SELECT id, name customerName, email, birth " +
     *            "FROM customers 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: 可以返回指定列的一个值或返回一个统计函数的值.
     */

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

    @Test
    public void testScalarHandler(){//始终是第一个记录的第一个值
        Connection connection = null;
        QueryRunner queryRunner = new QueryRunner();
        
        String sql = "SELECT name FROM customers " +
                "WHERE id = ?";
        
        try {
            connection = JDBCTools.getConnection();
            Object count = queryRunner.query(connection, sql,
                    new ScalarHandler(), 6);
            
            System.out.println(count);
        } catch (Exception e) {
            e.printStackTrace();
        } finally{
            JDBCTools.releaseDB(null, null, connection);
        }
    }
    
    @Test
    public void testMapListHandler(){
        Connection connection = null;
        QueryRunner queryRunner = new QueryRunner();
        
        String sql = "SELECT id, name, email, birth " +
                "FROM customers";
        
        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);
        }
    }
    
    @Test
    public void testMapHandler(){
        Connection connection = null;
        QueryRunner queryRunner = new QueryRunner();
        
        String sql = "SELECT id, name customerName, email, birth " +
                "FROM customers WHERE id = ?";
        
        try {
            connection = JDBCTools.getConnection();
            Map<String, Object> map = queryRunner.query(connection,
                    sql, new MapHandler(), 4);
            
            System.out.println(map);
        } catch (Exception e) {
            e.printStackTrace();
        } finally{
            JDBCTools.releaseDB(null, null, connection);
        }
    }


/**
     * QueryLoader: 可以用来加载存放着 SQL 语句的资源文件.
     * 使用该类可以把 SQL 语句外置化到一个资源文件中. 以提供更好的解耦
     * @throws IOException
     */
    @Test
    public void testQueryLoader() throws IOException{
        // / 代表类路径的根目录.
        Map<String, String> sqls =
                QueryLoader.instance().load("/sql.properties");
        
        String updateSql = sqls.get("UPDATE_CUSTOMER");
        System.out.println(updateSql);
    }

sql.properties
UPDATE_CUSTOMER=UPDATE customers SET name = ? WHERE id = ?