AsyncQueryRunner interface


The org.apache.commons.dbutils.AsyncQueryRunner class helps to execute long running SQL queries with async support. This class is thread safe. This class supports same methods as QueryRunner but it return Callable objects which can be used later to retrieve the result.

Class Declaration

Following is the declaration for org.apache.commons.dbutils.AsyncQueryRunner class −

public class AsyncQueryRunner
   extends AbstractQueryRunner


  • Step 1 − Create a connection object.

  • Step 2 − Use AsyncQueryRunner object methods to make database operations.


Following example will demonstrate how to update a record using AsyncQueryRunner class. We'll update one of the available record in employee Table.


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


  • updateQuery − Update query having placeholders.

  • asyncQueryRunner − asyncQueryRunner object to update employee object in database.

  • future − Future object to retrieve result later.

To understand the above-mentioned concepts related to DBUtils, let us write an example which will run an update query in async mode. To write our example, let us create a sample application.

Step Description
1 Update the file created under chapter DBUtils - First Application.
2 Compile and run the application as explained below.

Following is the content of the

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) { = 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;

Following is the content of the file.

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());

      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 {

Once you are done creating the source files, let us run the application. If everything is fine with your application, it will print the following message.

1 record(s) updated.