apache commons DbUtils使用说明

关键字: apache commons-dbutils
一、关于DbUtils
    commons-dbutils 是 Apache 组织提供的一个开源 JDBC 工具类库，对传统操作数据库的类进行二次封装，可以把结果集转化成List。
项目主页： http://commons.apache.org/dbutils/
文档地址： http://commons.apache.org/dbutils/examples.html
下载地址：http://commons.apache.org/downloads/download_dbutils.cgi

(1)org.apache.commons.dbutils
DbUtils  : 提供如关闭连接、装载 JDBC 驱动程序等常规工作的工具类
QueryRunner : 该类简单化了 SQL 查询，它与 ResultSetHandler 组合在一起使用可以完成大部分的数据库操作，能够大大减少编码量。
QueryLoader : 属性文件加载器，主要用于加载属性文件中的 SQL 到内存中。

(2)org.apache.commons.dbutils.handlers
ArrayHandler ：将ResultSet中第一行的数据转化成对象数组
ArrayListHandler将ResultSet中所有的数据转化成List，List中存放的是Object[]
BeanHandler ：将ResultSet中第一行的数据转化成类对象
BeanListHandler ：将ResultSet中所有的数据转化成List，List中存放的是类对象
ColumnListHandler ：将ResultSet中某一列的数据存成List，List中存放的是Object对象
KeyedHandler ：将ResultSet中存成映射，key为某一列对应为Map。Map中存放的是数据
MapHandler ：将ResultSet中第一行的数据存成Map映射
MapListHandler ：将ResultSet中所有的数据存成List。List中存放的是Map
ScalarHandler ：将ResultSet中一条记录的其中某一列的数据存成Object

(3)org.apache.commons.dbutils.wrappers
SqlNullCheckedResultSet ：该类是用来对sql语句执行完成之后的的数值进行null的替换。
StringTrimmedResultSet ：去除ResultSet中中字段的左右空格。Trim()

二、例子
Java代码
public class TestDbUtils {  
 
    /** 
     * BeanListHandler ：将ResultSet中所有的数据转化成List，List中存放的是类对象 
     */ 
    public static void getBeanListData() {  
        Connection conn = getConnection();  
        QueryRunner qr = new QueryRunner();  
        try {  
            ResultSetHandler rsh = new BeanHandler(TUser.class);  
            TUser usr = (TUser) qr.query(conn,"SELECT id,username,gender FROM t_user WHERE id=10000",rsh);  
            System.out.println(StringUtils.center("findById", 50, '*'));  
            System.out.println("id=" + usr.getId() + " name=" + usr.getUsername() + " gender=" + usr.getGender());  
              
            List results = (List) qr.query(conn,"SELECT id,username,gender FROM t_user",  
                    new BeanListHandler(TUser.class));  
            System.out.println(StringUtils.center("findAll", 50, '*'));  
            for (int i = 0; i < results.size(); i++) {  
                TUser user = (TUser) results.get(i);  
                System.out.println("id=" + user.getId() + "  name=" + user.getUsername() + "  gender=" + user.getGender());  
            }  
        } catch (SQLException e) {  
            e.printStackTrace();  
        } finally {  
            DbUtils.closeQuietly(conn);  
        }  
    }  
 
    /** 
     * MapListHandler ：将ResultSet中所有的数据存成List。List中存放的是Map 
     */ 
    public static void getMapListData() {  
        Connection conn = getConnection();  
        QueryRunner qr = new QueryRunner();  
        try {  
            List results = (List) qr.query(conn,"SELECT id,username,gender FROM t_user",  
                    new MapListHandler());  
            for (int i = 0; i < results.size(); i++) {  
                Map map = (Map) results.get(i);  
                System.out.println("id=" + map.get("id") + " name=" + map.get("username") + " gender=" + map.get("gender"));  
            }  
        } catch (SQLException e) {  
            e.printStackTrace();  
        } finally {  
            DbUtils.closeQuietly(conn);  
        }  
    }  
 
    /** 
     *新增和更新例子 
     */ 
    public static void insertAndUpdateData(){  
        Connection conn = getConnection();  
        QueryRunner qr = new QueryRunner();  
        try{  
            //创建一个数组来存要insert的数据  
            Object[] insertParams = {"John Doe", "000000","男"};  
            int inserts = qr.update(conn, "INSERT INTO t_user(username,password,gender) VALUES (?,?,?)",  
                    insertParams );  
            System.out.println("inserted " + inserts + " data");  
              
            Object[] updateParams = {"111111", "John Doe"};  
            int updates = qr.update(conn, "UPDATE t_user SET password=? WHERE username=?",  
                                      updateParams );  
            System.out.println("updated "+ updates + " data");  
        }catch (SQLException e) {  
            e.printStackTrace();  
        } finally {  
            DbUtils.closeQuietly(conn);  
        }  
    }  
 
    /** 
     * Unlike some other classes in DbUtils, this class(SqlNullCheckedResultSet) is NOT thread-safe. 
     */ 
    public static void findUseSqlNullCheckedResultSet(){  
        Connection conn = getConnection();  
        try{  
            Statement stmt = conn.createStatement();  
            ResultSet rs = stmt.executeQuery("SELECT id, username, gender FROM t_user");  
            SqlNullCheckedResultSet wrapper = new SqlNullCheckedResultSet(rs);  
            wrapper.setNullString("N/A"); // Set null string  
            rs = ProxyFactory.instance().createResultSet(wrapper);  
              
            while(rs.next()){  
                System.out.println("id="+rs.getInt("id") + " username=" + rs.getString("username")  
                        + " gender="+rs.getString("gender"));  
            }  
              
            rs.close();  
        }catch(Exception e){  
            e.printStackTrace();  
        }finally{  
            DbUtils.closeQuietly(conn);  
        }  
    }  
      
    /****数据库连接*** */ 
    public static Connection getConnection() {  
        Connection conn = null;  
        String driver = "com.mysql.jdbc.Driver";  
        String url = "jdbc:mysql://127.0.0.1/springapp?useUnicode=true&characterEncoding=gb2312";  
 
        DbUtils.loadDriver(driver);  
 
        try {  
            conn = DriverManager.getConnection(url, "root", "root");  
        } catch (SQLException ex) {  
            ex.printStackTrace();  
        }  
        return conn;  
    }  
      
}