java jmi的基本思想_jmi: JMI 是 JNI 的 C++11/14封装，目的是为了简化JNI使用「建议收藏」
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
