简介
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()){//取得map的set集合
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();
}
}