在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, ©);
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++高级编程》