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