JNI快速学习

JNI是JVM中的一部分,它的存在就是为了打通java和native模块的桥梁。刚接触的时候会遇到一堆陌生的api,其实这些api的命名比较规范,调用几次之后就能举一反三。关键是要弄懂JNI的一些调用顺序,以下就是我用JNI碰到的一些关键点所做的记录。

JNI_OnLoad

JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM *vm, void *reserved)
{
    // TODO: 保存vm在本地
}

JNI_OnLoad是JNI调用native的第一个函数,算是JNI的入口。参数vm一般是需要保存下来,因为它是访问JVM的一个关键对象。

JNIEnv

env对象是每次Java和Navtive调用的必须参数,这个参数可以每次用的时候由JavaVM对象获取得到

static bool getEnv(JNIEnv **env)
{
    bool bRet = false;
    do 
    {
        if (JAVAVM->GetEnv((void**)env, JNI_VERSION_1_4) != JNI_OK)
        {
            LOGD("Failed to get the environment using GetEnv()");
            break;
        }

        if (JAVAVM->AttachCurrentThread(env, 0) < 0)
        {
            LOGD("Failed to get the environment using AttachCurrentThread()");
            break;
        }
        bRet = true;
    } while (0);        

    return bRet;
}

上面的代码来自coco2d-x-qt,大家的写法大同小异。

JNI中两个最重要的对象理解到后,剩下的工作就是具体的调用而已。

Java -> Native

java调navtive就只有一种方式:function

class JClass {
  private navtive void cfunc();
}

只需要在java函数前加上native,调用的时候就自动到native模块中寻找对应的方法。
native中函数声明的样式是固定的 Java_包名_类名_函数名,参数第一个是JNIEnv,第二个是jobject,如果是静态函数则是jclass;后面的参数视情况而定。

#include <jni.h>
   
JNIEXPORT void JNICALL Java_JCalss_cfunc(JNIEnv *env, jobject
obj)  {
}

native头文件推荐用javah -jni命令直接生成,以防参数写错。参考链接

javah使用注意事项:

javah -classpath 路径(不包含包名) -jni 完整类名(包含包名)

路径必须是完整路径

Native->Java

对象创建

创建对象先要得到对象的class,然后用对象创建方法创建

jclass jcls = env->FindClass("java/lang/String");
jobject jobj = env->AllocateObject(jcls);

或者,自己指定构造函数

jmethodID mID1 = env->GetMethodID(jcls,
   "<init>", "()V");
jobj1 = env->NewObject(jcls, mID1); // 这种方式等同与AllocateObject

jmethodID mID2 = env->GetMethodID(jcls,
   "<init>", "(I)V");
jobj2 = env->NewObject(jcls, mID2, 123); // 用带一个参数为整数的构造函数

JNI也提供了诸如NewIntArray等创建数组包装函数,文档地址

在4.0上,NewStringUTF8有bug,如果字符串包含中文或emoji,可能造成crash。解决方案见 https://stackoverflow.com/a/34218851/1118964

访问属性

属性的访问先要通过jclass得到jfiledID。JNI包装了各种类型的访问函数,通过filedID就可以访问到这些属性了

jfieldID valId = env->GetFieldID(jcls, "val", "I"); // 获取熟悉val的fileID
jint intVal = env->GetIntField(jobj, valId); // read
env->SetIntField(jobj, valId, intVal);       // write

静态属性fileID是通过GetStaticFieldID,read和write时,第一个参数时jclass。

方法调用

方法调用第一步也是要通过jclass得到jmethodID。然后直接调用就可以了

jmethodID mID = env->GetMethodID(jcls, "method", "()V");
env->CallVoidMethod(mID);

如果java的方法带参数,调CallMethod的时候直接在后面加上,有多少个就加多少个。要保持与函数签名一致

jmethodID mID = env->GetMethodID(jcls, "method", "(I)V");
env->CallVoidMethod(mID, 123);

如果函数有返回值,相应的CallMethod也可以带上

jmethodID mID = env->GetMethodID(jcls, "method", "(I)I");
int res = env->CallIntMethod(mID, 123); // 返回整数

静态方法也静态属性一样,把GetMethodID换成GetStaticMethodID即可,其他无变化。

参考链接

线程安全

线程安全主要发生在native调java时,一般表现为地址访问非法。

因为JNIEnv是一个线程相关的变量,每个线程都有不同的env。所以为了安全起见,env对象都是在使用前通过JavaVM获取(参考上面getEnv代码),JavaVM是全局有效的。

一个线程中的jobject是不能在另一个线程中使用的,解决方法是调用 env->NewGlobalRef 创建一个全局变量。jclass继承于jobject,所以跨线程访问也需要创建全局变量。 jmethodID/jfieldID 与 jobject 没有继承关系,它只是个整数。

内存管理

内存管理指的是native创建的java释放的问题。基本原则:如果创建的对象不返回java,就需要delete掉

全局对象不会被java回收,所以 NewGlobalRef/DeleteGlobalRef 需要配套使用。

从java对象里的到的指针也必须手动释放,举例

const char* str = env->GetStringUTFChars(jstr, NULL);
// do something
env->ReleaseStringUTFChars(jstr, str);

除了NewXXX,在栈内创建的对象,如果没有返回给java,也需要Delete,比如:

  • FindClass
  • NewString/ NewStringUTF/NewObject/NewByteArray
  • GetObjectField/GetObjectClass/GetObjectArrayElement
  • GetByteArrayElements/GetStringUTFChars

上面的代码也印证了,在java和native之间传递大量传递数据,并不是一个很明智的做法。因为JNI层必须拷贝一份后才能访问

我们可以把native的指针,保存在java的一个 long 类型的属性中,在需要的时候,调JNI的方法在native层去释放。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,530评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 86,403评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,120评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,770评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,758评论 5 367
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,649评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,021评论 3 398
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,675评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,931评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,659评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,751评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,410评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,004评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,969评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,042评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,493评论 2 343

推荐阅读更多精彩内容