JDBC——Apache-DBUtils实现CRUD操作

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

主要API的使用

org.apache.commons.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 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。

org.apache.commons.dbutils.QueryRunner;

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

QueryRunner类提供了两个构造器：
1、默认的构造器
2、需要一个 javax.sql.DataSource 来作参数的构造器

QueryRunner类的主要方法：
更新
public int update(Connection conn, String sql, Object… params) throws SQLException:用来执行一个更新（插入、更新或删除）操作。

插入
public < T > T insert(Connection conn,String sql,ResultSetHandler< T > 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 > T insertBatch(Connection conn,String sql,ResultSetHandler< T > 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()  {
        QueryRunner runner = new QueryRunner();
        Connection conn=null;
        try {
            Properties pros = new Properties();

            //连接数据库
            InputStream is = ClassLoader.getSystemClassLoader().getResourceAsStream("druid.properties");
            pros.load(is);
            DataSource source = DruidDataSourceFactory.createDataSource(pros);
            conn = source.getConnection();
            System.out.println(conn);

            //执行sql
            String sql = "insert into customers(name,email,birth)values(?,?,?)";
            int insertCount = runner.update(conn, sql, "蔡徐坤","caixukun@126.com","1997-09-08");
            System.out.println("添加了" + insertCount + "条记录");
        } catch (Exception e) {
            e.printStackTrace();
        }finally {
            try {
                conn.close();
            } catch (SQLException e) {
                e.printStackTrace();
            }
        }
    }

org.apache.commons.dbutils.ResultSetHandler;

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： 查询单个值对象

 @Test//测试查询
    public void testQuery1(){
        QueryRunner runner = new QueryRunner();
        Connection conn = null;
        try {
            Properties pros = new Properties();

            //连接数据库
            InputStream is = ClassLoader.getSystemClassLoader().getResourceAsStream("druid.properties");
            pros.load(is);
            DataSource source = DruidDataSourceFactory.createDataSource(pros);
            conn = source.getConnection();
            System.out.println(conn);

            //执行sql
            /*
             * BeanListHandler:是ResultSetHandler接口的实现类，用于封装表中的多条记录构成的集合。
             */
//            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);


            /*
             * BeanListHandler:是ResultSetHandler接口的实现类，用于封装表中的多条记录构成的集合。
             */
//            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);


            /*
             * MapHander:是ResultSetHandler接口的实现类，对应表中的一条记录。
             * 将字段及相应字段的值作为map中的key和value
             */
//            String sql = "select id,name,email,birth from customers where id = ?";
//            MapHandler handler = new MapHandler();
//            Map<String, Object> map = runner.query(conn, sql, handler, 23);
//            System.out.println(map);

            /*
             * MapListHander:是ResultSetHandler接口的实现类，对应表中的多条记录。
             * 将字段及相应字段的值作为map中的key和value。将这些map添加到List中
             */
//            String sql = "select id,name,email,birth from customers where id < ?";
//            MapListHandler handler = new MapListHandler();
//            List<Map<String, Object>> list = runner.query(conn, sql, handler, 23);
//            list.forEach(System.out::println);

            /*
             * ScalarHandler:用于查询特殊值
             */
//            String sql = "select count(*) from customers";
//            ScalarHandler handler = new ScalarHandler();
//            Long count = (Long) runner.query(conn, sql, handler);
//            System.out.println(count);

        } catch (Exception e) {
            e.printStackTrace();
        }finally {
            try {
                DbUtils.close(conn);
            } catch (SQLException e) {
                e.printStackTrace();
            }
        }
        }
    }