1. WIKI教程
2. 学习Apache DB Utils
3. AsyncQueryRunner接口(AsyncQueryRunner Interface)

AsyncQueryRunner接口(AsyncQueryRunner Interface)

org.apache.commons.dbutils.AsyncQueryRunner类有助于执行具有异步支持的长时间运行的SQL查询。 这个类是线程安全的。 此类支持与QueryRunner相同的方法，但它返回Callable对象，稍后可以使用它来检索结果。

Class 声明 (Class Declaration)

以下是org.apache.commons.dbutils.AsyncQueryRunner类的声明 -

public class AsyncQueryRunner
   extends AbstractQueryRunner

用法 (Usage)

• Step 1 - 创建连接对象。

• Step 2 - 使用AsyncQueryRunner对象方法进行数据库操作。

例子 (Example)

以下示例将演示如何使用AsyncQueryRunner类更新记录。 我们将更新员工表中的一个可用记录。

语法 (Syntax)

String updateQuery = "UPDATE employees SET age=? WHERE id=?";
future = asyncQueryRunner.update(conn,
            "UPDATE employees SET age=? WHERE id=?", 33,103);

Where,

• updateQuery - 更新具有占位符的查询。

• asyncQueryRunner - 用于更新数据库中员工对象的asyncQueryRunner对象。

• future - 以后检索结果的future对象。

要理解与DBUtils相关的上述概念，让我们编写一个以异步模式运行更新查询的示例。 要编写我们的示例，让我们创建一个示例应用程序。

步	描述
1	更新在DBUtils - First Application章节下创建的文件MainApp.java 。
2	编译并运行应用程序，如下所述。

以下是Employee.java的内容。

public class Employee {
   private int id;
   private int age;
   private String first;
   private String last;
   public int getId() {
      return id;
   }
   public void setId(int id) {
      this.id = id;
   }
   public int getAge() {
      return age;
   }
   public void setAge(int age) {
      this.age = age;
   }
   public String getFirst() {
      return first;
   }
   public void setFirst(String first) {
      this.first = first;
   }
   public String getLast() {
      return last;
   }
   public void setLast(String last) {
      this.last = last;
   }
}

以下是MainApp.java文件的内容。

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;
import org.apache.commons.dbutils.AsyncQueryRunner;
import org.apache.commons.dbutils.DbUtils;
import org.apache.commons.dbutils.QueryRunner;
import java.util.concurrent.Callable;
import java.util.concurrent.ExecutionException; 
import java.util.concurrent.ExecutorCompletionService; 
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors; 
import java.util.concurrent.Future;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;
public class MainApp {
   // JDBC driver name and database URL
   static final String JDBC_DRIVER = "com.mysql.jdbc.Driver";  
   static final String DB_URL = "jdbc:mysql://localhost:3306/emp";
   //  Database credentials
   static final String USER = "root";
   static final String PASS = "admin";
   public static void main(String[] args) throws 
      SQLException, InterruptedException, 
      ExecutionException, TimeoutException {
      Connection conn = null;
      AsyncQueryRunner asyncQueryRunner = new AsyncQueryRunner( Executors.newCachedThreadPool());
      DbUtils.loadDriver(JDBC_DRIVER);       
      conn = DriverManager.getConnection(DB_URL, USER, PASS);
      Future<Integer> future = null;
      try {
         future = asyncQueryRunner.update(conn, 
            "UPDATE employees SET age=? WHERE id=?", 33,103);         
         Integer updatedRecords = future.get(10, TimeUnit.SECONDS);
         System.out.println(updatedRecords + " record(s) updated.");
      } finally {
         DbUtils.close(conn);
      }  
   }
}

完成源文件创建后，让我们运行应用程序。 如果您的应用程序一切正常，它将打印以下消息。

1 record(s) updated.