萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

JNI 開發指南:C/C++ 中嵌入 JVM 調用 Java 方法完整流程

為什麼需要 JNI 嵌入 JVM?

  • 避免 java -jar 彈出控制台窗口,實現純 GUI 啟動器。
  • 複用現有 Java 業務庫 (加密、協議解析、規則引擎)。
  • 高性能原生層 (C/C++) 驅動 Java 邏輯,或反向回調。

環境準備 (Windows + Visual Studio)

  1. 安裝 JDK (如 C:\JDK)。
  2. VS 屬性 → VC++ 目錄:
    • 包含目錄:$(JDK_HOME)\include;$(JDK_HOME)\include\win32
    • 庫目錄:$(JDK_HOME)\lib
  3. 系統 PATH 加入 $(JDK_HOME)\jre\bin\server (載入 jvm.dll)。

示例 Java 類 (編譯為 jni/test/Demo.class)

package jni.test;
public class Demo {
    public static int COUNT = 8;
    public String msg;
    private int[] counts;

    public Demo() { this("默認構造"); }
    public Demo(String msg) { this.msg = msg; System.out.println("構造: " + msg); }

    public String getMessage() { return msg; }
    public int[] getCounts() { return counts; }
    public void setCounts(int[] c) { counts = c; }
    public void throwExcp() throws IllegalAccessException { throw new IllegalAccessException("故意拋出"); }
}

步驟 1:創建 JVM

#include <jni.h>
#include <cstdio>
#include <cstdlib>

JavaVM* jvm = nullptr;
JNIEnv* env = nullptr;

bool create_vm() {
    JavaVMInitArgs vm_args{};
    vm_args.version = JNI_VERSION_1_8; // 關鍵:必須設置版本

    JavaVMOption opts[3];
    opts[0].optionString = "-Djava.class.path=.";           // 類路徑
    opts[1].optionString = "-Djava.compiler=NONE";          // 關閉 JIT 便於調試
    opts[2].optionString = "-verbose:jni";                  // JNI 診斷輸出
    vm_args.nOptions = 3;
    vm_args.options = opts;
    vm_args.ignoreUnrecognized = JNI_TRUE;

    jint rc = JNI_CreateJavaVM(&jvm, reinterpret_cast<void**>(&env), &vm_args);
    if (rc != JNI_OK) {
        std::fprintf(stderr, "JVM 創建失敗: %d\n", rc);
        return false;
    }
    return true;
}

步驟 2:查找類與方法 ID

jclass cls = env->FindClass("jni/test/Demo"); // 包名用 '/' 分隔
if (!cls) { std::fprintf(stderr, "找不到類\n"); return; }

// 構造器: 
jmethodID ctor = env->GetMethodID(cls, "", "(Ljava/lang/String;)V");
// 實例方法
jmethodID getMsg = env->GetMethodID(cls, "getMessage", "()Ljava/lang/String;");
// 靜態字段
jfieldID fid = env->GetStaticFieldID(cls, "COUNT", "I");

簽名獲取技巧:javap -s -p jni.test.Demo 輸出標準簽名。

步驟 3:創建對象、調用方法、訪問字段

// new Demo("來自 C++")
jstring jmsg = env->NewStringUTF("來自 C++");
jobject obj = env->NewObject(cls, ctor, jmsg);

// 調用 getMessage
jstring ret = static_cast<jstring>(env->CallObjectMethod(obj, getMsg));
const char* cstr = env->GetStringUTFChars(ret, nullptr);
std::printf("Java 返回: %s\n", cstr);
env->ReleaseStringUTFChars(ret, cstr);

// 訪問靜態字段
jint count = env->GetStaticIntField(cls, fid);
std::printf("COUNT = %d\n", count);

// 設置數組字段
jintArray arr = env->NewIntArray(3);
jint vals[3] = {1,2,3};
env->SetIntArrayRegion(arr, 0, 3, vals);
env->SetObjectField(obj, env->GetFieldID(cls, "counts", "[I"), arr);

// 捕獲異常
env->CallVoidMethod(obj, env->GetMethodID(cls, "throwExcp", "()V"));
if (env->ExceptionCheck()) {
    env->ExceptionDescribe(); // 打印堆棧
    env->ExceptionClear();    // 必須清除,否則後續 JNI 調用失敗
}

步驟 4:銷毀 JVM

void destroy_vm() {
    if (jvm) jvm->DestroyJavaVM();
}

關鍵坑點總結

坑點後果對策
類名用點號 jni.test.DemoFindClass 返回 NULL統一用斜槓 jni/test/Demo
簽名寫錯 (如漏分號、類名錯)GetMethodID 返回 NULL用 javap -s 生成,複製貼上
未檢查 ExceptionCheck後續 JNI 調用靜默失敗/崩潰每次調用後檢查並 ExceptionClear
局部引用溢出 (預設 512)長循環中創建大量對象崩潰PushLocalFrame/PopLocalFrame 或 DeleteLocalRef
線程附着非創建 JVM 線程調用 JNI 崩潰jvm->AttachCurrentThread / DetachCurrentThread
編譯架構不匹配 (x86/x64)載入 jvm.dll 失敗VS 平台目標與 JDK 位數一致

現代替代方案

  • GraalVM Native Image:將 Java 預編譯為原生可執行文件,無需 JVM 嵌入。
  • JavaCPP / JNA / JNR:高級封裝,自動生成綁定,減少手寫 JNI 錯誤。
  • gRPC / REST:進程間通信替代進程內調用,架構更清晰。
copyright © 萬盛學電腦網 all rights reserved