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://127.0.0.1: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:\>
广告