JNI学习记录3-String and Array

JNI学习记录1-初建JNI工程
JNI学习记录2-local refence崩溃问题
JNI学习记录3-String and Array
JNI学习记录4-Fields
JNI学习记录5-Methods

一 、Summary of JNI String Functions

string.png

Choosing among the String Functions

choosing_string.png

• 对于小尺寸字串的操作，首选Get/SetStringRegion和Get/SetStringUTFRegion，因为栈上空间分配，开销要小的多
• GetStringCritical必须非常小心使用。你必须确保不分配新对象和任何阻塞系统的操作，以避免发生死锁。如下，因调用fprintf, 该c函数要执行IO操作，所以是不安全的。

二、Summary of JNI Primitive Array Functions

array.png

JNIEXPORT jint JNICALL
Java_IntArray_sumArray(JNIEnv env, jobject obj, jintArray arr)
{
jint buf[10];
jint i, sum = 0;
(env)->GetIntArrayRegion(env, arr, 0, 10, buf);
for (i = 0; i < 10; i++) {
sum += buf[i];
}
return sum;
}

• 使用GetIntArrayRegion拷贝数组内容到buf中，这里没有做越界异常检测，
  因为知道数组有10个，参数3为待拷贝数组的起始位置，参数4为拷贝元素的个数。
• JNI支持SetIntArrayRegion允许重新设置数组一个区域的值，其他基本类型(boolean,
  short, 和float)也有对应的支持。

JNIEXPORT jint JNICALL
Java_IntArray_sumArray(JNIEnv env, jobject obj, jintArray arr)
{
jint carr;
jint i, sum = 0;
carr = (env)->GetIntArrayElements(env, arr, NULL);
if (carr == NULL) {
return 0; / exception occurred /
}
for (i=0; i<10; i++) {
sum += carr[i];
}
(env)->ReleaseIntArrayElements(env, arr, carr, 0);
return sum;
}

• JNI支持通过Get/Release<Type>ArrayElemetns返回Java数组的一个拷贝(实现优良的VM，会返回指向Java数组的一个直接的指针，并标记该内存区域，不允许被GC)。

Choosing among the Primitive Array Functions

choosing_array.png

三、GlobalRef and LocalRef

• Java中有许多引用的概念，我们只关心GlobalRef和LocalRef两种。JNI编程很复杂，
  建议不要引入更多复杂的东西，正确、高效的实现功能就可以了。比如对引用来说，最好不要在JNI中考虑：虚引用和影子引用等复杂的东西。
• GlobalRef: 当你需要在JNI层维护一个Java对象的引用，而避免该对象被垃圾回收时，使用NewGlobalRef告诉VM不要回收此对象，当本地代码最终结束该对象的引用时，用DeleteGlobalRef释放之。
• LocalRef: 每个被创建的Java对象，首先会被加入一个LocalRef Table，这个Table大小是有限的，当超出限制，VM会报LocalRef Overflow Exception，然后崩溃. 这个问题是JNI编程中经常碰到的问题，请引起高度警惕，在JNI中及时通过DeleteLocalRef释放对象的LocalRef. JNI中提供了一套函数：Push/PopLocalFrame，因为LocalRefTable大小是固定的，这套函数只是执行类似函数调用时，执行的压栈操作，在LocalRefTable中预留一部分供当前函数使用，当你在JNI中产生大量对象时，虚拟机仍然会因LocalRef Overflow Exception崩溃，所以使用该套函数你要对LocalRef使用量有准确估计。