IntelliJ IDEA平台下JNI编程（三）—字符串、数组
转载请注明出处：【huachao1001的专栏：http://blog.csdn.net/huachao1001/article/details/54407327】
在前面HelloWorld篇中，自动生成的头文件对本地方法声明的形参列表中的第一个参数即为JNIEnv *。那么JNIEnv到底能用来做什么？初学JNI的时候并没有太在意，只满足于Java能调用C代码就行，而并没有深究。今天这篇文章将学习JNI本地函数中如何与Java代码中的字符串、数组相互访问（或转换）。通过这篇文章的学习，相信会对JNIEnv有进一步了解。
1. 从一个简单的例子开始
先创建一个Java类：com/huachao/java/HelloJNI.java，并声明本地方法：private native String sayHello(String name);
package com.huachao.java; /** * Created by HuaChao on 2017/01/13. */ public class HelloJNI { static { // hello.dll (Windows) or libhello.so (Unixes) System.loadLibrary("HelloJNI"); } private native String sayHello(String name); public static void main(String[] args) { // invoke the native method String rs= new HelloJNI().sayHello("HuaChao"); System.out.println("Java类收到来自JNI的返回："+rs); } }
编译一下，找到HelloJNI.class，点击右键，选择External Tools>Generate Header File，如下（这个过程有疑问的请先转移至《IntelliJ IDEA平台下JNI编程（一）—HelloWorld篇》）：
此时在jni目录中得到com_huachao_java_HelloJNI.h如下：
/* DO NOT EDIT THIS FILE - it is machine generated */ #include <jni.h> /* Header for class com_huachao_java_HelloJNI */ #ifndef _Included_com_huachao_java_HelloJNI #define _Included_com_huachao_java_HelloJNI #ifdef __cplusplus extern "C" { #endif /* * Class: com_huachao_java_HelloJNI * Method: sayHello * Signature: (Ljava/lang/String;)Ljava/lang/String; */ JNIEXPORT jstring JNICALL Java_com_huachao_java_HelloJNI_sayHello (JNIEnv *, jobject, jstring); #ifdef __cplusplus } #endif #endif
然后继续在jni目录中新建HelloJNI.c文件，如下：
#include<jni.h> #include <stdio.h> #include "com_huachao_java_HelloJNI.h" JNIEXPORT jstring JNICALL Java_com_huachao_java_HelloJNI_sayHello (JNIEnv *env, jobject thisObj, jstring name){ char buf[128]; /* ERROR: incorrect use of jstring as a char* pointer */ printf("Hello %s",name);//这里会出错 scanf("%s",buf); return buf;//这里出错，不能将char*作为jstring返回 }
同样，在HelloJNI.c上点击右键选择External Tools>Generate DLL（这个过程有疑问的请先转移至《IntelliJ IDEA平台下JNI编程（一）—HelloWorld篇》）。再点击运行，会发现错处！！！！主要是因为printf函数的第二个参数应当为char*类型，而不是jstring。那怎么样将jstring转为char*呢？这就需要借助JNIEnv*了。将HelloJNI.c改为如下：
#include<jni.h> #include <stdio.h> #include "com_huachao_java_HelloJNI.h" JNIEXPORT jstring JNICALL Java_com_huachao_java_HelloJNI_sayHello (JNIEnv *env, jobject thisObj, jstring name){ char buf[128]; const jbyte *str; str = (*env)->GetStringUTFChars(env, name, NULL); if (str == NULL) { return NULL; /* OutOfMemoryError already thrown */ } printf("Hello %s", str); (*env)->ReleaseStringUTFChars(env, name, str); /* 假设输入字符不超过127个 */ scanf("%s", buf); return (*env)->NewStringUTF(env, buf); }
在HelloJNI.c上点击右键选择External Tools>Generate DLL后，再运行HelloJNI.java类如下：
JNI_Return Java类收到来自JNI的返回：JNI_Return Hello HuaChao
可以看到，通过JNIEnv对象我们可以将jstring与char*相互转换。但需要注意的是，通过GetStringUTFChars函数将jsting转为char*时，有可能会从堆空间中分配新的空间，这就有可能因为内存不足而分配失败，因此需要判断是否为NULL。同时，当不需要时应当将这块新分配的空间释放，即调用ReleaseStringUTFChars函数。也可以在本地方法中构造一个java.lang.String实例对象，通过NewStringUTF函数来构造。
可能有人会问，为什么通过GetStringUTFChars得到的char*需要释放内存，而通过NewStringUTF得到的jstring对象不用释放内存呢？这是因为，使用GetStringUTFChars得到char*是在堆中开辟了新的空间用于存储字符串，用完肯定需要手动回收，因为JVM并不会帮你回收本地方法中开辟的空间。而使用NewStringUTF创建的jstring对象属于java.lang.String实例对象，虚拟机会自动回收，另外用于转换为jstring的char*对象（即例子中的buf）由于是函数内部的局部变量，当Java_com_huachao_java_HelloJNI_sayHello执行结束后，自然会回收其内部所有的局部变量的空间。
从上面结果可以看出，是先输入JNI中的scanf函数中的字符串，再打印Java类中传入的字符串。这个顺序好像跟代码顺序不一致，这具体原因我还不清楚，待查找到资料后再回来修改。
2. 字符串
除了上面小节中介绍的几个与字符串相关的函数以外，JNIEnv中还定义了很多其他的与字符串相关操作的函数。
通过GetStringChars函数得到的本地字符串（char*）是以Unicode编码的数据，我们知道UTF-8编码的字符串一般是以\0作为结束字符，但Unicode编码的字符串并不是这样。为了获取jstring类型引用的Unicode编码的字符串中字符数量，可以通过调用GetStringLength函数；而获取jstring引用的字符串有多少个字节则调用ANSI C语言中的strlen函数，或者是 JNIEnv的GetStringUTFLength函数。
我们看看 GetStringChars函数原型：
const jchar * GetStringChars(JNIEnv *env, jstring str, jboolean *isCopy);
如果返回的字符串是从原始的java.lang.String实例中拷贝的数据，则第三个参数isCopy指向的内存会被设置为 JNI_TRUE，反之，如果返回的字符串是通过直接指向java.lang.String实例中的内存空间，则isCopy指向的内存会被设置为JNI_FALSE。当isCopy指向的内存存储的是JNI_FALSE，那么不能对返回的char*中的内容进行修改，因为在Java中String是不可变的对象。
大部分情况下，直接将NULL作为isCopy参数，因为大部分情况都不需要关心JVM是从java.lang.String中拷贝的字符串还是直接将指针指向原始的字符串。
一般情况下，不可预测虚拟机是否采用拷贝java.lang.String实例。因此你需要假定GetStringChars函数花费时间和空间 来创建新的本地字符串（char*）。在JVM垃圾回收过程中，为了避免内存空间碎片化，对象可能需要发生移动。如果GetStringChars函数是通过直接将指针指向java.lang.String实例中的字符串，那么垃圾回收器则不再对java.lang.String实例对象进行移动，即java.lang.String实例对象被一直固定在内存的某一位置。如果过多的对象被固定在内存中而不被移动，则会导致有很多内存碎片。因此，每次调用GetStringChars函数时，JVM需要判断，决策是采用拷贝还是采用直接修改指针。
调用GetStringChars函数后，当你不再使用该字符串时，还需要记得调用ReleaseStringChars 。物理isCopy指向的内容是 JNI_TRUE还是JNI_FALSE，都应当调用ReleaseStringChars 。 如果GetStringChars采用的是拷贝方式，则ReleaseStringChars释放拷贝字符串占用的空间；如果GetStringChars是直接修改指针的方式，则将java.lang.String实例对象取消固定（即可被在内存中移动）。
3. 数组
3.1 基本类型数组
JNI将基本类型数组与对象数组区分对待，基本类型数组主要是元素为基本类型，对象数组元素是引用类型数组。如下：
int[] iarr; float[] farr; Object[] oarr; int[][] arr2;
iarr和farr是基本类型数组，而oarr和arr2是对象数组。
本地方法中访问基本类型数组就像访问字符串一样需要借助JNI中的函数，如下为一个简单的例子：对int数组元素求和：
class IntArray { private native int sumArray(int[] arr); public static void main(String[] args) { IntArray p = new IntArray(); int arr[] = new int[10]; for (int i = 0; i < 10; i++) { arr[i] = i; } int sum = p.sumArray(arr); System.out.println("sum = " + sum); } static { System.loadLibrary("IntArray"); } }
而在本地代码中，不能像如下代码那样：
/* 以下代码有错误 */ JNIEXPORT jint JNICALL Java_IntArray_sumArray(JNIEnv *env, jobject obj, jintArray arr) { int i, sum = 0; for (i = 0; i < 10; i++) { sum += arr[i]; } }
上面代码是有问题的，你必须使用JNI函数来访问基本来下数组中的元素，如下所示：
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 函数来复制数组中的元素到C语言中的缓存中（buf），其中第三个参数表示起始下标，第四个参数表示复制的元素个数。 只要元素拷贝到C缓存中，本地代码就可以直接使用缓存中的数组了。 前面例子中没有异常检查，这是因为我们知道数组长度是10，所有不会越界。
JNI支持一套数组的Get和Set函数==> Get/Release<Type>ArrayElements （如： Get/ReleaseIntArrayElements），用于本地代码直接获取基本类型数组的指针。由于垃圾回收器的底层实现可能不支持数组对象在内存中固定不动，所以在垃圾回收过程中数组在内存位置发生变化，JVM返回的指针是原始的基本类型数组的拷贝的地址。 上面代码可以改为如下：
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; }
GetArrayLength 函数返回数组中的元素个数，数组的固定长度在第一次分配内存时确定。函数 Get/ReleasePrimitiveArrayCritical允许虚拟机在访问原始数组时禁用垃圾回收器。你应该像使用 Get/ReleaseStringCritical一样小心地使用Get/ReleasePrimitiveArrayCritical。在Get/ReleasePrimitiveArrayCritical之间的代码必须不能调用任何JNI函数或执行任何阻塞操作，因为这可能会导致应用死锁。
一般使用Get/Release<type>ArrayElements都是安全的，虚拟机要么直接返回数组元素的指针，幺妹返回数组元素拷贝后的地址指针。
3.2 对象数组
函数GetObjectArrayElement返回指定下标的元素，而 SetObjectArrayElement函数更新指定下包的元素。不像基本类型数组，我们无法一次性获取所有的对象数组中的元素或者是拷贝多个元素。字符串和数组都是引用类型，可以通过 Get/SetObjectArrayElement来访问数组中的字符串和数组中的数组。 如下代码示例为本地方法创建二维int数组后返回到Java代码中，并且打印该二维数组数组内容：
class ObjectArrayTest { private static native int[][] initInt2DArray(int size); public static void main(String[] args) { int[][] i2arr = initInt2DArray(3); for (int i = 0; i < 3; i++) { for (int j = 0; j < 3; j++) { System.out.print(" " + i2arr[i][j]); } System.out.println(); } } static { System.loadLibrary("ObjectArrayTest"); } }
对应的本地代码实现如下：
JNIEXPORT jobjectArray JNICALL Java_ObjectArrayTest_initInt2DArray(JNIEnv *env, jclass cls, int size) { jobjectArray result; int i; jclass intArrCls = (*env)->FindClass(env, "[I"); if (intArrCls == NULL) { return NULL; /* exception thrown */ } result = (*env)->NewObjectArray(env, size, intArrCls, NULL); if (result == NULL) { return NULL; /* out of memory error thrown */ } for (i = 0; i < size; i++) { jint tmp[256]; /* make sure it is large enough! */ int j; jintArray iarr = (*env)->NewIntArray(env, size); if (iarr == NULL) { return NULL; /* out of memory error thrown */ } for (j = 0; j < size; j++) { tmp[j] = i + j; } (*env)->SetIntArrayRegion(env, iarr, 0, size, tmp); (*env)->SetObjectArrayElement(env, result, i, iarr); (*env)->DeleteLocalRef(env, iarr); } return result; }
本地方法中，先调用了JNI函数FindClass来获取二维数组中元素类型（Class）的引用，上一章中我们介绍过类型映射，我们知道[I表示的是Java中int[]对象的类型。如果FindClass返回NULL，说明类加载失败（可能是因为类文件不存在或者是OOM）。接下来NewObjectArray 函数分配一个数组，其元素类型为intArrCls只向的引用类型。NewObjectArray 函数只能分配一维数组，我们将一维数组作为其元素类型，这样就构成了二维数组。JVM并没有指定多维数组的数据结构，二维数组只是元素类型为数组的数组。
运行结果如下:
0 1 2 1 2 3 2 3 4
上面例子中最外面的循环后面调用了DeleteLocalRef ,这是为了防止虚拟机一直持有JNI中的引用（如例子中的iarr）导致OOM。
