Java 訪問 COM 組件實戰：Jacob (Java-COM Bridge) 完整指南

Jacob 簡介

• 全稱：Java-COM Bridge
• 原理：JNI 呼叫 Windows COM 子系統 (oleaut32.dll)，實現 Java 物件與 COM 物件雙向映射
• 授權：LGPL，開源專案 SourceForge
• 適用場景：操作 Office (Word/Excel/PowerPoint)、Outlook、IE 自動化、Windows 系統管理 (WMI/ADSI)、舊版 VB6/Delphi COM 元件互操作

安裝部署 (三步驟)

1. 下載 jacob_1.9.zip (或更新版 1.14.3+)
2. 解壓取兩檔：
   • jacob.jar → 加入 Classpath (專案 Libraries / WEB-INF/lib / Maven 依賴)
   • jacob.dll (32/64-bit 對應 JVM) → 放入 java.library.path 目錄：
     • %JAVA_HOME%/bin
     • %SYSTEMROOT%/System32 (需管理員權限)
     • 專案根目錄 / WEB-INF/lib/native/ (配合 -Djava.library.path)
3. 無需註冊 (regsvr32)，COM 元件本身需已在系統註冊

核心 API 速查

入門範例：ScriptControl 計算器

import com.jacob.com.*;
import com.jacob.activeX.*;

public class AppTest {
    public static void main(String[] args) {
        // 1. 建立 COM 物件 (ProgID: "ScriptControl")
        ActiveXComponent scriptControl = new ActiveXComponent("ScriptControl");
        Dispatch dispatch = scriptControl.getObject();

        // 2. 設定腳本語言
        Dispatch.put(dispatch, "Language", "VBScript");

        // 3. 呼叫 Eval 方法執行運算式
        Variant result = Dispatch.call(dispatch, "Eval", args[0]); // args[0] = "1+2*3"

        // 4. 輸出結果
        System.out.println(result.toString()); // 輸出 7
    }
}

編譯執行：

javac -cp jacob.jar AppTest.java
java -cp .;jacob.jar AppTest "1+2*3"

進階實戰：Excel 自動化報表

public class ExcelReport {
    public static void main(String[] args) {
        ComThread.InitSTA(); // 必須：Office 需單執行緒單元
        ActiveXComponent excel = null;
        try {
            excel = new ActiveXComponent("Excel.Application");
            excel.setProperty("Visible", new Variant(false)); // 背景執行

            Dispatch workbooks = excel.getProperty("Workbooks").toDispatch();
            Dispatch workbook = Dispatch.call(workbooks, "Add").toDispatch();
            Dispatch sheets = Dispatch.get(workbook, "Sheets").toDispatch();
            Dispatch sheet = Dispatch.call(sheets, "Item", 1).toDispatch();

            // 寫入標題
            Dispatch.put(Dispatch.call(sheet, "Cells", 1, 1).toDispatch(), "Value", "產品");
            Dispatch.put(Dispatch.call(sheet, "Cells", 1, 2).toDispatch(), "Value", "價格");

            // 寫入資料 (範例)
            String[][] data = {{"蘋果", "50"}, {"香蕉", "30"}, {"橘子", "40"}};
            for (int i = 0; i < data.length; i++) {
                Dispatch.put(Dispatch.call(sheet, "Cells", i+2, 1).toDispatch(), "Value", data[i][0]);
                Dispatch.put(Dispatch.call(sheet, "Cells", i+2, 2).toDispatch(), "Value", data[i][1]);
            }

            // 儲存
            String filePath = "C:\\temp\\report.xls";
            Dispatch.call(workbook, "SaveAs", filePath);
            System.out.println("報表已產生: " + filePath);

        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (excel != null) {
                Dispatch.call(excel.getObject(), "Quit"); // 關閉 Excel 進程
            }
            ComThread.Release(); // 釋放 STA
        }
    }
}

關鍵最佳實踐

1. STA 執行緒：Office COM 為單執行緒單元 (STA)，必須 ComThread.InitSTA() 啟動，結束時 ComThread.Release()
2. 資源釋放：每個 Dispatch、Variant 用完呼叫 safeRelease() 或 Dispatch.safeRelease()，避免 COM 參考計數洩漏導致 Excel/Word 殭屍進程
3. 例外處理：捕捉 ComFailException，檢查 ex.getErrorCode() 對應 HRESULT
4. 32/64-bit 相容：JVM、Jacob DLL、Office 必須同位元 (全 32 或全 64)，否則 UnsatisfiedLinkError 或 ClassNotRegisteredException
5. 無頭模式：伺服器環境設定 Visible=false、DisplayAlerts=false，避免彈窗卡住

常見問題排查

現代替代方案

• Apache POI：純 Java 讀寫 Office Open XML (xlsx/docx/pptx)，無需 COM、跨平台、效能更好
• docx4j / jOpenDocument：專注 OOXML / ODF 格式
• Microsoft Graph API：雲端操作 OneDrive/SharePoint/Exchange，REST + OAuth2
• Power Automate / Office Scripts：低代碼自動化

總結

Jacob 是 Java 呼叫 Windows COM 的經典橋樑，適合維護舊系統整合 Office/系統管理自動化。核心要點：STA 執行緒、參考計數釋放、位元相容。新專案優先考慮 Apache POI 或雲端 API，避免平台鎖定與維護負擔。