Java 動態建立 ODBC 資料源存取 DBF 檔案

核心原理

ODBC 資料源資訊儲存在 Windows 登錄檔中，路徑通常為：

HKEY_CURRENT_USER\Software\ODBC\ODBC.INI\<資料源名稱>
HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\<資料源名稱>

Java 本身無原生 API 操作登錄檔，需透過 JNI 呼叫 Windows API 或使用第三方庫（如 com.ice.jni.registry、ca.beq.util.win32.registry、jna）實現。

實作範例（基於 Ice JNI Registry 庫）

import com.ice.jni.registry.Registry;
import com.ice.jni.registry.RegistryKey;
import com.ice.jni.registry.RegStringValue;

public class CreateOdbcDsn {
    public static void main(String[] args) {
        String dsnName = "DBF_DataSource";
        String dbfDir = "F:/data/dbf/";
        String driver = "Microsoft dBase Driver (*.dbf)";
        
        try {
            // 1. 開啟/建立 ODBC.INI 節點
            RegistryKey odbcIni = Registry.HKEY_CURRENT_USER
                .openSubKey("Software")
                .openSubKey("ODBC")
                .openSubKey("ODBC.INI");
            
            // 若不存在則建立
            if (odbcIni == null) {
                odbcIni = Registry.HKEY_CURRENT_USER
                    .createSubKey("Software\\ODBC\\ODBC.INI");
            }
            
            // 2. 建立/開啟特定 DSN 節點
            RegistryKey dsnKey = odbcIni.createSubKey(dsnName);
            
            // 3. 寫入核心屬性
            dsnKey.setValue(new RegStringValue("Driver", driver));
            dsnKey.setValue(new RegStringValue("DefaultDir", dbfDir));
            dsnKey.setValue(new RegStringValue("Database", dbfDir));
            dsnKey.setValue(new RegStringValue("DriverId", "277"));
            dsnKey.setValue(new RegStringValue("FIL", "dBase IV"));
            dsnKey.setValue(new RegStringValue("MaxBufferSize", "2048"));
            dsnKey.setValue(new RegStringValue("PageTimeout", "600"));
            
            // 4. 同時註冊到 ODBC Data Sources 列表
            RegistryKey dsnList = odbcIni.openSubKey("ODBC Data Sources");
            if (dsnList == null) dsnList = odbcIni.createSubKey("ODBC Data Sources");
            dsnList.setValue(new RegStringValue(dsnName, driver));
            
            System.out.println("ODBC DSN [" + dsnName] + " 建立成功！");
            
        } catch (Exception e) {
            System.err.println("建立 DSN 失敗: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

關鍵屬性說明（dBase 驅動程式）

進階方案：純 Java 替代方案（推薦）

操作登錄檔存在平台鎖定、權限、JNI 部署複雜等問題。現代專案建議採用純 Java 方案：

1. Jackcess（Access/DBF 純 Java 讀寫）

<dependency>
    <groupId>com.healthmarketscience.jackcess</groupId>
    <artifactId>jackcess</artifactId>
    <version>4.0.4</version>
</dependency>

// 直接讀取 DBF，無需 ODBC
Table table = new DBFReader(new File("data.dbf")).getTable();
for (Row row : table) {
    System.out.println(row.get("FIELD_NAME"));
}

2. Apache Commons CSV + 自定解析

針對簡單 DBF 結構，可自行實作 DBF 標頭解析 + 記錄讀取，零依賴。

3. JDBC-ODBC Bridge 已移除提醒

Java 8 起移除 sun.jdbc.odbc.JdbcOdbcDriver，Java 7 亦不建議使用。請勿在新專案採用「建立 DSN → JDBC-ODBC Bridge 連線」架構。

部署與權限注意事項

• 32/64 位元相容：64 位元 Java 需 64 位元 ODBC 驅動與 64 位元 JNI 庫；反之亦然。
• 登錄檔寫入權限：`HKEY_LOCAL_MACHINE` 需管理員權限，建議寫入 `HKEY_CURRENT_USER`。
• JNI 庫部署：DLL 需放在 `java.library.path` 或系統 `PATH` 目錄下。
• 驅動程式前置條件：目標機器必須預裝對應 ODBC 驅動（如 Microsoft Access Database Engine）。

總結

雖可透過 JNI 操作登錄檔動態建立 ODBC DSN，但此技術棧屬舊世代方案，存在平台鎖定、部署複雜、維護困難等缺點。新專案強烈建議採用 Jackcess、XBaseJ 等純 Java 庫直接讀寫 DBF，或將 DBF 轉換為 SQLite/CSV 等現代格式後再處理。若受限於既有系統必須使用 ODBC，請將 DSN 建立邏輯封裝為安裝腳本（PowerShell/NSIS/Inno Setup）而非 Java 運行時動態建立，降低運行時風險。