JMI

JNI Modern Interface in C++

特性

支持 Java 方法輸入、輸出參數

jclass、jmethodID、field 自動緩存

C++ 和 Java 方法屬性一致，如靜態方法對應 C++ 靜態成員函數

無需操心局部引用泄漏

getEnv() 支持任意線程，無需關心 detach

編譯器推導 java 類型及方法簽名，并只生成一次

支持 JNI 原生的各種類型、jmi 的 JObject、C/C++ string 及上述類型的數組形式(vector, valarray, array等) 作為函數參數、返回值及 field 類型

提供了方便使用的常用函數: to_string(std::string), from_string(jstring), android::application()

簡單易用，用戶代碼極簡

例子:

JNI_OnLoad 中設置 java vm: jmi::javaVM(vm);

創建 SurfaceTexture:

// 在任意 jmi::JObject 可見范圍內定義 SurfaceTexture tag 類

struct SurfaceTexture : jmi::ClassTag { static std::string name() {return "android/graphics/SurfaceTexture";}};

...

GLuint tex = ...

...

jmi::JObject texture;

if (!texture.create(tex)) {

// texture.error() ...

}

從 SurfaceTexture 構造 Surface:

struct Surface : jmi::ClassTag { static std::string name() {return "android.view.Surface";}}; // '.' or '/'

...

jmi::JObject surface;

surface.create(texture);

調用 void 方法:

texture.call("updateTexImage");

或

texture.call("updateTexImage");

調用含輸出參數的方法:

float mat4[16]; // or std::array, valarray

texture.call("getTransformMatrix", std::ref(mat4)); // use std::ref() if parameter should be modified by jni method

若出參類型是 JObject<...> 或器子類, 則可不使用std::ref()，因為對象不會改變，可能只是某些fields被方法修改了，如

MediaCodec::BufferInfo bi;

bi.create();

codec.dequeueOutputBuffer(bi, timeout); // bi is of type MediaCodec::BufferInfo&

調用有返回值的方法:

jlong t = texture.call("getTimestamp");

jmethodID 緩存

call/callStatic("methodName", ....) 每次都會調用 GetMethodID/GetStaticMethodID(), 而 call/callStatic<...mtag>(...) 只會調用一次, 其中 MTag 是 jmi:MethodTag 的子類，實現了 static const char* name() { return "methodName";}.

// GetMethodID() 對于每個不同的方法只會被調用一次

struct UpdateTexImage : jmi::MethodTag { static const char* name() {return "updateTexImage";}};

struct GetTimestamp : jmi::MethodTag { static const char* name() {return "getTimestamp";}};

struct GetTransformMatrix : jmi::MethodTag { static const char* name() {return "getTransformMatrix";}};

...

texture.call(); // or texture.call();

jlong t = texture.call();

texture.call(std::ref(mat4)); // use std::ref() if parameter should be modified by jni method

Field 接口

Field 接口支持可緩存和無緩存 jfieldID

通過 FieldTag 使用可緩存 jfieldID

JObject obj;

...

struct MyIntField : FieldTag { static const char* name() {return "myIntFieldName";} };

auto ifield = obj.field();

jfieldID ifid = ifield; // 或 ifield.id()

ifield.set(1234);

int ivalue = ifield; // 或 ifield.get();

// 靜態 field 也一樣，除了使用的是靜態方法 JObject::staticField

struct MyStrFieldS : FieldTag { static const char* name() {return "myStaticStrFieldName";} };

auto& ifields = JObject::staticField<:string myintfields>(); // it can be an ref

jfieldID ifids = ifields; // 或 ifield.id()

ifields.set("JMI static field test");

ifields = "assign";

std::string ivalues = ifields; // 或 ifield.get();

通過 field 名字使用無緩存 jfieldID

auto ifield = obj.field("myIntFieldName");

...

給 Java 類寫個 C++ 類

創建 JObject 或把其對象作為成員變量，或使用 CRTP JObject。 每個方法是想通常不超過3行代碼，也可以使用一些宏使每個方法實現只需一行代碼， 參見 JMITest 及 Project AND

使用編譯器生成的簽名

模版 string signature_of(T) 返回類型 T 的簽名. T 可以是 JMI 支持的類型(除了jobject，因為其類型是運行時確定的)、reference_wrapper、void 及由以上類型作為返回類型和參數類型的函數類型

string signature_of(T) 返回的 string 是靜態存儲的，使用 signature_of(...).data() 是安全的

例子:

void native_test_impl(JNIEnv *env , jobject thiz, ...) {}

staitc const JNINativeMethod gMethods[] = {

{"native_test", signature_of(native_test_impl).data(), native_test_impl},

...

};

也許你發現了可以用宏來簡化

#define DEFINE_METHOD(M) {#M, signature_of(M##_impl).data(), M##_impl}

staitc const JNINativeMethod gMethods[] = {

DEFINE_METHOD(native_test),

...

}

已知問題

如果返回類型與前 n 個參數類型是一樣的，需要顯示指定這些類型

為什么 JObject 是個模版?

為了支持 jclass、jmethodID、jfieldID 緩存

已測編譯器

g++ >= 4.9, clang >= 3.4.2

TODO

modern C++ 類自動生成腳本

簽名無需運行時string

MIT License

Copyright (c) 2016-2019 WangBin

總結

以上是生活随笔為你收集整理的java jmi的基本思想_jmi: JMI 是 JNI 的 C++11/14封装，目的是为了简化JNI使用的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。