Android JNI 数组操做

时间  2019-11-16
标签 android jni 数组 栏目 Android 繁體版
原文   原文链接

JNI 中有两种数组操做，基础数据类型数组和对象数组，JNI 对待基础数据类型数组和对象数组是不同的。java

基本数据类型数组

对于基本数据类型数组，JNI 都有和 Java 相对应的结构，在使用起来和基本数据类型的使用相似。git

在 Android JNI 基础知识篇提到了 Java 数组类型对应的 JNI 数组类型。好比，Java int 数组对应了 jintArray，boolean 数组对应了 jbooleanArray。github

如同 String 的操做同样，JNI 提供了对应的转换函数：GetArrayElements、ReleaseArrayElements。数组

intArray = env->GetIntArrayElements(intArray_, NULL);
    env->ReleaseIntArrayElements(intArray_, intArray, 0);

另外，JNI 还提供了以下的函数：微信

  • GetTypeArrayRegion / SetTypeArrayRegion

将数组内容复制到 C 缓冲区内，或将缓冲区内的内容复制到数组上。函数

  • GetArrayLength

获得数组中的元素个数，也就是长度。spa

  • NewTypeArray

返回一个指定数据类型的数组，而且经过 SetTypeArrayRegion 来给指定类型数组赋值。指针

  • GetPrimitiveArrayCritical / ReleasePrimitiveArrayCritical

如同 String 中的操做同样，返回一个指定基础数据类型数组的直接指针，在这两个操做之间不能作任何阻塞的操做。code

实际操做以下：对象

// Java 传递 数组 到 Native 进行数组求和
    private native int intArraySum(int[] intArray, int size);

对应的 C++ 代码以下：

JNIEXPORT jint JNICALL
Java_com_glumes_cppso_jnioperations_ArrayTypeOps_intArraySum(JNIEnv *env, jobject instance,
                                                             jintArray intArray_, jint num) {
    jint *intArray;
    int sum = 0;
    // 操做方法一：
    // 如同 getUTFString 同样，会申请 native 内存
    intArray = env->GetIntArrayElements(intArray_, NULL);
    if (intArray == NULL) {
        return 0;
    }
    // 获得数组的长度
    int length = env->GetArrayLength(intArray_);
    LOGD("array length is %d", length);
    for (int i = 0; i < length; ++i) {
        sum += intArray[i];
    }
    LOGD("sum is %d", sum);

    // 操做方法二：
    jint buf[num];
    // 经过 GetIntArrayRegion 方法来获取数组内容
    env->GetIntArrayRegion(intArray_, 0, num, buf);
    sum = 0;
    for (int i = 0; i < num; ++i) {
        sum += buf[i];
    }
    LOGD("sum is %d", sum);
    // 使用完了别忘了释放内存
    env->ReleaseIntArrayElements(intArray_, intArray, 0);
    return sum;
}

假如须要从 JNI 中返回一个基础数据类型的数组，对应的代码以下：

// 从 Native 返回基本数据类型数组
    private native int[] getIntArray(int num);

对应的 C++ 代码以下：

/**
 * 从 Native 返回 int 数组，主要调用 set<Type>ArrayRegion 来填充数据，其余数据类型相似操做
 */
extern "C"
JNIEXPORT jintArray JNICALL
Java_com_glumes_cppso_jnioperations_ArrayTypeOps_getIntArray(JNIEnv *env, jobject instance,
                                                             jint num) {
    jintArray intArray;
    intArray = env->NewIntArray(num);

    jint buf[num];
    for (int i = 0; i < num; ++i) {
        buf[i] = i * 2;
    }

    // 使用 setIntArrayRegion 来赋值
    env->SetIntArrayRegion(intArray, 0, num, buf);
    return intArray;
}

以上例子，基本把相关的操做都使用上了，能够发现和 String 的操做大都是类似的。

对象数组

对于对象数组，也就是引用类型数组，数组中的每一个类型都是引用类型，JNI 只提供了以下函数来操做。

  • GetObjectArrayElement / SetObjectArrayElement

和基本数据类型不一样的是，不能一次获得数据中的全部对象元素或者一次复制多个对象元素到缓冲区。只能经过上面的函数来访问或者修改指定位置的元素内容。

字符串和数组都是引用类型，所以也只能经过上面的方法来访问。

例如在 JNI 中建立一个二维的整型数组并返回：

// 从 Native 返回二维整型数组，至关因而一个一维整型数组，数组中的每一项内容又是数组
    private native int[][] getTwoDimensionalArray(int size);

二维数组具备特殊性在于，能够将它当作一维数组，其中数组的每项内容又是一维数组。

具体 C++ 代码以下：

/**
 * 从 Native 返回一个二维的整型数组
 */
extern "C"
JNIEXPORT jobjectArray JNICALL
Java_com_glumes_cppso_jnioperations_ArrayTypeOps_getTwoDimensionalArray(JNIEnv *env,
                                                                        jobject instance,
                                                                        jint size) {
    // 声明一个对象数组
    jobjectArray result;
    // 找到对象数组中具体的对象类型,[I 指的就是数组类型
    jclass intArrayCls = env->FindClass("[I");

    if (intArrayCls == NULL) {
        return NULL;
    }
    // 至关于初始化一个对象数组，用指定的对象类型
    result = env->NewObjectArray(size, intArrayCls, NULL);

    if (result == NULL) {
        return NULL;
    }
    for (int i = 0; i < size; ++i) {
        // 用来给整型数组填充数据的缓冲区
        jint tmp[256];
        // 声明一个整型数组
        jintArray iarr = env->NewIntArray(size);
        if (iarr == NULL) {
            return NULL;
        }
        for (int j = 0; j < size; ++j) {
            tmp[j] = i + j;
        }
        // 给整型数组填充数据
        env->SetIntArrayRegion(iarr, 0, size, tmp);
        // 给对象数组指定位置填充数据，这个数据就是一个一维整型数组
        env->SetObjectArrayElement(result, i, iarr);
        // 释放局部引用
        env->DeleteLocalRef(iarr);
    }
    return result;
}

首先须要使用 NewObjectArray 方法来建立对象数组。

而后使用 SetObjectArrayElement 函数填充数据时，须要构建好每一个位置对应的对象。这里就使用了 NewIntArray 来创造了一个对象，并给对象填充数据后，在赋值给对象数组。

经过一个 for 循环就完成给对象数组赋值的操做。

在建立对象数组时，有一个操做是找到对应的对象类型，经过 findClass 方法。findClass 的参数 [I 这里就涉及到 Java 与 JNI 对应签名的转换。

Java 与 JNI 签名的转换

在前一篇文章中，用表格列出了 Java 与 JNI 对应的数据类型格式的转换关系，如今要列举的是 Java 与 JNI 对应签名的转换关系。

这里的签名指的是在 JNI 中去查找 Java 中对应的数据类型、对应的方法时，须要将 Java 中的签名转换成 JNI 所能识别的。

对于类的签名转换

对于 Java 中类或者接口的转换，须要用到 Java 中类或者接口的全限定名，把 Java 中描述类或者接口的 . 换成 / 就行了，好比 String 类型对应的 JNI 描述为：

java/lang/String     // . 换成 /

对于数组类型，则是用 [ 来表示数组，而后跟一个字段的签名转换。

[I         // 表明一维整型数组，I 表示整型
[[I        // 表明二维整型数组
[Ljava/lang/String;      // 表明一维字符串数组，
对于字段的签名转换

对应基础类型字段的转换：

Java 类型 JNI 对应的描述转
boolean Z
byte B
char C
short S
int I
long J
float F
double D

对于引用类型的字段签名转换，是大写字母 L 开头，而后是类的签名转换，最后以 ; 结尾。

Java 类型 JNI 对应的描述转换
String Ljava/lang/String;
Class Ljava/lang/Class;
Throwable Ljava/lang/Throwable
int[] "[I"
Object[] "[Ljava/lang/Object;"
对于方法的签名转换

对于方法签名描述的转换，首先是将方法内全部参数转换成对应的字段描述，并所有写在小括号内，而后在小括号外再紧跟方法的返回值类型描述。

Java 类型 JNI 对应的描述转换
String f(); ()Ljava/lang/String;
long f(int i, Class c); (ILjava/lang/Class;)J
String(byte[] bytes); ([B)V

这里要注意的是在 JNI 对应的描述转换中不要出现空格。

了解并掌握这些转换后，就能够进行更多的操做了，实现 Java 与 C++ 的相互调用。

好比，有一个自定义的 Java 类，而后再 Native 中打印类的对象数组的某一个字段值。

private native void printAnimalsName(Animal[] animal);

具体 C++ 代码以下：

/**
 * 打印对象数组中的信息
 */
extern "C"
JNIEXPORT void JNICALL
Java_com_glumes_cppso_jnioperations_ArrayTypeOps_printAnimalsName(JNIEnv *env, jobject instance,
                                                                  jobjectArray animals) {
    jobject animal;
    // 数组长度
    int size = env->GetArrayLength(animals);
    // 数组中对应的类
    jclass cls = env->FindClass("com/glumes/cppso/model/Animal");
    // 类对应的字段描述
    jfieldID fid = env->GetFieldID(cls, "name", "Ljava/lang/String;");
    // 类的字段具体的值
    jstring jstr;
    // 类字段具体值转换成 C/C++ 字符串
    const char *str;

    for (int i = 0; i < size; ++i) {
        // 获得数组中的每个元素
        animal = env->GetObjectArrayElement(animals, i);
        // 每个元素具体字段的值
        jstr = (jstring) (env->GetObjectField(animal, fid));
        str = env->GetStringUTFChars(jstr, NULL);
        if (str == NULL) {
            continue;
        }
        LOGD("str is %s", str);
        env->ReleaseStringUTFChars(jstr, str);
    }
}

具体示例代码可参考个人 Github 项目，欢迎 Star。

https://github.com/glumes/AndroidDevWithCpp

欢迎关注微信公众号：【纸上浅谈】，得到最新文章推送~~

扫码关注

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程