Java 呼叫 Windows COM 元件發送傳真 (Jacob 庫實作)

環境需求

• Windows XP / Server 2003 以上
• JDK 1.4 ~ 1.6（過高版本可能與 jacob.dll 不相容）
• 實體 Modem 並已安裝 Fax 服務（控制台可手動發送傳真）
• Jacob 1.9（jacob.jar + jacob.dll）

安裝步驟

1. jacob.dll 複製到 C:\Windows\System32（或 JVM java.library.path 目錄）。
2. 專案加入 jacob.jar；同步將 jar、dll 放入 JRE/lib 或設定 -Djava.library.path。

核心程式碼

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

public class FaxSender {
    public void sendFax(String filePath, String faxNumber) {
        // 1. 連接 FAX 服務 (ProgID 需對應登錄表)
        ActiveXComponent faxServer = new ActiveXComponent("FaxServer.FaxServer.1");
        Dispatch faxObj = faxServer.getObject();

        // 2. 開啟連線
        Dispatch.call(faxObj, "Connect", "");

        // 3. 建立文件物件
        Dispatch doc = Dispatch.call(faxObj, "CreateDocument", filePath).toDispatch();

        // 4. 設定收件資訊
        Dispatch.put(doc, "RecipientName", "Someone");
        Dispatch.put(doc, "FaxNumber", faxNumber); // 格式需符合 Modem 驅動要求
        Dispatch.put(doc, "DisplayName", "SenderName");

        // 5. 發送
        Dispatch.call(doc, "Send");

        // 6. 斷開
        Dispatch.call(faxObj, "DisConnect");
    }

    public static void main(String[] args) {
        try {
            new FaxSender().sendFax("https://www.bt285.cn/WW.doc", "028886666");
            System.out.println("ok fax transfer successfully!");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

常見錯誤與排解

架構說明

Java → JNI → jacob.dll → Windows COM → FaxServer.FaxServer.1 (Windows Fax Service) → Modem 發送。適用於需整合傳統傳真伺服器的企業系統。