一.DBUtils的三个核心对象
QueryRunner类
ResultSetHandler接口
DbUtils类
DBUtils简介
Commons DbUtils是Apache组织提供的一个对JDBC进行简单封装的开源工具类库,使用它能够简化JDBC应用程序的开发,同时也不会影响程序的性能。传统操作数据库的类指的是JDBC(java database connectivity:java数据库连接,java的数据库操作的基础API)。
DBUtils包括3个包:
org.apache.commons.dbutils
org.apache.commons.dbutils.handlers
org.apache.commons.dbutils.wrappers
DBUtils封装了对JDBC的操作,简化了JDBC操作,可以少写代码(偷着乐吧!!)。
二.QueryRunner类
QueryRunner中提供对SQL语句操作的API.
1.new QueryRunner();
它的事务可以手动控制。
也就是说此对象调用的方法(如:query、update、batrch)参数中要有Connection对象。
2.new QueryRunner(DataSource ds);
它的事务是自动控制的。
需要一个javax.sql.DataSource(数据源)来作参数的构造方法。
一个SQL语句一个事务。此对象调用的方法(如:query、update、batrch)参数中无需Connection对象。
3.它主要有三个方法
(1).Select 语句
不需Connection对象: public Object query(String sql, Object[] params, ResultSetHandler rsh)
需要Connection对象:public Object query(Connection conn, String sql, Object[] params, ResultSetHandler rsh)
(2).public int update()
//用于执行insert update delete, 执行增改删的SQL命令。
(3).public int[] batch(Connection conn, String sql, Object[ ][ ] params)
//批处理语句
该方法为何会接收二维数组Object[ ][ ] params呢?
答:该方法接收二维数组Object[][] params,那么调用其的时候就要传递一个诸如这样的实参[[1,aa],[2,bb],[3,cc]]
即[[执行次数,SQL语句],[执行次数,SQL语句],[执行次数,SQL语句]]
那为何又会返回int[]呢?
答:该方法的返回值是int[],所以会返回诸如这样的结果:[1,1,1],意思是生成对应的sql语句影响数据库几行
三.ResultSetHandler接口:用于定义select操作后,怎样封装结果集.
1.handle方法(方法未实现,我们可以自己写转换代码)
该接口用于处理java.sql.ResultSet,将数据按要求转换为另一种形式。
ResultSetHandler接口提供了一个单独的方法:Object handle (java.sql.ResultSet .rs)
2.ResultSetHandler接口的实现类(方法已实现,DBUtils提供的转换方式,非常好用)
ArrayHandler:把结果集中的第一行数据转成对象数组。
ArrayListHandler:把结果集中的每一行数据都转成一个数组,再存放到List中。
BeanHandler:将结果集中的第一行数据封装到一个对应的JavaBean实例中。
BeanListHandler:将结果集中的每一行数据都封装到一个对应的JavaBean实例中,存放到List里。
ColumnListHandler:将结果集中某一列的数据存放到List中。
KeyedHandler(name):将结果集中的每一行数据都封装到一个Map里,再把这些map再存到一个map里,其key为指定的key。
MapHandler:将结果集中的第一行数据封装到一个Map里,key是列名,value就是对应的值。
MapListHandler:将结果集中的每一行数据都封装到一个Map里,然后再存放到List。
四.DbUtils类:它就是一个工具类,定义了关闭资源与事务处理的方法
DbUtils是一个为做一些诸如关闭连接、装载JDBC驱动程序之类的常规工作提供有用方法的类,它里面所有的方法都是静态的。
这个类里的重要方法有:
1.close()
DbUtils类提供了三个重载的关闭方法。这些方法检查所提供的参数是不是NULL,如果不是的话,它们就关闭连接、声明和结果集(ResultSet)。
2.CloseQuietly()
CloseQuietly这一方法不仅能在连接、声明或者结果集(ResultSet)为NULL情况下避免关闭,防止抛出空指针异常,还能隐藏一些在程序中抛出的SQLEeception。如果你不想捕捉这些异常的话,这对你是非常有用的。
在重载CloseQuietly方法时,特别有用的一个方法是closeQuietly(Connection conn,Statement stmt,ResultSet rs),这是因为在大多数情况下,连接、声明和结果集(ResultSet)是你要用的三样东西,而且在最后你必须关闭它们,使用这一方法,你最后就可以只需要调用这一方法即可。
3.CommitAndCloseQuietly(Connection conn)
这一方法用来提交连接,然后关闭连接,并且在关闭连接时不向上抛出在关闭时发生的一些SQL异常。
4.LoadDriver(String driveClassName)
:这一方法装载并注册JDBC驱动程序,如果成功就返回TRUE。
使用这种方法,你不需要去捕捉这个异常ClassNotFoundException。使用loadDrive方法,编码就变得更容易理解,你也就得到了一个很好的Boolean返回值,这个返回值会告诉你驱动类是不是已经加载成功了。
五.实例
//handle方法自定义结果集处理,我们只需要实现handle方法即可
//使用类处理的方式
class ColumnListHandler implements ResultSetHandler {
private String columnName;
public ColumnListHandler(String columnName) {
this.columnName = columnName;
}
public Object handle(ResultSet rs) throws SQLException {
List list = new ArrayList();
while (rs.next()) {
list.add(rs.getObject(columnName));
}
return list;
}
}
class Demo {
@Test
public void test() throws SQLException {
QueryRunner runner = new QueryRunner(JdbcUtils.getDataSource());
String sql = "select * from users";
List list = (List) runner.query(sql, new ColumnListHandler("name"));//此处也可使用匿名内部类
System.out.println(list);
}
}
//handle方法自定义结果集处理
//使用匿名内部类处理的方式
public void testSelect() throws SQLException{
//创建一个QueryRunner对象
QueryRunner qr = new QueryRunner(C3P0Util.getDataSource());
List<User> list = qr.query("select * from users", new ResultSetHandler<List<User>>(){
//当query方法执行select语句后,将结果集以参数的形式传递过来
public List<User> handle(ResultSet rs) throws SQLException {
List<User> list = new ArrayList<User>();
while(rs.next()){
User u = new User();
u.setId(rs.getInt(1));
u.setName(rs.getString(2));
u.setPassword(rs.getString(3));
u.setEmail(rs.getString(4));
u.setBirthday(rs.getDate(5));
list.add(u);
}
return list;
}
});
for (User user : list) {
System.out.println(user);
}
}
// 使用dbutils完成数据库的CRUD
public class Demo {
@Test
public void insert() throws SQLException {
QueryRunner runner = new QueryRunner(JdbcUtils.getDataSource());
String sql = "insert into users(id,name,password,email,birthday) values(?,?,?,?,?)";
Object[] params = {2, "bbb", "123", "bbb@163.com", new Date()};
runner.update(sql, params);
}
@Test
public void update() throws SQLException {
QueryRunner runner = new QueryRunner(JdbcUtils.getDataSource());
String sql = "update users set email=? where id=?";
Object[] params = {"yeyiyi@126.com", 1};
runner.update(sql, params);
}
@Test
public void delete() throws SQLException {
QueryRunner runner = new QueryRunner(JdbcUtils.getDataSource());
String sql = "delete from users where id=?";
runner.update(sql, 2);
}
@Test
public void find() throws SQLException {
QueryRunner runner = new QueryRunner(JdbcUtils.getDataSource());
String sql = "select * from users where id=?";
User user = (User) runner.query(sql, 1, new BeanHandler(User.class));
System.out.println(user.getEmail());
}
@Test
public void getAll() throws SQLException {
QueryRunner runner = new QueryRunner(JdbcUtils.getDataSource());
String sql = "select * from users";
List list = (List) runner.query(sql, new BeanListHandler(User.class));
System.out.println(list);
}
@Test
public void batch() throws SQLException {
QueryRunner runner = new QueryRunner(JdbcUtils.getDataSource());
String sql = "insert into users(id,name,password,email,birthday) values(?,?,?,?,?)";
Object[][] params = new Object[3][5];
for (int i = 0; i < params.length; i++) {
params[i] = new Object[]{i+1, "aa"+i, "123", i+"@sian.com", new Date()};
}
runner.batch(sql, params);
}
}
//使用ResultSetHandler接口的实现类完成查询,并封装结果集
@Test//ArrayHandler:适合取1条记录。把该条记录的每列值封装到一个数组中Object[]
public void tese1() throws SQLException{
QueryRunner qr = new QueryRunner(C3P0Util.getDataSource());
Object[] arr = qr.query("select * from users", new ArrayHandler());
for (Object o : arr) {
System.out.println(o);
}
}
@Test//ArrayListHandler:适合取多条记录。把每条记录的每列值封装到一个数组中Object[],把数组封装到一个List中
public void tese2() throws SQLException{
QueryRunner qr = new QueryRunner(C3P0Util.getDataSource());
List<Object[]> query = qr.query("select * from users", new ArrayListHandler());
for (Object[] os : query) {
for (Object o : os) {
System.out.println(o);
}
System.out.println("--------------");
}
}
@Test //ColumnListHandler:取某一列的数据。封装到List中。
public void tese3() throws SQLException{
QueryRunner qr = new QueryRunner(C3P0Util.getDataSource());
List<Object> list = qr.query("select username,password from users", new ColumnListHandler(1));
for (Object o : list) {
System.out.println(o);
}
}
@Test //KeyedHandler:取多条记录,每一条记录封装到一个Map中,再把这个Map封装到另外一个Map中,key为指定的字段值。
public void tese4() throws SQLException{
QueryRunner qr = new QueryRunner(C3P0Util.getDataSource());
//大Map的key是表中的某列数据,小Map中的key是表的列名,所以大Map的key是Object类型,小Map的key是String类型
Map<Object,Map<String,Object>> map = qr.query("select * from users", new KeyedHandler(1));
for (Map.Entry<Object, Map<String,Object>> m : map.entrySet()) {
System.out.println(m.getKey());//大Map中key值就是id列的值
for (Map.Entry<String, Object> mm : m.getValue().entrySet()) {
System.out.println(mm.getKey()+"\t"+mm.getValue());//取出小Map中的列名和列值
}
System.out.println("---------------------");
}
}
@Test//MapHandler:适合取1条记录。把当前记录的列名和列值放到一个Map中
public void tese5() throws SQLException{
QueryRunner qr = new QueryRunner(C3P0Util.getDataSource());
Map<String,Object> map = qr.query("select * from users where id=?", new MapHandler(),20);
for (Map.Entry<String, Object> m : map.entrySet()) {
System.out.println(m.getKey()+"\t"+m.getValue());
}
}
@Test//MapListHandler:适合取多条记录。把每条记录封装到一个Map中,再把Map封装到List中
public void tese6() throws SQLException{
QueryRunner qr = new QueryRunner(C3P0Util.getDataSource());
List<Map<String,Object>> list = qr.query("select * from users", new MapListHandler());
for (Map<String, Object> map : list) {
for (Map.Entry<String, Object> m : map.entrySet()) {
System.out.println(m.getKey()+"\t"+m.getValue());
}
System.out.println("---------------");
}
}
@Test //ScalarHandler:适合取单行单列数据
public void tese7() throws SQLException{
QueryRunner qr = new QueryRunner(C3P0Util.getDataSource());
Object o = qr.query("select count(*) from users", new ScalarHandler(1));
System.out.println(o.getClass().getName());
}
@Test //BeanHandler:适合取单行单列数据
public void tese8() throws SQLException{
QueryRunner qr = new QueryRunner(C3P0Util.getDataSource());
User user = qr.query("select * from users where id=?", new BeanHandler<User>(User.class),1);
System.out.println(user);
}
@Test //BeanListHandler
public void tese9() throws SQLException{
QueryRunner qr = new QueryRunner(C3P0Util.getDataSource());
List<User> list = qr.query("select * from users where id=?", new BeanListHandler<User>(User.class),1);
System.out.println(list.size());
}