MapListHandler 類

org.apache.commons.dbutils.MapListHandler 是 ResultSetHandler 介面的實現，負責將 ResultSet 行轉換為 Map 列表。此類是執行緒安全的。

類宣告

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

public class MapListHandler
   extends AbstractListHandler<Map<String,Object>>

用法

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

• 步驟 2 - 獲取 ResultSetHandler 的實現作為 MapListHandler 物件。

• 步驟 3 - 將 resultSetHandler 傳遞給 QueryRunner 物件，並進行資料庫操作。

示例

以下示例將演示如何使用 MapListHandler 類讀取記錄列表。我們將讀取 Employees 表中可用的記錄作為 Map 列表。

語法

List<Map<String, Object>> result = queryRunner.query(conn, "SELECT * FROM employees", new MapListHandler());

其中，

• resultHandler - MapListHandler 物件，用於將結果集對映到 Map 列表。

• queryRunner - QueryRunner 物件，用於從資料庫讀取員工物件。

為了理解上面提到的與 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 java.util.List;
import java.util.Map;

import org.apache.commons.dbutils.DbUtils;
import org.apache.commons.dbutils.QueryRunner;
import org.apache.commons.dbutils.handlers.MapListHandler;

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 {
      Connection conn = null;
      QueryRunner queryRunner = new QueryRunner();
      
      //Step 1: Register JDBC driver
      DbUtils.loadDriver(JDBC_DRIVER);

      //Step 2: Open a connection
      System.out.println("Connecting to database...");
      conn = DriverManager.getConnection(DB_URL, USER, PASS);        

      try {
         List<Map<String, Object>> result = queryRunner.query(
            conn, "SELECT * FROM employees", new MapListHandler());      
         System.out.println(result);
      } finally {
         DbUtils.close(conn);
      }        
   }
}

建立完原始檔後，讓我們執行應用程式。如果應用程式一切正常，它將列印以下訊息。

Connecting to database...
[{id=100, age=18, first=Zara, last=Ali}, 
{id=101, age=25, first=Mahnaz, last=Fatma}, 
{id=102, age=30, first=Zaid, last=Khan}, 
{id=103, age=33, first=Sumit, last=Mittal}]