AsyncQueryRunner 介面

org.apache.commons.dbutils.AsyncQueryRunner 類有助於使用非同步支援執行長時間執行的 SQL 查詢。此類是執行緒安全的。此類支援與 QueryRunner 相同的方法，但它返回可稍後用於檢索結果的 Callable 物件。

類宣告

以下是 org.apache.commons.dbutils.AsyncQueryRunner 類的宣告：

public class AsyncQueryRunner
   extends AbstractQueryRunner

用法

• 步驟 1 - 建立連線物件。

• 步驟 2 - 使用 AsyncQueryRunner 物件方法進行資料庫操作。

示例

以下示例將演示如何使用 AsyncQueryRunner 類更新記錄。我們將更新 employee 表中的一條可用記錄。

語法

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

其中：

• updateQuery - 包含佔位符的更新查詢。

• asyncQueryRunner - 用於更新資料庫中 employee 物件的 asyncQueryRunner 物件。

• future - 用於稍後檢索結果的 Future 物件。

為了理解上述與 DBUtils 相關的概念，讓我們編寫一個示例，該示例將以非同步模式執行更新查詢。為了編寫我們的示例，讓我們建立一個示例應用程式。

以下是 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://: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.