Apache-DBUtils实现CRUD

由 笔尖 发布

Apache-DB Utils简介


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

主要包括:

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

DbUtils

  • 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
  • public static void rollbackAndCloseQuietly(Connection)
  • public static boolean loadDriver(java.lang.String driverClassName):这一方装载并注册JDBC驱动程序,如果成功就返回true。使用该方法,你不需要捕捉这个异常ClassNotFoundException。

注意:close虽然只显式close了connection,但是内部同样close了Statement以及ResultSet。

QueryRunner

  • 简单化了CUD操作,例如增删改操作都通过update操作来实现:

public int update(Connection conn, String sql, Object... params) :用来执行一个更新(插入、更新或删除)操作。

  • 而查询操作R是通过query语句配合ResultSetHandler来完成:

public Object query(Connection conn, String sql, ResultSetHandler rsh,Object... params) :执行一个查询操作,在这个查询中,对象数组中的每个元素值被用来作为查询语句的置换参数。

// 测试添加
@Test
public void testInsert() throws Exception {
    QueryRunner runner = new QueryRunner();
    Connection conn = JDBCUtils.getConnection();
    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.getConnection();
    String sql = "delete from customers where id < ?";
    int count = runner.update(conn, sql,3);

    System.out.println("删除了" + count + "条记录");
    JDBCUtils.closeResource(conn, null);
}

ResultSetHandler及其实现类

ResultSetHandler接口要求子类实现的方法为:Object handle (java.sql.ResultSet),当query执行完查询操作以后,其返回的ResultSet就会被该接口的实现子类所处理,并返回相应对象(数组)

实现类大致如下:

  • 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:查询单个值对象
/*
 * 测试查询:查询一条记录
 * 使用ResultSetHandler的实现类:BeanHandler
 */
@Test
public void testQueryInstance() throws Exception{
    QueryRunner runner = new QueryRunner();
    Connection conn = JDBCUtils.getConnection();
    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);    
    JDBCUtils.closeResource(conn, null);
}


/*
 * 测试查询:查询多条记录构成的集合
 * 使用ResultSetHandler的实现类:BeanListHandler
 */
@Test
public void testQueryList() throws Exception{
    QueryRunner runner = new QueryRunner();
    Connection conn = JDBCUtils.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);
    JDBCUtils.closeResource(conn, null);
}


/*
 * 如何查询类似于最大的,最小的,平均的,总和等单个数据,
 * 使用ScalarHandler
 */
@Test
public void testQueryValue() throws Exception{
    QueryRunner runner = new QueryRunner();
    Connection conn = JDBCUtils.getConnection();
        
    //测试一:
//    String sql = "select count(*) from customers where id < ?";
//    ScalarHandler handler = new ScalarHandler();
//    long count = (long) runner.query(conn, sql, handler, 20);
//    System.out.println(count);
        
    //测试二:
    String sql = "select max(birth) from customers";
    ScalarHandler handler = new ScalarHandler();
    Date birth = (Date) runner.query(conn, sql, handler);
    System.out.println(birth);
        
    JDBCUtils.closeResource(conn, null);
}

总结

public void testUpdateWithTx() {
    Connection conn = null;
    conn.setAutoCommit(false);
    try {
        //1.获取连接的操作
        //① 手写的连接:JDBCUtils.getConnection();
        //② 使用数据库连接池:C3P0;DBCP;Druid
        
        //2.对数据表进行一系列CRUD操作
        //① 使用PreparedStatement实现通用的增删改、查询操作
        //② 使用dbutils提供的jar包中提供的QueryRunner类
        
        //提交数据
        conn.commit();
    } catch (Exception e) {
        e.printStackTrace();
        try {
            //回滚数据
            conn.rollback();
        } catch (SQLException e1) {
            e1.printStackTrace();
        }
    }finally{
        //3.关闭连接等操作
        //① JDBCUtils.closeResource();
        //② 使用dbutils提供的jar包中提供的DbUtils类提供了关闭的相关操作
    }
}

暂无评论

发表评论