【Android NDK 开发】JNI 引用 ( 弱全局引用 | NewWeakGlobalRef | DeleteWeakGlobalRef )

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

// 弱全局引用
//  访问时如果局部变量也有同名变量 , 可以使用 域作用符 访问
//  ::class_teacher_weak_global 表示访问全局的变量
jclass class_teacher_weak_global;
extern "C"
JNIEXPORT void JNICALL
Java_kim_hsl_jni_MainActivity_jniWeakGlobalReferenceTest(JNIEnv *env, jobject instance) {
    /*
        弱全局引用
        弱全局引用 与 Java 引用类似
        弱全局引用 作用域 :
            空间 : 都可以 跨方法 , 跨线程使用
            时间 : 创建弱全局引用后可以开始使用 , JVM 自动回收 或 手动释放 该弱全局引用不可用
        弱全局引用 与 全局引用 区别 :
            全局引用 : 不能被 回收 , 如果内存不足就 抛出异常
            弱全局引用 : 当内存不足时 , 会被系统自动回收
        弱全局引用 判定是否被回收 :
            使用 IsSameObject(弱引用变量 , NULL) 判断该对象是否被回收了 , 将其与 NULL 比较 , 即可判定
                返回 true ( 该对象与NULL相等 ) : 该若全局引用已经被释放
                返回 false ( 该对象与NULL不相等 ) : 还可以使用
     */
    // 1 . 获取 Teacher 类 ( 该变量需要释放 )
    //如果 class_teacher_weak_global 对象被回收 , 返回 true ; 没有被回收返回 false ;
    jboolean isClassReleased = env->IsSameObject(class_teacher_weak_global, NULL);
    if( class_teacher_weak_global == NULL || isClassReleased ) {
        //生成局部引用 , 该局部引用使用完毕后可释放
        jclass tmp_class = env->FindClass("kim/hsl/jni/Teacher");
        //将上述生成的局部引用变成弱全局引用
        //      弱全局引用释放时 , env->DeleteWeakGlobalRef(class_teacher_weak_global) 即可释放下面转换的弱全局引用
        class_teacher_weak_global = static_cast<jclass>(env->NewWeakGlobalRef(tmp_class));
        //将局部引用释放掉
        env->DeleteLocalRef(tmp_class);
    }
}