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());
}
}
}

}