Android-NDK/JNI

NDK | 带你点亮 JNI 开发基石符文 (一)

2021-06-11  本文已影响0人  彭旭锐

点赞关注，不再迷路，你的支持对我意义重大！

🔥 Hi，我是丑丑。本文 GitHub · Android-NoteBook 已收录，这里有 Android 进阶成长路线笔记 & 博客，欢迎跟着彭丑丑一起成长。（联系方式在 GitHub）

前言

目录

前置知识

这篇文章的内容会涉及以下前置 / 相关知识，贴心的我都帮你准备好了，请享用~

1. 概述

1.1 JNI 解决了什么问题？

Java 设计 JNI 机制的目的是增强 Java 与本地代码交互的能力。 先说一下 Java 和本地代码的区别：我们知道程序的运行环境 / 平台主要是操作系统 + CPU，每个平台有自己的本地库和 CPU 指令集。像 C/C++ 这样的本地语言会变编译为依赖于特定平台的本地代码，不具备跨平台的性质。反观 Java，在虚拟机和字节码的加持下，Java 就具备了跨平台的性质，但换个角度看，却导致 Java 与本地代码交互的能力较弱，本地平台相关的特性无法充分发挥出来。因此，就有必要设计 JNI 机制来增强 Java 和本地代码交互的能力。

提示： 本地代码通常是 C/C++，但不限于 C/C++。

1.2 JNI 的优势

1.3 JNI 牺牲了什么？

2. 第一个 JNI 程序

本节我们通过一个简单的 HelloWorld 程序来展示 JNI 编程的基本流程。

2.1 JNI 编程的基本流程

源码不在这里展示了，你可以下载 Demo 查看，下载路径：HelloJni。这里只展示 JNI 函数声明：

JNIEXPORT void JNICALL Java_com_xurui_hellojni_HelloWorld_sayHi (JNIEnv *, jobject);

2.2 细节解释

下面，我总结了新手容易疑惑的几个问题：

#ifndef <宏>
#define <宏>
内容......
#endif

jni.h

struct JNIEnv_;
struct JavaVM_;

#ifdef __cplusplus
typedef JNIEnv_ JNIEnv;
typedef JavaVM_ JavaVM;
#else
typedef const struct JNINativeInterface_ *JNIEnv; // 结构体指针
typedef const struct JNIInvokeInterface_ *JavaVM; // 结构体指针
#endif

无论 C 还是 C++，最终调用到 C 的定义
struct JNIEnv_ {
    const struct JNINativeInterface_ *functions;

......
}

struct JavaVM_ {
    const struct JNIInvokeInterface_ *functions;

......
}

Windows 平台 :  
#define JNIEXPORT __declspec(dllexport)
#define JNIIMPORT __declspec(dllimport)

Linux 平台：
#define JNIIMPORT
#define JNIEXPORT  __attribute__ ((visibility ("default")))

Windows 平台 :  
#define JNICALL __stdcall // __stdcall 是一种函数调用参数的约定 ,表示函数的调用参数是从右往左。

Linux 平台：
#define JNICALL

问题 6：第一个参数 JNIEnv* 是什么？
答：第一个参数是 JNIEnv 指针，指向一个 JNI 函数表。通过这些 JNI 函数可以让本地代码访问 Java 虚拟机的内部数据结构。JNIEnv 指针还有一个作用，就是屏蔽了 Java 虚拟机的内部实现细节，使得本地代码库可以透明地加载到不同的 Java 虚拟机实现中去（牺牲了调用效率）。

问题 7：第二个参数 jobject 是什么？
答：第二个参数根据 native 方法是静态方法还是实例方法有所不同。对于静态 native 方法，第二个参数 jclass 代表 native 方法所在类的 Class 对象。对于实例 native 方法，第二个参数 jobject 代表调用 native 的对象。

2.3 类型的映射关系

Java 类型在 JNI 中都会映射为 JNI 类型，具体映射关系定义在 jni.h 文件中，jbyte, jint 和 jlong 和运行环境有关，定义在 jni_md.h 文件中。总结如下表：

Java 类型 JNI 类型 描述 长度（字节）
boolean jboolean unsigned char 1
char jchar unsigned short 2
short jshort signed short 2
float jfloat signed float 4
double jdouble signed double 8
int jint、jsize signed int 2 或 4
long jlong signed long 4 或 8（LP64）
byte jbyte signed char 1
Class jclass Java Class 类对象 /
String jstrting Java 字符串对象 /
Object jobject Java 对象 /
byte[] jbyteArray byte 数组 /

3. JNI 调用 Java 代码

这一节我们来讨论如何在 JNI 中访问 Java 字段和方法，在本地代码中访问 Java 代码，需要使用 ID 来访问字段或方法。频繁检索 ID 的过程相对耗时，通常我们还需要缓存 ID 来优化性能的方法。

3.1 JNI 访问 Java 字段

本地代码访问 Java 字段的流程分为两步：

需要注意：Ljava/lang/String;是实例字段name的字段描述符，严格来说，所谓「字段描述符」其实是 JVM 字节码中描述字段的规则，和 JNI 无直接关系。使用 javap 命令也可以自动生成字段描述符和方法描述符，Android Studio 也会帮助自动生成。完整的字段描述符规则如下表：

Java 类型 字段描述符
boolean Z
byte B
char C
short S
int I
long J
float F
double D
void V
引用类型 以 L 开头 ; 结尾，中间是 / 分隔的包名和类名。
例如 String 的字段描述符为 Ljava/lang/String;

Java 字段分为静态字段和实例字段，本地代码获取或修改 Java 字段主要是使用以下 6 个方法：

native-lib.cpp

extern "C"
JNIEXPORT void JNICALL
Java_com_xurui_hellojni_HelloWorld_accessField(JNIEnv *env, jobject thiz) {
    // 获取 jclass
    jclass clz = env->GetObjectClass(thiz);
    // 静态字段 ID
    jfieldID sFieldId = env->GetStaticFieldID(clz, "sName", "Ljava/lang/String;");
    // 访问静态字段
    if (sFieldId) {
        jstring jStr = static_cast<jstring>(env->GetStaticObjectField(clz, sFieldId));
        // 转换为 C 字符串
        const char *sStr = env->GetStringUTFChars(jStr, NULL);
        LOGD("静态字段：%s", sStr);
        env->ReleaseStringUTFChars(jStr, sStr);
        jstring newStr = env->NewStringUTF("静态字段 - Peng");
        if (newStr) {
            env->SetStaticObjectField(clz, sFieldId, newStr);
        }
    }
    // 实例字段 ID
    jfieldID mFieldId = env->GetFieldID(clz, "mName", "Ljava/lang/String;");
    // 访问实例字段
    if (mFieldId) {
        jstring jStr = static_cast<jstring>(env->GetObjectField(thiz, mFieldId));
        // 转换为 C 字符串
        const char *sStr = env->GetStringUTFChars(jStr, NULL);
        LOGD("实例字段：%s", sStr);
        env->ReleaseStringUTFChars(jStr, sStr);
        jstring newStr = env->NewStringUTF("实例字段 - Peng");
        if (newStr) {
            env->SetObjectField(thiz, mFieldId, newStr);
        }
    }
}

3.2 JNI 调用 Java 方法

本地代码访问 Java 方法与访问 Java 字段类似，访问流程分为两步：

需要注意：()V是实例方法helloJava的方法描述符，严格来说「方法描述符」是 JVM 字节码中描述方法的规则，和 JNI 无直接关系。

Java 方法分为静态方法和实例方法，本地代码调用 Java 方法主要是使用以下 5 个方法：

native-lib.cpp

extern "C"
JNIEXPORT void JNICALL
Java_com_xurui_hellojni_HelloWorld_accessMethod(JNIEnv *env, jobject thiz) {
    // 获取 jclass
    jclass clz = env->GetObjectClass(thiz);
    // 静态方法 ID
    jmethodID sMethodId = env->GetStaticMethodID(clz, "sHelloJava", "()V");
    if (sMethodId) {
        env->CallStaticVoidMethod(clz, sMethodId);
    }
    // 实例方法 ID
    jmethodID mMethodId = env->GetMethodID(clz, "helloJava", "()V");
    if (mMethodId) {
        env->CallVoidMethod(thiz, mMethodId);
    }
}

3.3 缓存 ID

使用时缓存：

使用时缓存是指在首次访问字段或方法时，将字段 ID 或方法 ID 存储在静态变量中。这样在将来再次调用本地方法时，就不需要重复检索 ID 了。例如：

jstring MyNewString(JNIEnv* env, jchar* chars, jint len) {
        // 静态字段
        static jmethodID cid = NULL;

        jclass stringClazz = (*env)->FindClass(env,"java/lang/String");
        if(NULL == cid) {
                cid = (*env)->GetMethodID(env,stringClazz,"<init>","([C)V");
        }
        jcharArray elemArr = (*env)->NewCharArray(env,len);
        (*env)->SetCharArrayRegion(env, elemArr, 0, len, chars);
        jstring result = (*env)->NewObject(env, stringClazz, cid, elemArr);
        (*env)->DeleteLocalRef(env,elemArr);
        (*env)->DeleteLocalRef(env,stringClazz);
        return result
}

提示： 多个线程访问这个本地方法，会使用相同的缓存 ID，会出现问题吗？不会，多个线程计算的字段 ID 或方法 ID 其实是相同的。

静态初始化时缓存：

静态初始化时缓存是指在 Java 类初始化的时候，提前缓存字段 ID 和方法 ID。例如：

private static native void initIDs();

static {
        // Java 类初始化
        System.loadLibrary("InstanceMethodCall");
        initIDs();
}
----------------------------------------------------
jmethodID cid;
jmethoidID stringId;

JNIEXPORT void JNICALL
Java_InstanceMethodCall_initIDs(JNIEnv *env, jclass cls) {
    cid = (*env)->GetMethodID(env, cls, "callback", "()V");
    jclass stringClazz = (*env)->FindClass(env,"java/lang/String");
    stringId = (*env)->GetMethodID(env,stringClazz,"<init>","([C)V");
}

3.4 两种缓存 ID 方式的对比和使用场景

在大多数情况下，应该尽可能在静态初始化时缓存字段 ID 和方法 ID，因为使用时缓存存在一些局限性：

当然，使用时缓存也不是一无是处。如果无法修改 Java 代码源码，使用时缓存是必然的选择。另一个优势在于，使用时缓存相当于懒初始化，可以按需检索 ID，而静态初始化时缓存相当于提前初始化，会一次性检索所有 ID。尽管如此，大多数情况下还是会使用静态初始化时缓存。

3.5 什么是 ID，什么是引用？

引用是通过本地代码来管理 JVM 中的资源，可以同时创建多个引用指向相同对象；而字段 ID 和方法 ID 由 JVM 管理，同一个字段或方法的 ID 是固定的，只有在所属类被卸载时会失效。

4. 加载 & 卸载 so 库的过程

关于加载与卸载 so 库的全过程，在我之前写过的一篇文章里讲过：《NDK | 说说 so 库从加载到卸载的全过程》。这里我简单复述下：

5. 注册 JNI 函数

关于 JNI 函数注册的方式和时机，在我之前写过的一篇文章里讲过：《NDK | 带你梳理 JNI 函数注册的方式和时机》。这里我简单复述下：

注册的时机 对应的注册方式
1、虚拟机第一次调用 native 方法时 静态注册
2、Android 虚拟机启动时 动态注册
3、加载 so 库时 动态注册

6. JNIEnv * 和 JavaVM

6.1 JNIEnv * 指针的作用

JNIEnv* 指针指向一个 JNI 函数表，在本地代码中，可以通过这些函数来访问 JVM 中的数据结构。从这个意义上说，可以理解为 JNIEnv* 指向了 Java 环境，但不能说 JNIEnv* 代表 Java 环境。

需要注意： 如果本地方法被不同的线程调用，传入的 JNIEnv 指针是不同的。JNIEnv 指针只在它所在的线程中有效，不能跨线程（甚至跨进程）传递和使用。但 JNIEnv 间接指向的函数表在多个线程间是共享的。

6.2 JavaVM 的作用

JavaVM 表示 Java 虚拟机，一个 Java 虚拟机对应一个 JavaVM 对象，这个对象是线程间共享的。我们可以通过 JNIEnv* 来获取一个 JavaVM 对象：

jint GetJavaVM(JNIEnv *env, JavaVM **vm);

- vm：用来存放获得的虚拟机的指针的指针；
- return：成功返回0，失败返回其它。

6.3 在任意位置获取 JNIEnv* 指针

JNIEnv* 指针仅在创建它的线程有效，如果我们需要在其他线程访问JVM，那么必须先调用 AttachCurrentThread 将当前线程与 JVM 进行关联，然后才能获得JNIEnv* 指针。另外，需要调用DetachCurrentThread 来解除链接。

jint AttachCurrentThread(JavaVM* vm , JNIEnv** env , JavaVMAttachArgs* args);

- vm：虚拟机对象指针；
- env：用来保存得到的 JNIEnv 指针的指针；
- args：链接参数，参数结构体如下所示；
- return：链接成功返回 0，连接失败返回其它。
-----------------------------------
func() {
    JNIEnv *env;
    (*jvm)->AttachCurrentThread(jvm, (void **)&env, NULL);
}

7. 总结

今天我们主要讨论了 JNI 编程的基本概念和使用步骤，也讨论了本地代码调用 Java 代码的步骤，也介绍了提高调用效率的方法 —— 缓存 ID。另外，关于 “加载 & 卸载 so 库的过程” 和 “JNI 函数注册的方式和时机” 我们去年已经讨论过了，希望能帮助你建立对 JNI 编程的系统认知。后面，我后续会发布更多文章来讨论 JNI 编程的高级概念，例如引用、多线程操作、异常处理等。记得关注~

参考资料

创作不易，你的「三连」是丑丑最大的动力，我们下次见！

上一篇 下一篇

猜你喜欢

热点阅读