萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Java 連接 Access 資料庫完整教學:JDBC-ODBC 橋接與 UCanAccess 現代方案

方案一:JDBC-ODBC 橋接 (Java 8 以前、Windows 限定)

⚠ 注意:Java 8 起移除 sun.jdbc.odbc.JdbcOdbcDriver,僅供維護舊專案參考。

步驟 1:建立 Access 資料庫

  • 建立 ReportDemo.mdb (Access 2003) 或 .accdb (Access 2007+)
  • 放置專案目錄下,如 src/main/resources/data/

步驟 2:配置系統 ODBC 資料源 (Windows)

  1. 控制台 → 系統管理工具 → ODBC 資料來源 (32/64 位按 Office 版本)
  2. 系統 DSN → 新增 → 選「Microsoft Access Driver (*.mdb, *.accdb)」
  3. 資料源名稱:MyAccessDSN,選擇資料庫檔案

步驟 3:Java 連接代碼

import java.sql.*;

public class AccessJdbcOdbc {
    public static void main(String[] args) {
        String url = "jdbc:odbc:MyAccessDSN"; // 使用系統 DSN
        // 或無 DSN 連接字串 (需絕對路徑)
        // String url = "jdbc:odbc:Driver={Microsoft Access Driver (*.mdb, *.accdb)};DBQ=C:/path/ReportDemo.accdb;";

        try (Connection conn = DriverManager.getConnection(url, "", "");
             Statement stmt = conn.createStatement();
             ResultSet rs = stmt.executeQuery("SELECT * FROM Users")) {

            while (rs.next()) {
                System.out.println(rs.getInt("id") + " | " + rs.getString("name"));
            }
        } catch (SQLException e) {
            e.printStackTrace();
        }
    }
}

方案二:UCanAccess —— 純 Java、跨平台、支援 .accdb (推薦現代專案)

Maven 依賴

<dependency>
    <groupId>net.sf.ucanaccess</groupId>
    <artifactId>ucanaccess</artifactId>
    <version>5.0.2</version> <!-- 檢查最新版 -->
</dependency>

連接代碼

import java.sql.*;
import java.io.File;

public class AccessUCanAccess {
    public static void main(String[] args) {
        // 專案相對路徑
        File dbFile = new File("src/main/resources/data/ReportDemo.accdb");
        String url = "jdbc:ucanaccess://" + dbFile.getAbsolutePath();

        try (Connection conn = DriverManager.getConnection(url);
             Statement stmt = conn.createStatement();
             ResultSet rs = stmt.executeQuery("SELECT * FROM Users")) {

            while (rs.next()) {
                System.out.println(rs.getInt("id") + " | " + rs.getString("name"));
            }
        } catch (SQLException e) {
            e.printStackTrace();
        }
    }
}

UCanAccess 優勢

  • 純 Java,無需安裝 Access/ODBC 驅動
  • 跨平台 (Windows/Linux/Mac)
  • 支援 .accdb (Access 2007+)
  • 支援 Jackcess 讀寫,效能優於 JDBC-ODBC

連接池整合 (HikariCP 範例)

import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;
import javax.sql.DataSource;

public class AccessDataSource {
    private static final DataSource DATA_SOURCE;

    static {
        HikariConfig config = new HikariConfig();
        File dbFile = new File("src/main/resources/data/ReportDemo.accdb");
        config.setJdbcUrl("jdbc:ucanaccess://" + dbFile.getAbsolutePath());
        config.setMaximumPoolSize(5);
        config.setConnectionTestQuery("SELECT 1");
        DATA_SOURCE = new HikariDataSource(config);
    }

    public static Connection getConnection() throws SQLException {
        return DATA_SOURCE.getConnection();
    }
}

常見問題排查

錯誤原因解決
No suitable driver found驅動未載入 / URL 格式錯誤檢查 Maven 依賴、URL 協議 jdbc:ucanaccess://
File not found相對路徑錯誤用 File.getAbsolutePath()、或置於 classpath 用 classpath:data/ReportDemo.accdb (UCanAccess 支援)
鎖定錯誤 .laccdbAccess 開啟中 / 另一進程未關閉連接關閉 Access、確保連接池正確關閉、啟用 ;ignoreCase=true
中文亂碼字符編碼不匹配URL 加 ;charset=UTF-8、資料庫欄位設為 Unicode 壓縮

遷移建議

Access 適合輕量級桌面/小型 Web,若專案增長建議遷移至:

  • H2 / SQLite:嵌入式、零配置、支援標準 SQL
  • MySQL / PostgreSQL:生產級、併發強、生態豐富
  • 遷移工具:Flyway / Liquibase 管理 Schema 版本
copyright © 萬盛學電腦網 all rights reserved