JDBC开源框架：DBUtils使用入门
在单元测试过程中，只涉及到数据库的直接操作来验证业务逻辑是否正确的情况，DBUtils非常适合使用。它结构简单，包小，友好处理掉那些jdbc异常，让你更专注于业务代码，而非底层的操作。官网对它的定义：Commons DbUtils库是一组小的类，旨在简化JDBC的工作。JDBC资源清理代码是普通的、容易出错的工作，因此这些类从您的代码中抽象出所有清理任务，从而使您真正想要做的事情是:查询和更新数据。
maven
<dependency>
<groupId>commons-dbutils</groupId>
<artifactId>commons-dbutils</artifactId>
<version>1.7</version>
</dependency>
此是一个非常简洁的工具包，核心二个部分：
1、*Runner 数据库连接操作类,比如增删改查
2、*Handler 结果返回转换类，默认提供常用的转换接口，如基本类型的转换DoubleColumnHandler、LongColumnHandler等。只实现ResultSetHandler接口就可以自定义转换器。
简单说下常用的API
QueryRunner ： 此类能够使SQL查询简单化，也支持批量增删改查功能。执行完成后，会自动关闭所有连接，因些不需要手动再次写finally close。
ResultSetHandler ： 只有一个简单的接口方法T handle(ResultSet rs)。能将数据转换成想要的任何形式，可以让应用更加简洁操作。默认提供了ArrayHandler, ArrayListHandler, BeanHandler, BeanListHandler, MapHandler, MapListHandler, and ScalarHandler等执行程序。
ColumnHandler ： 接口定义让行数据转换。时间类型只实现java.sql.Timestamp的TimestampColumnHandler，在实际项目中，LocalDateTime类型都必需要自定义。
接下来看下具体使用步骤
1、加载jdbc驱动类，获取数据库connection
2、实例化QueryRunner 获得实例化对象queryRunner
3、实现ResultSetHandler，自定义需要转换的数据形式
4、利用queryRunner执行相关DB操作。
例子暂未使用连接池。
public class Member {
private int id;
private String account;
}
public Connection getConn() {
Connection conn = null;
try {
Class.forName(driverName);
conn = DriverManager.getConnection(url, username, password);
} catch (Exception e) {
e.printStackTrace();
}
return conn;
}
一、执行增加insert语句有二种方式
1、用QueryRunner.insert()
@Test
public void insert_1() throws Exception {
QueryRunner runner = new QueryRunner();
String sql = "insert into member(account) value('sa')";
MapHandler rsh = new MapHandler();
Map<String, Object> map = runner.insert(getConn(), sql, rsh);
}
返回Map<String,Object> 是自增主键的值，格式：{"GENERATED_KEY":3}
2、用QueryRunner.update();
@Test
public void insert_2() throws Exception {
QueryRunner runner = new QueryRunner();
String sql = "insert into member(account) value('admin')";
int effect = runner.update(getConn(), sql);
}
返回影响的行数。
二、修改update、删除也是一种修改操作
@Test
public void update() throws SQLException {
QueryRunner runner = new QueryRunner();
String sql = "update member set account = ? where id = ?";
Object[] param = {"tom",3};
int effect = runner.update(getConn(), sql, param);
//返回影响的行数
}
@Test
public void delete() throws SQLException {
QueryRunner runner = new QueryRunner();
String sql = "delete from member where id = ?";
int effect = runner.update(getConn(), sql, 2);
//返回影响的行数
}
三、复杂的query，简单列举9种内置常见的handler
1、统计分组类。ScalarHandler 通常用于保存只有一行一列的结果集，例如分组函数
@Test
public void count() throws SQLException {
QueryRunner queryRunner = new QueryRunner();
String sql = "select count(*) cnt from member";
long count = (long) queryRunner.query(getConn(), sql, new ScalarHandler()); // 默认得到结果集的第1列
long cnt = (long) queryRunner.query(getConn(), sql, new ScalarHandler("cnt")); //使用定义的别名
}
2、KeyedHandler 将结果集每一行数据保存到一个Map。里面map，key为列名，value为值；外面的map,key为指定列名的值，value对应的那条数据,即里面map
@Test
public void keyedhandler() throws SQLException {
QueryRunner queryRunner = new QueryRunner();
String sql = "select * from member";
Map<Object, Map<String, Object>> map = (Map<Object, Map<String, Object>>) queryRunner.query(getConn(), sql, new KeyedHandler<Object>("id"));
System.out.println(JSON.toJSONString(map));
}
3、MapListHandler 将结果集每一行数据保存到map中，key列名 value该列的值 ---- 再将所有map对象保存到List集合中
@Test
public void mapListQuery() throws SQLException {
QueryRunner queryRunner = new QueryRunner();
String sql = "select * from member";
MapListHandler map = new MapListHandler();
List<Map<String, Object>> list = queryRunner.query(getConn(), sql, map);
}
4、 MapHander 将结果集第一行数据封装到Map集合中，key是列名，value为该列的值
@Test
public void mapQuery() throws SQLException {
QueryRunner queryRunner = new QueryRunner();
String sql = "select * from member";
MapHandler map = new MapHandler();
Map<String, Object> m = queryRunner.query(getConn(), sql, map);
}
5、 ColumnListHandler 获得结果集的某一列，将该列的所有值存入List<Object>中。可以传columnIndex和columnName二参数，默认取第一列的值
@Test
public void columnListQuery() throws SQLException {
QueryRunner queryRunner = new QueryRunner();
String sql = "select * from member";
ColumnListHandler<String> listHandler = new ColumnListHandler("id");
List<String> list = queryRunner.query(getConn(), sql, listHandler);
System.out.println(JSON.toJSONString(list));
}
6、BeanListHander 将结果集每一条数据，转为JavaBean对象，再保存到list集合中
@Test
public void beanListQuery() throws SQLException {
QueryRunner queryRunner = new QueryRunner();
String sql = "select * from member";
BeanListHandler<Member> listHandler = new BeanListHandler(Member.class);
List<Member> list = queryRunner.query(getConn(), sql, listHandler);
System.out.println(JSON.toJSONString(list));
}
7、 BeanHandler 将结果集第一行数据封装到JavaBean对象中，与MapHandler意思一样
@Test
public void beanQuery() throws SQLException {
QueryRunner queryRunner = new QueryRunner();
String sql = "select * from member";
BeanHandler<Member> listHandler = new BeanHandler(Member.class);
Member member = queryRunner.query(getConn(), sql, listHandler);
System.out.println(JSON.toJSONString(member));
}
8、 ArrayListHandler 将结果集每一行数据保存到List<Object[]>中
@Test
public void arrayListQuery() throws SQLException {
QueryRunner queryRunner = new QueryRunner();
String sql = "select * from member";
ArrayListHandler listHandler = new ArrayListHandler();
List<Object[]> list = queryRunner.query(getConn(), sql, listHandler);
System.out.println(JSON.toJSONString(list));
}
9、 ArrayHandler 将结果集第一行数据保存到Object[]中
@Test
public void arrayQuery() throws SQLException {
QueryRunner queryRunner = new QueryRunner();
String sql = "select * from member";
ArrayHandler listHandler = new ArrayHandler();
Object[] list = queryRunner.query(getConn(), sql, listHandler);
System.out.println(JSON.toJSONString(list));
}
