JNI数组操作

在JNI中，java的基本数据类型可以直接与jni基本类型映射，但数组作为引用类型不能直接使用和修改，JNI提供了一组访问和处理数组的API。

创建数组

使用New<Type>Array函数创建一个数组实例，其中Type为基本数据类型：Boolean、Byte、Char、Short、Int、Long、Float、Double，如NewIntArray。

jintArray array = env->NewIntArray(4);
    if (0 != array) {
        // 内存溢出的情况下，NewIntArray返回NULL
    }

访问和更新数组

JNI提供了两种访问数组的方法，一种是复制到c/c++数组中，一种是提供指向数组元素的指针。

方式一：复制到c数组

比如java的native传入了一个数组，我们在JNI中读取并更新这个数组，然后对应java的数组就改变了。我们通过复制到c数组的方式，其一般调用流程如下：

1. get array region

Get<Type>ArrayRegion函数会将给定的基本Java数组复制到C数组中

2. update c array

使用和修改c数组

3. set array region

当我们想把修改提交到提交给JNI数组从而改变对应的java数组时，可以使用Set<Type>ArrayRegion函数

示例

示例程序中传入了一个java float数组，我们在jni中通过这种方式改变数组的第二个值，执行完后java数组的第二个值会改变。
jni：

extern "C" JNIEXPORT void JNICALL
Java_smarttime_tsia_com_jnitest3_MainActivity_updateArray(
        JNIEnv* env, jobject obj, jfloatArray jnums) {
    // 获取数组长度
    jsize len = env->GetArrayLength(jnums);

    // JNI数组复制到c数组
    jfloat buffer[2];
    env->GetFloatArrayRegion(jnums, 0, len, buffer);

    // 更新c数组
    buffer[0] = 2.2f;

    // 将修改提交到JNI数组中
    env->SetFloatArrayRegion(jnums, 0, len, buffer);
}

java：

...
public void onClick(View v) {

    float[] nums = new float[]{1.f, 2.f};
    updateArray(nums);
}
native void updateArray(float[] nums);
...

当数组比较大的时候，可以只复制或更新关心的元素区间，以避免出现的性能问题。

方式二：直接指针的操作

一般调用流程：

1. get array elements

Get<Type>ArrayElements函数获取指向数组元素的直接指针，这个函数的最后一个参数是isCopy，让调用者确定返回的c指针是指向副本，还是指向堆中的固定对象。

2. update c array

使用和修改c数组

3. release array elements

使用完直接指针后需要立即释放，通过Release<Type>ArrayElements，否则会出现内存泄露

示例

以下代码同样会更新java数组的第二个元素：

extern "C" JNIEXPORT void JNICALL
Java_smarttime_tsia_com_jnitest3_MainActivity_updateArray(
        JNIEnv* env, jobject obj, jfloatArray jnums) {
    jboolean isCopy;
    // 获取直接指针
    jfloat *parray = env->GetFloatArrayElements(jnums, &copy);
    if (0==parray) {
        return;
    }

    // 更新c数组
    parray[1] = 2.2f;

    // 释放数组。注意：释放模式为0，java数组会修改；如果是JNI_ABORT，java的数组并不会被修改
    env->ReleaseFloatArrayElements(jnums, parray, 0);
}

释放模式

Release<Type>ArrayElements的最后一个参数mode为释放模式，其值和意义为：

• 0：c数组修改后，将其复制到jni数组，并释放c数组。
• JNI_COMMIT：c数组修改后，将其复制到jni数组，但不释放c数组。这种一般用于周期性的更新一个java数组。
• JNI_ABORT：c数组修改后，不将其复制到jni数组，并释放c数组。也就是上述例子设置JNI_ABORT的话，java的数组并不会被改变。

JNI_COMMIT不会释放数组，最终都需要调用0/JNI_ABORT参数来释放。

isCopy参数

Get<Type>ArrayElements的最后一个参数isCopy会告诉我们指针指向的是拷贝的副本，还是原始数据。
假如我们需要对一个jni数组临时改变一下，然后给其他方法用，但并不希望提交到java数组。这时我们可以通过isCopy判断如果是false说明是原始数据，那我们就需要拷贝一个副本用来修改，否则会修改java数组；假如是true，就不需要另外拷贝一个副本。

如果isCopy是false，仍然需要主动调用释放的方法，因为即使没有拷贝副本，原始数据也不会自动回收的。

参考：《Android c++高级编程》