本文共 2369 字,大约阅读时间需要 7 分钟。
JNI把Java字符串当成引用类型来处理,JNI提供了java字符串与C字符串之间相互转换的必要函数。因为java字符串对象是不可变的,因此JNI不提供任何修改现有的java字符串内容的函数。
可以在原生代码中用NewString函数构建Unicode编码格式的字符串实例,用NewStringUTF函数构建UTF-8编码格式的字符串实例。
例如:下面的函数以一个C字符串为参数,并返回一个Java字符串引用类型jstring值。
jstring javastring;javastring = (*env)->NewStringUTF(env, "I LOVE YOU UU!");
注意,在内存溢出的情况下,NewString函数将返回NULL以通知原生代码虚拟机中有异常抛出。
为了在原生代码中使用java字符串,需要先将java字符串转换成C字符串,我们使用GetStringChars函数可以将Unicode格式的java字符串转换成C字符串,使用GetStringUTFChars函数可以将UTF-8格式的Java字符串转换成C字符串。
这些函数的第三个参数均为可选参数,该可选参数名是isCopy,它让调用者确定返回的C字符串地址指向副本还是指向堆中的固定对象。例如:
const jbyte* str;jboolean isCopy;str = (*env)->GetStringUTFChars(env, javaString,&isCopy);if(0 != str){ printf("java String: %s",str); if(JNI_TRUE == isCopy){ printf("C String is a copy of the java String"); }else{ printf("C String points to actual String"); }}
通过JNI GetStringChars函数及GetStringUTFChars函数获得的C字符串在原生代码中使用完成之后需要正确的释放,否则将会引起内存泄漏。通常我们使用ReleaseStringChars函数释放Unicode格式的字符串,使用ReleaseUTFStringChars函数释放UTF-8格式的字符串。
(*env)->ReleaseUTFStringChars(env,javaString,str);
JNI把java数组当成引用类型来处理,JNI提供必要的函数访问和处理Java数组。
创建数组用NewArray函数在原生代码中创建数组实例,其中可以是Int、Char和Boolean等。例如:
jintArray javaArray;javaArray = (*env)->NewIntArray(env,10);if(0 != javaArray){/*数组使用……*/}
注意,在内存溢出的情况下,NewArray函数将返回NULL以通知原生代码虚拟机中有异常抛出。
JNI提供两种访问java数组元素的方法,可以将数组的代码赋值成C数组或者让JNI提供直接执行数组元素的指针。
GetArrayRegion函数将给定的基本Java数组赋值到给对你给的C数组中,例如:
jint nativeArray[10];(*evn)->GetIntArrayRegion(env,javaArray,0,10,nativeArray);
原生代码可以像使用普通的C数组一样使用和修改数组元素。当原生代码想将所做的修改提交给java数组时,可以使用SetArrayRegion函数将C数组复制回java数组中。例如:
(*env)->SetIntArrayRegion(env,javaArray,0,10,nativeArray);
注意:当数组很大时,对数组做复制操作会引起性能问题。
原生代码可以使用GetArrayElements函数获取执行数组元素的直接指针。例如:
jint nativeDirectArray;jboolean isCopy;nativeDirectArray = (*env)->GetIntArrayElements(env,javaArray,&isCopy);
其中,第三个&isCopy参数为可选参数,让调用者确定返回的C字符串地址指向副本还是指向堆中的固定对象。
因为可以像普通的C数组一样访问和处理数组元素,因此JNI没提供访问和处理数组元素的方法,JNI要求原生代码用完这些指针后立刻释放,否则会出现内存溢出。可以使用JNI提供的ReleaseArrayElements函数释放GetArrayElements返回的C数组。例如:
(*env)->ReleaseIntArrayRegion(env,javaArray,nativeDirectArray,0);
其中第四个参数是释放模式。
0 将内容复制回来并释放原生数组。
JNI_COMMIT 将内容复制回来但是不释放原生数组,一般用于周期性的更新一个java数组。 JNI_ABORT 释放原生数组但不用将内容复制回来。表格如下:
释放模式 | 动作 |
---|---|
0 | 将内容复制回来并释放原生数组 |
JNI_COMMIT | 将内容复制回来但是不释放原生数组,一般用于周期性的更新一个java数组 |
JNI_ABORT | 释放原生数组但不用将内容复制回来 |
转载地址:http://rauhj.baihongyu.com/