commons-dbutils的使用

commons-dbutils的使用

DbUtils是一个小巧的Java类库，它是对JDBC的一次简单封装，没有复杂的逻辑。核心的类或接口是org.apache.commons.dbutils.QueryRunner和ResultSetHandler.通常只需要做的两件事就是，创建QueryRunner和实现ResultSetHandler。QueryRunner有如下几种创建方式

QueryRunner() //由此获得的runner对象进行数据库操作的时候，必须手动开一个连接
QueryRunner(boolean pmdKnownBroken) //意义和上面一样，并且当执行预编译传参时，对于Oracle数据库默认是不支持的，只有将此参数设置为TRUE，才能正确传参
QueryRunner(DataSource ds)   //给一个数据源就行了，无须手动开连接
QueryRunner(DataSource ds, boolean pmdKnownBroken)  //无须手动开连接和支持Oracle预编译传参

QueryRunner有如下几种查询方式

<T> T query(Connection conn, String sql, ResultSetHandler<T> rsh) 
<T> T query(Connection conn, String sql, ResultSetHandler<T> rsh, Object... params) 
<T> T query(String sql, ResultSetHandler<T> rsh)  
<T> T query(String sql, ResultSetHandler<T> rsh, Object... params) 

在以上的重载方法中，可以看到，query方法里都有一个ResultSetHandler类型的参数，故必须传入一个实现了ResultSetHandler的类实例。ResultSetHandler中只有一个方法，它把ResultSet里值转换为其他对象，你可以用已经实现了ResultSetHandler的具体类：AbstractKeyedHandler, AbstractListHandler, ArrayHandler, ArrayListHandler, BeanHandler, BeanListHandler, ColumnListHandler, KeyedHandler, MapHandler, MapListHandler, ScalarHandler，也可以自定义（只需要实现handle方法，把ResultSet中的数据转换为你喜欢的对象即可）

T handle(ResultSet rs)  

下面演示这些类如何一起使用

// Create a ResultSetHandler implementation to convert the
// first row into an Object[].
ResultSetHandler<Object[]> h = new ResultSetHandler<Object[]>() {
    public Object[] handle(ResultSet rs) throws SQLException {
        if (!rs.next()) {
            return null;
        }
    
        ResultSetMetaData meta = rs.getMetaData();
        int cols = meta.getColumnCount();
        Object[] result = new Object[cols];

        for (int i = 0; i < cols; i++) {
            result[i] = rs.getObject(i + 1);
        }

        return result;
    }
};

// Create a QueryRunner that will use connections from
// the given DataSource
QueryRunner run = new QueryRunner(dataSource);

// Execute the query and get the results back from the handler
Object[] result = run.query(
    "SELECT * FROM Person WHERE name=?", h, "John Doe");

也可以手动开一个连接，操作完成以后，必须手动把连接关了.

ResultSetHandler<Object[]> h = ... // Define a handler the same as above example

// No DataSource so we must handle Connections manually
QueryRunner run = new QueryRunner();

Connection conn = ... // open a connection
try{
    Object[] result = run.query(
        conn, "SELECT * FROM Person WHERE name=?", h, "John Doe");
	// do something with the result
	
} finally {
    // Use this helper method so we don't have to check for null
    DbUtils.close(conn);  
}