[NDK/JNI系列05] JNI引用API

#include <jni.h>
#include <string>
#include <android/log.h>
 
#define  LOG_TAG    "Chapter05-JNI"
#define  LOGD(...)  __android_log_print(ANDROID_LOG_DEBUG,LOG_TAG,__VA_ARGS__)
#define  LOGE(...)  __android_log_print(ANDROID_LOG_ERROR,LOG_TAG,__VA_ARGS__)
 
using namespace chapter05; // 使用chapter05命名空间
 
// 定义一些常量，表示类名和方法签名
const char* STRING_CLASS = "java/lang/String";
const char* OBJECT_CLASS = "java/lang/Object";
 
// 定义一些全局变量，表示全局引用和弱全局引用
jobject globalRef = NULL; // 全局引用
jweak weakGlobalRef = NULL; // 弱全局引用
 
// 定义一个辅助函数，用于检查并打印JNI异常
void checkAndPrintException(JNIEnv *env) {
    jthrowable exception = env->ExceptionOccurred(); // 检查是否发生了Java异常
    if (exception != NULL) {
        env->ExceptionDescribe(); // 打印Java异常的堆栈跟踪信息
    }
}
 
// 定义一个测试函数，用于演示JNI引用API的使用
jobject testReferenceAPI(JNIEnv *env) {
    // 创建一个字符串对象
    jstring str = env->NewStringUTF("测试对象引用-obj");
    checkAndPrintException(env);
 
    // 如果全局引用为空，就创建一个全局引用
    if (globalRef == NULL) {
        globalRef = env->NewGlobalRef(str);
        checkAndPrintException(env);
        LOGD("创建了一个全局引用");
    } else {
        LOGD("全局引用已存在");
    }
 
    // 如果弱全局引用为空，就创建一个弱全局引用
    if (weakGlobalRef == NULL) {
        weakGlobalRef = env->NewWeakGlobalRef(str);
        checkAndPrintException(env);
        LOGD("创建了一个弱全局引用");
    } else {
        LOGD("弱全局引用已存在");
    }
 
    // 检查全局引用是否有效
    jboolean isGlobalRefValid = env->IsSameObject(globalRef, NULL);
    if (isGlobalRefValid == JNI_FALSE) {
        LOGD("全局引用有效");
    } else {
        LOGD("全局引用无效");
    }
 
    // 检查弱全局引用是否有效
    jboolean isWeakGlobalRefValid = env->IsSameObject(weakGlobalRef, NULL);
    if (isWeakGlobalRefValid == JNI_FALSE) {
        LOGD("弱全局引用有效");
    } else {
        LOGD("弱全局引用无效");
    }
 
    // 为即将创建的局部引用预留空间
    env->PushLocalFrame(16);
    checkAndPrintException(env);
 
    // 创建一个对象数组，用于存放局部引用
    jobjectArray localRefs = env->NewObjectArray(10, env->FindClass(OBJECT_CLASS), NULL);
    checkAndPrintException(env);
 
    // 创建一些对象，并将它们作为局部引用添加到数组中
    for (int i = 0; i < 10; i++) {
        jobject obj = env->NewStringUTF("Object");
        checkAndPrintException(env);
        env->SetObjectArrayElement(localRefs, i, obj);
        checkAndPrintException(env);
        env->DeleteLocalRef(obj); // 删除不再使用的局部引用
        checkAndPrintException(env);
    }
 
    // 获取数组中的第一个元素，并创建一个新的局部引用
    jobject firstElement = env->GetObjectArrayElement(localRefs, 0);
    checkAndPrintException(env);
    jobject newLocalRef = env->NewLocalRef(firstElement);
    checkAndPrintException(env);
 
    // 比较两个局部引用是否指向同一个对象
    jboolean isSameObject = env->IsSameObject(firstElement, newLocalRef);
    if (isSameObject == JNI_TRUE) {
        LOGD("两个局部引用指向同一个对象");
    } else {
        LOGD("两个局部引用指向不同对象");
    }
 
    // 销毁创建的局部引用，并返回一个全局引用作为结果
    return env->PopLocalFrame(globalRef);
}
 
extern "C" JNIEXPORT jstring JNICALL
Java_com_ln28_jnidemo_Chapter05_stringFromJNI( // 修改函数名前缀，与Chapter05.kt中对应
        JNIEnv* env,
        jobject /* this */) {
    std::string hello = "Hello from C++";
    return env->NewStringUTF(hello.c_str());
}
 
extern "C" JNIEXPORT jobject JNICALL
Java_com_ln28_jnidemo_Chapter05_testReferenceAPI( // 修改函数名前缀，与Chapter05.kt中对应
        JNIEnv* env,
        jobject /* this */) {
    return testReferenceAPI(env);
}

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import android.util.Log
import android.widget.TextView
import com.ln28.jnidemo.databinding.ActivityMainBinding
import com.ln28.jnidemo.databinding.Chapter05Binding
class Chapter05 : AppCompatActivity() {
    // 定义一个原生方法，用于调用测试函数
    external fun testReferenceAPI(): Any // 原生方法：测试引用类型的API调用
 
    var TAG = "Chapter05"; // 定义TAG变量用于日志输出
 
    private lateinit var binding: Chapter05Binding
 
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        this.setTitle("Chapter05")
        binding = Chapter05Binding.inflate(layoutInflater)
        setContentView(binding.root)
 
        // Example of a call to a native method
        binding.sampleText.text = stringFromJNI() // 调用原生方法，返回字符串，并显示在UI中
 
        // 调用测试函数并打印结果
        val result = testReferenceAPI() // 调用原生方法获取引用类型的API调用结果
        printObject(result) // 调用普通方法打印对象信息
    }
 
    // 定义一个普通方法，用于打印对象信息
    fun printObject(obj: Any) {
        Log.d(TAG, "对象为：$obj")
        Log.d(TAG, "对象的类为：${obj.javaClass}")
        Log.d(TAG, "对象的哈希码为：${obj.hashCode()}")
    }
 
    /**
     * 一个由本应用程序打包的 'jnidemo' native库实现的原生方法。
     */
    external fun stringFromJNI(): String // 原生方法：获取一个字符串
 
    companion object {
        // 用于在应用程序启动时加载 'jnidemo' 库。
        init {
            System.loadLibrary("jnidemo")
        }
    }
}

jobjectArray array = /* a large Java array */;
int len = (*env)->GetArrayLength(env, array);
for (int i = 0; i < len; i++) {
    (*env)->PushLocalFrame(env, 1);
    jobject element = (*env)->GetObjectArrayElement(env, array, i);
    // do something with element
    (*env)->PopLocalFrame(env, NULL);
}