1. 简介
commons-dbutils 是 Apache 组织提供的一个开源 JDBC工具类库,它是对JDBC的简单封装,学习成本极低,并且使用dbutils能极大简化jdbc编码的工作量,同时也不会影响程序的性能。因此dbutils成为很多
不喜欢hibernate的公司的首选。
commons-dbutilsAPI介绍:
-
- org.apache.commons.dbutils.QueryRunner
- org.apache.commons.dbutils.ResultSetHandler
工具类
-
- org.apache.commons.dbutils.DbUtils
2. QuerryRunner类
① 构造方法
1. 默认构造方法
2. javax.sql.DataSource 来作参数的构造方法
QueryRunner runner = new QueryRunner(DataSource) 最常用!
② 主要方法
1. public Object query(Connection conn, String sql, Object[] params, ResultSetHandler rsh) throws SQLException
执行一个查询操作,对象数组中的每个元素值被用来作为查询语句的置换参数。该方法会自行处理 PreparedStatement 和 ResultSet 的创建和关闭
2. public Object query(String sql, Object[] params, ResultSetHandler rsh) throws SQLException
几乎与第一种方法一样;唯一的不同在于它不将数据库连接提供给方法,并且它是从提供给构造方法的数据源(DataSource) 或使用的setDataSource 方法中重新获得 Connection
3. public Object query(Connection conn, String sql, ResultSetHandler rsh) throws SQLException
执行一个不需要置换参数的查询操作。
4. public int update(Connection conn, String sql, Object[] params) throws SQLException
用来执行一个更新(插入、更新或删除)操作。
5. public int update(Connection conn, String sql) throws SQLException
用来执行一个不需要置换参数的更新操作
③ 使用QueryRunner实现CRUD
import java.sql.SQLException;
import org.apache.commons.dbutils.QueryRunner;
import org.junit.Test;public class QueryRunnerTest {
/*
* 测试表 create Table users{ id int primary key auto_increment userName
* varchar(10), passWord varchar(20) }
*/
private QueryRunner runner = new QueryRunner(
DataSourceManager.getDataSource());@Test
public void add() throws SQLException {
String sql = "insert into users(userName,passWord) values(?,?)";
Object params[] = { "岁月斑驳1", "123" };
runner.update(sql, params);
}@Test
public void delete() throws SQLException {
String sql = "delete from users where id=?";
runner.update(sql, 2);
}@Test
public void update() throws SQLException {
String sql = "update users set userName=? where id=?";
Object params[] = { "岁月斑驳9", 3 };
runner.update(sql, params);
}}
DataSourceManager.java
import java.io.InputStream;
import java.util.Properties;
import javax.sql.DataSource;
import org.apache.commons.dbcp.BasicDataSourceFactory;public class DataSourceManager {
private static DataSource ds;
static {
try {
InputStream in = DataSourceManager.class.getClassLoader()
.getResourceAsStream("config.properties");
Properties pro = new Properties();
pro.load(in);
ds = BasicDataSourceFactory.createDataSource(pro);
} catch (Exception ex) {
throw new ExceptionInInitializerError();
}
}public static DataSource getDataSource() {
return ds;
}}
说明: 需要导入必要的包, 数据库的配置信息在config.properties指明
一般增删改不需要用到结果集处理工具,但是如果是查询的话就需要用到resulrSetHandler
3. 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
import java.sql.SQLException;
import java.util.Arrays;
import java.util.List;
import java.util.Map;import org.apache.commons.dbutils.QueryRunner;
import org.apache.commons.dbutils.handlers.ArrayHandler;
import org.apache.commons.dbutils.handlers.ArrayListHandler;
import org.apache.commons.dbutils.handlers.MapHandler;
import org.apache.commons.dbutils.handlers.MapListHandler;
import org.junit.Test;public class QueryRunnerTest {
/*
* 测试表 create Table users{ id int primary key auto_increment userName
* varchar(10), passWord varchar(20) }
*/
private QueryRunner runner = new QueryRunner(
DataSourceManager.getDataSource());/**
* 测试ArrayHandler()接口,把结果集中的第一行数据转成对象数组。
*
* @throws SQLException
*/
@Test
public void testArrayHandler() throws SQLException {
String sql = "select * from users";
Object result[] = (Object[]) runner.query(sql, new ArrayHandler());
System.out.println(Arrays.asList(result)); // list toString()
}/**
* 测试ArrayListHandler()接口,把结果集中的每一行数据转成对象数组,再存放到List中
*
* @throws SQLException
*/
@Test
public void TestArrayListHandler() throws SQLException {
String sql = "select * from users";
List<Object[]> list = (List<Object[]>) runner.query(sql,
new ArrayListHandler());
for (Object[] o : list) {
System.out.println(Arrays.asList(o));
}
}/**
* 测试MapHandler()接口,将结果集中的第一行数据封装到一个Map里,key是列名,value就是对应的值
*
* @throws SQLException
*/
@Test
public void TestMapHandler() throws SQLException {
String sql = "select * from users";
Map<String, Object> map = (Map<String, Object>) runner.query(sql,
new MapHandler());
for (Map.Entry<String, Object> me : map.entrySet()) {
System.out.println(me.getKey() + "=" + me.getValue());
}
}
/*
* 结果: id=3 userName=岁月斑驳9 passWord=123
*/@Test
public void TestMapListHandler() throws SQLException {
String sql = "select * from users";
List<Map<String, Object>> list = (List<Map<String, Object>>) runner
.query(sql, new MapListHandler());
for (Map<String, Object> map : list) {
for (Map.Entry<String, Object> me : map.entrySet()) {
System.out.println(me.getKey() + "=" + me.getValue());
}
}
}}