Java 呼叫 DLL 完整教學：使用 JACOB (Java-COM Bridge) 控制 POS 周邊設備

背景

專案需透過 DLL 控制 POS 週邊（錢箱、小票印表機、顧客顯示器）。Java 無法直接載入 DLL，需透過橋接庫。本文採用 JACOB (Java-COM Bridge) 1.9 版。

環境準備

1. 下載 JACOB，取得 jacob.jar 與 jacob.dll。
2. jacob.dll 放入系統路徑（如 C:\Windows\System32）或 -Djava.library.path 指定目錄。
3. jacob.jar 加入專案 Classpath。

核心程式碼

import com.jacob.activeX.ActiveXComponent;
import com.jacob.com.Dispatch;

public class PosController {
    private ActiveXComponent controller;
    private Dispatch dispatch;

    public PosController() {
        try {
            // ControllerId 為 DLL 註冊的 ProgID
            controller = new ActiveXComponent("POSControler.Controler");
            dispatch = controller.getObject();
        } catch (Exception e) {
            dispatch = new Dispatch(); // 避免 NPE
            System.err.println("載入 DLL 失敗: " + e.getMessage());
        }
    }

    // 無參數方法
    public void setDefaultFont() {
        Dispatch.call(dispatch, "setDefaultFont");
    }

    // 有參數方法：依序傳入
    public void show(String value, int type) {
        Dispatch.call(dispatch, "show", value, type);
    }

    // 取得回傳值
    public String getStatus() {
        Variant v = Dispatch.call(dispatch, "getStatus");
        return v.getString();
    }
}

關鍵 API 說明

• ActiveXComponent(String progId)：連接 COM 元件（DLL 需先 regsvr32 註冊）。
• getObject()：取得 IDispatch 指標，後續透過 Dispatch.call 調用方法。
• Dispatch.call(dispatch, "methodName", args...)：引動方法，支援基本型別、String、Variant 自動封送。
• Dispatch.get/put：讀寫屬性。

常見坑點與解法

替代方案

若不想依賴 COM，可考慮 JNA (Java Native Access) 直接映射 C 風格 DLL 出口函數，無需註冊 COM 元件，跨平台性更好。

1. 上一篇文章： Java 專案整合 Neo4j 圖資料庫：嵌入模式與 REST 客戶端雙模式完整指南
2. 下一篇文章： Java Swing JTable 完整進階指南：基本用法、列點擊事件、自訂儲存格物件、動態增刪列

Java 相關知識

Java 8 聚合操作（Stream API）核心指南

Java 8 引入 Stream API，通過聚合操作實現集

Session Bean 實戰教學 (五)：建立資料庫驅動的無狀態定價元件

前言 延續前四篇 Session Bean 基礎教學，本文實

Seam 框架：專為 JSF 打造的無縫整合應用程式架構

前言：JSF 需要一個完整的應用框架 JavaServer

Java 類初始化順序詳解：靜態/非靜態字段、代碼塊、構造器、方法執行時序

前言 Java 類加載與初始化順序是面試高頻考點，也是理解對