您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

運用 JNA 存取遺留原生代碼（上）：橋接 Java 與 DLL

編輯：Java 相關知識

為什麼需要 JNA？

Java Native Access (JNA) 讓 Java 直接呼叫原生函式庫（DLL/.so），無需撰寫 JNI 胶水代碼、編譯 Header、處理複雜的類型映射。它避免了修改遺留 C/C++ 代碼、昂貴的專有橋接方案，並有效取代傳統 JNI。

核心範例：呼叫 Windows kernel32.dll

定義介面繼承 Library，宣告需呼叫的原生函式：


public interface CLibrary extends Library {
    CLibrary INSTANCE = (CLibrary) Native.loadLibrary(
        Platform.isWindows() ? "kernel32" : "c", CLibrary.class);
    int GetTickCount(); // 系統啟動至今毫秒數
}
public static void main(String[] args) {
    System.out.println("TickCount: " + CLibrary.INSTANCE.GetTickCount());
}

無需 JNI，直接對應 DLL 符號即可呼叫。

存取結構體：SYSTEMTIME 範例

JNA 可直接映射 C 結構體：


Kernel32 lib = Kernel32.INSTANCE;
SYSTEMTIME time = new SYSTEMTIME();
lib.GetSystemTime(time);
System.out.println("Day: " + time.wDay);

Java 程式碼取得低層平台資料，展現 JNA 橋接能力。

實戰：建立自訂 DLL 並透過 JNA 呼叫

步驟 1：使用 Visual C++ 2005 Express 建立 DLL

關鍵代碼：


extern "C" __declspec(dllexport) DWORD helloWorld(DWORD divider) {
    return 77 / divider;
}

需設定呼叫慣例為 __cdecl，編譯產出 nativecode.dll。

步驟 2：JNA 對應介面


public interface NativeLib extends Library {
    NativeLib INSTANCE = (NativeLib) Native.loadLibrary("nativecode", NativeLib.class);
    int helloWorld(int divider);
}

測試呼叫與例外處理（除零錯誤）展示 JNA 靈活性。