JDBC：Apache-DBUtils实现增删改查操作

原创已于 2022-04-21 11:02:36 修改 · 194 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#mysql #数据库 #database

于 2022-03-27 15:26:52 首次发布

java 同时被 2 个专栏收录

130 篇文章

订阅专栏

jdbc

10 篇文章

订阅专栏

本文介绍了Apache DBUtils，一个简化JDBC操作的工具库。通过QueryRunner类和ResultSetHandler接口，它能够显著减少数据库操作的代码量，并提供资源管理工具DbUtils。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Apache-DBUtils简介

Apache-DBUtilsUtils下载

commons-dbutils 是 Apache 组织提供的一个开源 JDBC工具类库，它是对JDBC的简单封装，学习成本极低，并且使用dbutils能极大简化jdbc编码的工作量，同时也不会影响程序的性能。
API介绍：
- org.apache.commons.dbutils.QueryRunner
- org.apache.commons.dbutils.ResultSetHandler
- 工具类：org.apache.commons.dbutils.DbUtils
API包说明：

9.2 主要API的使用

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。

QueryRunner类

该类简单化了SQL查询，它与ResultSetHandler组合在一起使用可以完成大部分的数据库操作，能够大大减少编码量。
QueryRunner类提供了两个构造器：
- 默认的构造器
- 需要一个 javax.sql.DataSource 来作参数的构造器
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 的创建和关闭。
  - …
测试

//测试插入（增删改相似）
@Test
public void testInsert() throws Exception {
	QueryRunner runner = new QueryRunner();
	Connection conn = JDBCUtils.getConnection3();
	String sql = "insert into customers(name,email,birth)values(?,?,?)";
	int insertCount = runner.update(conn, sql, "王五", "wangwu@.com", "1997-09-21");
	System.out.println("添加了"+insertCount+"条记录");
	JDBCUtil.closeResource(conn,null);
}

// 测试删除
@Test
public void testDelete() throws Exception {
	QueryRunner runner = new QueryRunner();
	Connection conn = JDBCUtils.getConnection3();
	String sql = "delete from customers where id < ?";
	int count = runner.update(conn, sql,3);
	System.out.println("删除了" + count + "条记录");	
	JDBCUtils.closeResource(conn, null);
}

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

//测试查询
/*
	BeanHandler:是ResultedHandler接口的实现类，用于封装表中的一条记录。(不能返回多条记录)
*/
@Test
public void testQuery1() throws Exception {
	QueryRunner runner = new QueryRunner();
	Connection conn = JDBCUtils.getConnection3();
	String sql = "select id,name,email,birth from customers where id = ?";
	BeanHandler<Customers> handler = new BeanHandler<>(Customers.class);
	Customers customers = runner.query(conn, sql, handler, 12);
	System.out.println(customers);
	JDBCUtils.closeResource(conn,null);
    }

/*
    BeanListHandler是ResultedHandler接口的实现类，用于封装表中的多条记录构成的集合
*/
@Test
public void testQuery2() throws Exception {
	QueryRunner runner = new QueryRunner();
	Connection conn = JDBCUtils.getConnection3();
	String sql = "select id,name,email,birth from customers where id < ?";
	BeanListHandler<Customers> handler = new BeanListHandler<>(Customers.class);
	List<Customers> list = runner.query(conn, sql, handler, 12);
	list.forEach(System.out::println);
	JDBCUtils.closeResource(conn,null);
}

/*
    MapHandler:是ResultedHandler接口的实现类，对应表中的一条记录
    将字段及相应字段值作为map中的key和value
 */
@Test
public void testQuery3() throws Exception {
	QueryRunner runner = new QueryRunner();
	Connection conn = JDBCUtils.getConnection3();
	String sql = "select id,name,email,birth from customers where id = ?";
	MapHandler handler = new MapHandler();
	Map<String, Object> map = runner.query(conn, sql, handler, 12);
	System.out.println(map);//以键值对的方式实现
	JDBCUtils.closeResource(conn,null);
}

/*
	MapHandler:是ResultedHandler接口的实现类，对应表中的多条记录
	将字段及相应字段值作为map中的key和value，将这些map添加到list中
*/
@Test
public void testQuery4() throws Exception {
	QueryRunner runner = new QueryRunner();
	Connection conn = JDBCUtils.getConnection3();
	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, 12);
	list.forEach(System.out::println);
	JDBCUtils.closeResource(conn,null);
}

/*
	ScalarHandler：用于查询特殊值，如查询类似于最大的，最小的，平均的，总和，个数相关的数据，
*/
@Test
public void testQuery5() throws Exception {
	QueryRunner runner = new QueryRunner();
	Connection conn = JDBCUtils.getConnection3();
	String sql = "select count(*) from customers";
	ScalarHandler handler = new ScalarHandler();
	Long count = (Long) runner.query(conn, sql, handler);
	System.out.println("customers中有"+count+"条记录");
	JDBCUtils.closeResource(conn,null);
    }
@Test
public void testQuery6() throws Exception {
	QueryRunner runner = new QueryRunner();
	Connection conn = JDBCUtils.getConnection3();
	String sql = "select max(birth) from customers";
	ScalarHandler handler = new ScalarHandler();
	Date maxbirth = (Date) runner.query(conn, sql, handler);
	System.out.println(maxbirth);
	JDBCUtils.closeResource(conn,null);
}

//自定义ResultSetHandler的实现类完成查询操作
@Test
public void testQuery7() throws Exception {
	QueryRunner runner = new QueryRunner();
	Connection conn = JDBCUtils.getConnection3();
	String sql = "select id,name,email,birth from customers where id = ?";
	ResultSetHandler<Customers> handler = new ResultSetHandler<Customers>() {//创建ResultSetHandler的匿名实现类
		@Override
		public Customers handle(ResultSet rs) throws SQLException {//与query的放回置相同
			if(rs.next()){
				int id = rs.getInt("id");
				String name = rs.getString("name");
				String email = rs.getString("email");
				Date birth = rs.getDate("birth");
				Customers customers = new Customers(id, name, email, birth);
				return customers;
			}
			return null;
		}
	};
	Customers customer = runner.query(conn, sql, handler, 12);
	System.out.println(customer);
	JDBCUtils.closeResource(conn,null);
}

DBUtils工具类

资源的关闭也可以使用DBUtils的工具类来实现

public static void closeResource1(Connection conn, Statement ps, ResultSet rs){
	try {
		DbUtils.close(conn);
	} catch (SQLException throwables) {
		throwables.printStackTrace();
	}
	try {
		DbUtils.close(ps);
	} catch (SQLException throwables) {
		throwables.printStackTrace();
	}
	try {
		DbUtils.close(rs);
	} catch (SQLException throwables) {
		throwables.printStackTrace();
	}
}

public static void closeResource1(Connection conn, Statement ps, ResultSet rs){
	DbUtils.closeQuietly(conn);
	DbUtils.closeQuietly(ps);
	DbUtils.closeQuietly(rs);
}