一.Apache-DBUtils简介
commons-dbutils 是 Apache 组织提供的一个开源 JDBC工具类库,它是对JDBC的简单封装,学习成本极低, 并且使用dbutils能极大简化jdbc编码的工作量,同时也不会影响程序的性能。
- API介绍:
- org.apache.commons.dbutils.QueryRunner
- org.apache.commons.dbutils.ResultSetHandler
- 工具类:org.apache.commons.dbutils.DbUtilser
二.主要API的使用
2.1 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 SQLExceptio
- rollbackAndCloseQuietly(Connection)
- public static boolean loadDriver(java.lang.String driverClassName):这一方装载并注册JDBC驱动程 序,如果成功就返回true。使用该方法,你不需要捕捉这个异常ClassNotFoundException。
2.2 QueryRunner类
该类简单化了SQL查询,它与ResultSetHandler组合在一起使用可以完成大部分的数据库操作,能够大大减少 编码量。
- QueryRunner类的主要方法:
- 更新 public int update(Connection conn, String sql, Object... params) throws SQLException:用来执行 一个更新(插入、更新或删除)操作。 ......
- 插入 public T insert(Connection conn,String sql,ResultSetHandler 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 insertBatch(Connection conn,String sql,ResultSetHandler rsh,Object[][] params)throws SQLException:只支持INSERT语句 .....
- 查询 public Object query(Connection conn, String sql, ResultSetHandler rsh,Object... params) throws SQLException:执行一个查询操作,在这个查询中,对象数组中的每个元素值被用来作为查询语句 的置换参数。该方法会自行处理 PreparedStatement 和 ResultSet 的创建和关闭。
2.3 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:查询单个值对象
2.4 案例测试
- 使用QueryRunner 实现对表的增删改查
//使用QueryRunner 实现对表的增删改查
public class QueryRunnerTest {
/*
* commons-dbutils 是 Apache 组织提供的一个开源 JDBC工具类库,封装了针对于数据库的增删改查操作
*
*/
@Test
public void updateTest(){
Connection conn = null;
try {
conn = JDBCUtils.getConnection1();
QueryRunner runn = new QueryRunner();
String sql = "insert into customers(name,email,birth) value(?,?,?)";
runn.update(conn,sql,"赵四","zahosi@qq.com","2000-11-09");
} catch (Exception e) {
e.printStackTrace();
} finally {
JDBCUtils.closeConnection(conn,null);
}
}
//使用QueryRunner 实现select查询单条记录的操作
/*
* BeanHander:是ResultSetHandler接口的实现类,用于封装表中的一条记录。
*/
@Test
public void queryTest() throws Exception {
Connection conn =JDBCUtils.getConnection1();
QueryRunner runn = new QueryRunner();
String sql ="select id,name,email,birth from customers where id=?";
BeanHandler<Customer> bh = new BeanHandler<Customer>(Customer.class);
Customer customer = runn.query(conn, sql, bh, 19);
System.out.println(customer);
}
//使用QueryRunner 实现select查询多条记录的操作
/*
* BeanListHandler:是ResultSetHandler接口的实现类,用于封装表中的多条记录构成的集合。
*/
@Test
public void queryTest1() throws Exception {
Connection conn =JDBCUtils.getConnection1();
QueryRunner runn = new QueryRunner();
String sql ="select id,name,email,birth from customers where id<?";
BeanListHandler bh = new BeanListHandler<>(Customer.class);
List<Customer> list = (List<Customer>)runn.query(conn, sql, bh,18);
list.forEach(System.out::println);
}
/*
* MapListHander:是ResultSetHandler接口的实现类,对应表中的多条记录。
* 将字段及相应字段的值作为map中的key和value。将这些map添加到List中
*/
@Test
public void queryTest2() {
Connection conn =null;
try {
conn =JDBCUtils.getConnection1();
QueryRunner runn = new QueryRunner();
String sql ="select count(*) from customers";
ScalarHandler scalarHandler = new ScalarHandler();
Long query = (Long) runn.query(conn, sql, scalarHandler);
System.out.println(query);
} catch (Exception e) {
e.printStackTrace();
} finally {
JDBCUtils.closeConnection(conn,null);
}
}
/*
* MapHander:是ResultSetHandler接口的实现类,对应表中的一条记录。
* 将字段及相应字段的值作为map中的key和value
*/
@Test
public void testQuery3(){
Connection conn = null;
try {
QueryRunner runner = new QueryRunner();
conn = JDBCUtils.getConnection1();
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);
} catch (Exception e) {
e.printStackTrace();
} finally{
JDBCUtils.closeConnection(conn, null);
}
}
}