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

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); }
    ...
}

// 全局引用
//  访问时如果局部变量也有同名变量 , 可以使用 域作用符 访问
//  ::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);
    }
}