【Android NDK 开发】JNI 引用 ( 全局引用 | NewGlobalRef | DeleteGlobalRef )

I . 全局引用

---

1 . 全局引用作用域 :

与局部引用对比 : 全局引用与局部引用相对应 , 其作用域是全局的 , 局部引用只能在当前方法使用 ;

空间 : 可以 跨方法 , 跨线程使用 ;

时间 : 创建后可以使用 , 手动释放后全局引用失效 ; ( 手动释放前全局可用 )

2 . 全局引用 内存回收 : 全局引用 与 局部引用 均不会被 JVM 自动回收 , 如果内存不足 , JVM 宁可抛出 OOM 异常 , 也不会回收这些内存 ;

3 . 全局引用相关方法 :

① 创建全局引用 : NewGlobalRef ;

② 释放全局引用 : DeleteGlobalRef ;

II . 创建全局引用 ( NewGlobalRef )

---

1 . 函数原型 : 传入一个局部引用参数 , 将局部引用转为全局引用 ;

返回值 : 由局部引用转换成的全局引用 ;

参数 :

• jobject obj : 使用 NewXXX / FindXXX 等 大多数 JNI 方法 默认创建的 Java 引用类型对象 都是局部引用 ;

struct _JNIEnv {
    /* _JNIEnv  结构体中封装了 JNINativeInterface 结构体指针 */
    const struct JNINativeInterface* functions;
    ...
    // 最终 调用的 还是 JNINativeInterface 结构体中封装的 NewGlobalRef 方法
    jobject NewGlobalRef(jobject obj)
    { return functions->NewGlobalRef(this, obj); }
    ...
}

III . 全局引用代码示例

---

全局引用代码示例:

// 全局引用
//  访问时如果局部变量也有同名变量 , 可以使用 域作用符 访问
//  ::class_teacher 表示访问全局的变量
jclass class_teacher_global;

extern "C"
JNIEXPORT void JNICALL
Java_kim_hsl_jni_MainActivity_jniGlobalReferenceTest(JNIEnv *env, jobject instance) {

    /*
        全局引用 作用域 :
                空间 : 可以 跨方法 , 跨线程使用
                时间 : 创建后可以使用 , 手动释放后全局引用失效

        全局引用创建 : NewGlobalRef

        全局引用释放 : DeleteGlobalRef

        全局引用会阻止 JVM 回收该引用


        这里注意域作用符的使用 , 本方法中没有 class_teacher_global 同名变量 , :: 可用 可 不用
     */

    // 1 . 获取 Teacher 类 ( 该变量需要释放 )
    if(::class_teacher_global == NULL) {

        //生成局部引用 , 该局部引用使用完毕后可释放
        jclass tmp_class = env->FindClass("kim/hsl/jni/Teacher");

        //将上述生成的局部引用变成 全局引用
        //      全局引用释放时 , env->DeleteGlobalRef(class_teacher_global) 即可释放下面转换的 全局引用
        ::class_teacher_global = static_cast<jclass>(env->NewGlobalRef(tmp_class));

        //将局部引用释放掉
        env->DeleteLocalRef(tmp_class);

    }
}