Java Native 關鍵字與 JNI 開發完整指南

Java Native 關鍵字與 JNI 開發完整指南

1. 什麼是 native 與 JNI？

native 修飾的方法表示該方法由非 Java 語言（通常是 C/C++）實現，編譯為平台相關的動態庫（Windows .dll、Linux .so），通過 JNI (Java Native Interface) 供 Java 調用。JDK 源碼中 Object.hashCode()、Thread.start() 等底層方法均為 native。

2. JNI 開發標準流程

1. 編寫 Java 類：聲明 native 方法，靜態塊 System.loadLibrary("库名") 載入動態庫。
2. 編譯生成 .class：javac HelloNative.java
3. 生成 C/C++ 頭文件：javah HelloNative 產生 HelloNative.h，包含 JNI 規範的函數簽名（如 Java_HelloNative_sayHello）。
4. 實現 C/C++ 源碼：包含 jni.h 與生成的頭文件，實現邏輯（如 printf("Hello, JNI")）。
5. 編譯為動態庫：Windows 下用 MinGW GCC：gcc -shared -o HelloNative.dll HelloNative.c -I"%JAVA_HOME%\include" -I"%JAVA_HOME%\include\win32"
6. 運行 Java 程序：java HelloNative，控制台輸出 Hello, JNI。

3. 關鍵技術點

• 命名規範：JNI 函數名固定為 Java_全類名_方法名，參數必含 JNIEnv*、jclass/jobject。
• 數據類型映射：jint↔int、jstring↔String、jobjectArray↔Object[] 等。
• 異常處理：C 代碼拋出異常需調用 ThrowNew，Java 端捕獲。
• 線程安全：JNIEnv 僅在當前線程有效，跨線程需用 JavaVM 附著。

4. 適用場景與權衡

代價：喪失跨平台性、增加部署複雜度、難以除錯、GC 無法管理堆外內存。原則：能用 Java 解決絕不用 native。

5. 進階提示

• JDK 9+ 推薦使用 JEP 376: ZGC 或 Panama 專案（Foreign Function & Memory API）替代傳統 JNI，提供更安全、高效的堆外互操作。
• 生產環境建議將 native 邏輯封裝為獨立微服務（gRPC/JNI），避免污染主應用進程。