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

I . 弱全局引用

---

若全局引用 特点 : 弱全局引用 最大的特点是 可以被 JVM 自动回收 ;

弱全局引用 作用域 :

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

② 时间 : 创建弱全局引用后可以开始使用 , JVM 自动回收 或 手动释放 该弱全局引用不可用 ;

弱全局引用 与 全局引用 区别 :

① 全局引用 : 不能被 回收 , 如果内存不足就 抛出异常

② 弱全局引用 : 当内存不足时 , 会被系统自动回收

II . 弱全局引用判定是否被回收

---

弱全局引用 判定是否被回收 :

使用 IsSameObject(弱引用变量 , NULL) 判断该对象是否被回收了 , 将其与 NULL 比较 , 即可判定该若全局引用是否被 JVM 回收 ;

① 返回 true ( 该对象与NULL相等 ) : 该若全局引用已经被释放 ;

② 返回 false ( 该对象与NULL不相等 ) : 该弱全局引用还可以使用 ;

III . 弱全局引用 创建 与 删除 ( 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); }
    ...
}

① NewWeakGlobalRef : 传入局部变量作为参数 , 创建弱全局引用 ;

② DeleteWeakGlobalRef : 释放弱全局引用 ;

IV . 弱全局引用代码示例

---

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

    }

}