Apache Commons DBUtils - 首個應用程式

本章提供了一個使用 DBUtils 庫建立簡單 JDBC 應用程式的示例。這將向您展示如何開啟資料庫連線，執行 SQL 查詢以及顯示結果。

本模板示例中提到的所有步驟都將在本教程的後續章節中解釋。

建立 JDBC 應用程式

構建 JDBC 應用程式涉及以下六個步驟：

• 匯入包 - 需要包含包含資料庫程式設計所需的 JDBC 類的包。大多數情況下，使用 import java.sql.* 就足夠了。

• 註冊 JDBC 驅動程式 - 需要初始化一個驅動程式，以便您可以開啟與資料庫的通訊通道。

• 開啟連線 - 需要使用 DriverManager.getConnection() 方法建立一個 Connection 物件，該物件表示與資料庫的物理連線。

• 執行查詢 - 需要使用 Statement 型別物件來構建並將 SQL 語句提交到資料庫。

• 從結果集中提取資料 - 需要使用適當的 ResultSet.getXXX() 方法從結果集中檢索資料。

• 清理環境 - 需要顯式關閉所有資料庫資源，而不是依賴 JVM 的垃圾回收。

示例程式碼

此示例可以作為模板，當您將來需要建立自己的 JDBC 應用程式時可以使用。

此示例程式碼是基於上一章中完成的環境和資料庫設定編寫的。

將以下示例複製並貼上到 MainApp.java 中，編譯並執行如下：

MainApp.java

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;

import org.apache.commons.dbutils.DbUtils;
import org.apache.commons.dbutils.QueryRunner;
import org.apache.commons.dbutils.ResultSetHandler;
import org.apache.commons.dbutils.handlers.BeanHandler;

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);
      
      //Step 3: Create a ResultSet Handler to handle Employee Beans
      ResultSetHandler<Employee> resultHandler = new BeanHandler<Employee>(Employee.class);
      
      try {
         Employee emp = queryRunner.query(conn,
            "SELECT * FROM employees WHERE first=?", resultHandler, "Sumit");
         //Display values
         System.out.print("ID: " + emp.getId());
         System.out.print(", Age: " + emp.getAge());
         System.out.print(", First: " + emp.getFirst());
         System.out.println(", Last: " + emp.getLast());
      } finally {
         DbUtils.close(conn);
      }
   }
}

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;
   }
}

現在讓我們按如下方式編譯上述示例：

C:\>javac MainApp.java Employee.java
C:\>

執行MainApp時，會產生以下結果：

C:\>java MainApp
Connecting to database...
ID: 103, Age: 28, First: Sumit, Last: Mittal
C:\>