简介

commons-dbutils Apache 组织提供的一个开源 JDBC工具类库,它是对JDBC的简单封装,学习成本极低,并且使用dbutils能极大简化jdbc编码的工作量,同时也不会影响程序的性能。因此dbutils成为很多不喜欢hibernate的公司的首选。

API介绍:

org.apache.commons.dbutils.QueryRunner --BDManager

org.apache.commons.dbutils.ResultSetHandler—处理结果集

工具类

org.apache.commons.dbutils.DbUtils、。

 

QueryRunner

该类简单化了SQL查询,它与ResultSetHandler组合在一起使用可以完成大部分的数据库操作,能够大大减少编码量。

QueryRunner类提供了两个构造方法:

默认的构造方法

需要一个 javax.sql.DataSource 来作参数的构造方法。

 

public Object query(Connection conn, String sql, Object[] params, ResultSetHandler rsh) throws SQLException:执行一个查询操作,在这个查询中,对象数组中的每个元素值被用来作为查询语句的置换参数。该方法会自行处理 PreparedStatement ResultSet 的创建和关闭。

public Object query(String sql, Object[] params, ResultSetHandler rsh) throws SQLException: 几乎与第一种方法一样;唯一的不同在于它不将数据库连接提供给方法,并且它是从提供给构造方法的数据源(DataSource) 或使用的setDataSource 方法中重新获得 Connection

public Object query(Connection conn, String sql, ResultSetHandler rsh) throws SQLException : 执行一个不需要置换参数的查询操作。

public int update(Connection conn, String sql, Object[] params) throws SQLException:用来执行一个更新(插入、更新或删除)操作。

public int update(Connection conn, String sql) throws SQLException:用来执行一个不需要置换参数的更新操作。

 

ResultSetHandler接口

该接口用于处理 java.sql.ResultSet,将数据按要求转换为另一种形式。

ResultSetHandler 接口提供了一个单独的方法:Object handle (java.sql.ResultSet .rs)

 

 

 

ArrayHandler:把结果集中的第一行数据转成对象数组。

@Test

public void testArrayHandler(){

QueryRunner runner = new QueryRunner(C3p0Demo1.getDataSource());

String sql = "select * from admin";

//Object param = {2};

try {

Object[] result = runner.query(sql,new ArrayHandler());

System.out.println(Arrays.asList(result));

} catch (SQLException e) {

// TODO Auto-generated catch block

e.printStackTrace();

}

}

 

 

ArrayListHandler:把结果集中的每一行数据都转成一个数组,再存放到List中。

@Test

public void testArrayListHandler(){

QueryRunner runner =new QueryRunner(C3p0Demo1.getDataSource());

String sql = "select * from admin";

try {

List<Object[]> list =runner.query(sql, new ArrayListHandler());

for(Object[] obj:list){

System.out.println(Arrays.asList(obj));

}

} catch (SQLException e) {

// TODO Auto-generated catch block

e.printStackTrace();

}

}

 

BeanHandler:将结果集中的第一行数据封装到一个对应的JavaBean实例中。

@Test

public void find(){

QueryRunner runner = new QueryRunner(C3p0Demo1.getDataSource());

String sql ="select id,name,password,sex,role from admin where id =? ";

try {

Users user = runner.query(sql, 5,new BeanHandler(Users.class));

System.out.println(user.getId()+"--"+user.getName()+"--"+user.getPassword());

} catch (SQLException e) {

// TODO Auto-generated catch block

e.printStackTrace();

}

}

BeanListHandler:将结果集中的每一行数据都封装到一个对应的JavaBean实例中,存放到List里。

@Test

public void findAll(){

QueryRunner runner = new QueryRunner(C3p0Demo1.getDataSource());

String sql ="select id,name,password,sex,role from admin";

try {

List<Users> list = runner.query(sql, new BeanListHandler(Users.class));

for(Users user:list){

System.out.println(user.getId()+"--"+user.getName()+"--"+user.getPassword()+"--"+user.getSex());

}

} catch (SQLException e) {

// TODO Auto-generated catch block

e.printStackTrace();

}

 

}

 

ColumnListHandler:将结果集中某一列的数据存放到List中。

@Test

public void testColumnListHandler(){

QueryRunner runner = new QueryRunner(C3p0Demo1.getDataSource());

String sql = "select * from admin";

try {

List list = runner.query(sql, new ColumnListHandler("name"));

System.out.println(list);

} catch (SQLException e) {

// TODO Auto-generated catch block

e.printStackTrace();

}

}

KeyedHandler(name):将结果集中的每一行数据都封装到一个Map里,再把这些map再存到一个map里,其key为指定的key

@Test

public void testKeyedHandler(){

QueryRunner runner = new QueryRunner(C3p0Demo1.getDataSource());

String sql = "select * from admin";

try {

Map<Object,Map<String,Object>> mp = runner.query(sql, new KeyedHandler("name"));

for(Map.Entry<Object, Map<String, Object>> mt:mp.entrySet()){//取得mapset集合

Map<String,Object> inner = mt.getValue();

for(Map.Entry<String, Object> entry:inner.entrySet()){

System.out.println(entry.getKey()+"----"+entry.getValue());

}

}

} catch (SQLException e) {

// TODO Auto-generated catch block

e.printStackTrace();

}

}

 

 

MapHandler:将结果集中的第一行数据封装到一个Map里,key是列名,value就是对应的值。

@Test

public void testMapHandler(){

QueryRunner runner = new QueryRunner(C3p0Demo1.getDataSource());

String sql ="select * from admin";

try {

Map map = runner.query(sql, new MapHandler());

System.out.println(map.entrySet());

} catch (SQLException e) {

// TODO Auto-generated catch block

e.printStackTrace();

}

}

 

MapListHandler:将结果集中的每一行数据都封装到一个Map里,然后再存放到List

@Test

public void testMapListHandler(){

QueryRunner runner = new QueryRunner(C3p0Demo1.getDataSource());

String sql ="select * from admin";

try {

List<Map<String, Object>> list = runner.query(sql, new MapListHandler());

for(Object entry:list){

System.out.println(entry);

}

} catch (SQLException e) {

// TODO Auto-generated catch block

e.printStackTrace();

}

}