DbUtils：JDBC实用组件实例
这一页提供了一些展示如何使用DbUtils的示例。
基本用法
DbUtils是一个非常小的类库，因此浏览完所有类的javadoc不会花费很长时间。DbUtils的核心类/接口是QueryRunner和ResultSetHandler。你不需要知道其它DbUtils类就可以使用这一类库。下面的例子展示了这些类是如何一起使用的。
// Create a ResultSetHandler implementation to convert the
// first row into an Object[].
// 创建一个ResultSetHandler 实现，以把第一行转换成一个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，它会使用所给DataSource的连接
QueryRunner run = new QueryRunner(dataSource);
// Execute the query and get the results back from the handler
// 执行查询并从handler获取结果
Object[] result = run.query(
"SELECT * FROM Person WHERE name=?", h, "John Doe");
你也可以通过 java.sql.Connection 对象来代替 DataSource来执行先前的操作。注意，在这个例子中，你应该负责关闭Connection 。
ResultSetHandler<Object[]> h = ... // Define a handler the same as above example
// 定义一个和上面例子一样的handler
// No DataSource so we must handle Connections manually
// 没有DataSource，所以我们必须手动处理Connections
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
// 用result做些什么吧~
} finally {
// Use this helper method so we don't have to check for null
// 使用DbUtils的方法，所以我们不需要检查是否为null
DbUtils.close(conn);
}
你不仅可以从数据库获取数据，你也可以插入或者更新数据。下面的例子将首先插入一个person到数据库，并且之后改变person的height属性。
QueryRunner run = new QueryRunner( dataSource );
try
{
// Execute the SQL update statement and return the number of
// inserts that were made
// 执行SQL更新语句，并返回插入的数量？？？
int inserts = run.update( "INSERT INTO Person (name,height) VALUES (?,?)", "John Doe", 1.82 );
// The line before uses varargs and autoboxing to simplify the code
// 上一行使用可变参数和自动装箱以简化代码
// Now it's time to rise to the occation...
// 现在是时候进入正题了
int updates = run.update( "UPDATE Person SET height=? WHERE name=?", 2.05, "John Doe" );
// So does the line above
// 正如上一行所做
}
catch(SQLException sqle) {
// Handle it
// 处理它
}
对于长时间运行的调用，你可以使用 AsyncQueryRunner异步执行调用。 AsyncQueryRunner 类和 QueryRunner 类调用具有相同的方法；然而，这些方法返回一个Callable.
ExecutorCompletionService<Integer> executor = new ExecutorCompletionService<Integer>( Executors.newCachedThreadPool() );
AsyncQueryRunner asyncRun = new AsyncQueryRunner( dataSource );
try
{
// Create a Callable for the update call
// 为update调用创建一个Callable对象
Callable<Integer> callable = asyncRun.update( "UPDATE Person SET height=? WHERE name=?", 2.05, "John Doe" );
// Submit the Callable to the executor
// 向executor提交Callable对象
executor.submit( callable );
} catch(SQLException sqle) {
// Handle it
// 处理它
}
// Sometime later (or in another thread)
// 稍后（或在另一个线程之中）
try
{
// Get the result of the update
// 获取update的结果
Integer updates = executor.take().get();
} catch(InterruptedException ie) {
// Handle it
// 处理异常
}
ResultSetHandler的实现
在上面的例子中，我们实现了 ResultSetHandler 接口以把 ResultSet 第一行数据转换成一个Object[]。这是一个相当通用的实现，它可以在很多项目中重用。为了认识到这一点，DbUtils在org.apache.commons.dbutils.handlers包中提供了一系列 ResultSetHandler 实现，这些实现可以执行通常转换成array，maps，和JavaBean。There is a version of each implementation that converts just the first row and another that converts all rows in the ResultSet.下面是每一个实现的一个版本，这些都只是把第一行转换了，以及转换了在 ResultSet中的所有行。
我们将以一个例子开始，使用 BeanHandler 从 ResultSet 获取一行并把它转换成一个JavaBean。
QueryRunner run = new QueryRunner(dataSource);
// Use the BeanHandler implementation to convert the first
// ResultSet row into a Person JavaBean.
// 使用BeanHandler实现以把ResultSet中第一行转换成一个Person JavaBean
ResultSetHandler<Person> h = new BeanHandler<Person>(Person.class);
// Execute the SQL statement with one replacement parameter and
// return the results in a new Person object generated by the BeanHandler.
// 执行有一个替代参数的SQL语句，并把返回结果存入由BeanHandler生成的Person对象
Person p = run.query("SELECT * FROM Person WHERE name=?", h, "John Doe");
现在我们将使用BeanListHandler从 ResultSet获取所有行，并以JavaBean List 的形式返回。
QueryRunner run = new QueryRunner(dataSource);
// Use the BeanHandler implementation to convert the first
// ResultSet row into a Person JavaBean.
// 使用BeanListHandler实现以把所有的结果集行转换成Person JavaBean列表
ResultSetHandler<List<Person>> h = new BeanListHandler<Person>(Person.class);
// Execute the SQL statement and return the results in a List of
// Person objects generated by the BeanListHandler.
// 执行SQL语句并返回由BeanListHandler生成的Person对象列表
List<Person> persons = run.query("SELECT * FROM Person", h);
自定义RowProcessor
每一个所提供的ResultSetHandler 实现接收一个RowProcessor 来做真实的行到对象的转换。通过默认处理器使用BasicRowProcessor 实现，但是你可以实现一个自定义的版本来插入。可能最通用的自定义是去实现toBean() 方法来处理自定义数据库数据类型问题。
自定义BeanProecssor
BasicRowProcessor 使用一个BeanProcessor 来把 ResultSet 列转成JavaBean 属性. 你可以子类化并覆盖处理流程来指定你的应用程序的数据类型映射。所提供的实现把数据类型转换委托给JDBC驱动。
BeanProcessor 把列映射成为bean属性，如在BeanProcessor.toBean() Java文档中所述。 列名必须匹配bean的属性名，且区分大小写。例如，通过调用 setFirstName() 方法，firstname 类可以存储在bean中。然而，很多数据库列明包含或者不能使用或者在Java方法名中不常用的字符。你可以通过以下两种方法之一以把bean属性映射到这些列中。
- 把SQL中的列名别名化以使它们和Java属性名匹配: select social_sec# as socialSecurityNumber from person
- 子类化BeanProcessor，并覆盖方法mapColumnsToProperties() 来删除违规字符。