JNI/NDK開發指南（五）——訪問數組（基本類型數組與對象數組），jnindk

JNI/NDK開發指南（五）——訪問數組（基本類型數組與對象數組），jnindk

          轉載請註明出處：http://blog.csdn.net/xyang81/article/details/42346165

         JNI中的數組分為基本類型數組和對象數組，它們的處理方式是不一樣的，基本類型數組中的所有元素都是JNI的基礎資料型別 (Elementary Data Type)，可以直接存取。而對象數組中的所有元素是一個類的執行個體或其它數組的引用，和字串操作一樣，不能直接存取Java傳遞給JNI層的數組，必須選擇合適的JNI函數來訪問和設定Java層的數組對象。閱讀此文假設你已經瞭解了JNI與Java資料類型的映射關係，如果還不瞭解的童鞋，請移步《JNI/NDK開發指南（三）——JNI資料類型及與Java資料類型的映射關係》閱讀。下面以int類型為例說明基礎資料型別 (Elementary Data Type)數組的訪問方式，對象數群組類型用一個建立二維數組的例子來示範如何訪問：

一、訪問基本類型數組

package com.study.jnilearn;// 訪問基本類型數組public 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 < arr.length; i++) {arr[i] = i;}int sum = p.sumArray(arr);System.out.println("sum = " + sum);}static {System.loadLibrary("IntArray");}}

本地代碼：

/* DO NOT EDIT THIS FILE - it is machine generated */#include <jni.h>/* Header for class com_study_jnilearn_IntArray */#ifndef _Included_com_study_jnilearn_IntArray#define _Included_com_study_jnilearn_IntArray#ifdef __cplusplusextern "C" {#endif/* * Class:     com_study_jnilearn_IntArray * Method:    sumArray * Signature: ([I)I */JNIEXPORT jint JNICALL Java_com_study_jnilearn_IntArray_sumArray  (JNIEnv *, jobject, jintArray);#ifdef __cplusplus}#endif#endif// IntArray.c#include "com_study_jnilearn_IntArray.h"#include <string.h>#include <stdlib.h>/* * Class:     com_study_jnilearn_IntArray * Method:    sumArray * Signature: ([I)I */JNIEXPORT jint JNICALL Java_com_study_jnilearn_IntArray_sumArray(JNIEnv *env, jobject obj, jintArray j_array){    jint i, sum = 0;    jint *c_array;    jint arr_len;    //1. 擷取數組長度    arr_len = (*env)->GetArrayLength(env,j_array);    //2. 根據數組長度和數組元素的資料類型申請存放java數組元素的緩衝區    c_array = (jint*)malloc(sizeof(jint) * arr_len);    //3. 初始化緩衝區    memset(c_array,0,sizeof(jint)*arr_len);    printf("arr_len = %d ", arr_len);    //4. 拷貝Java數組中的所有元素到緩衝區中    (*env)->GetIntArrayRegion(env,j_array,0,arr_len,c_array);    for (i = 0; i < arr_len; i++) {        sum += c_array[i];  //5. 累加數組元素的和    }    free(c_array);  //6. 釋放儲存數組元素的緩衝區    return sum;}

上例中，在Java中定義了一個sumArray的native方法，參數類型是int[]，對應JNI中jintArray類型。在本地代碼中，首先通過JNI的 GetArrayLength函數擷取數組的長度，已知數組是jintArray類型，可以得出數組的元素類型是jint，然後根據數組的長度和數組元素類型，申請相應大小的緩衝區。如果緩衝區不大的話，當然也可以直接在棧上申請記憶體，那樣效率更高，但是沒那麼靈活，因為Java數組的大小變了，本地代碼也跟著修改。接著調用 GetIntArrayRegion函數將Java數組中的所有元素拷貝到C緩衝區中，並累加數組中所有元素的和，最後釋放儲存java數組元素的C緩衝區，並返回計算結果。GetIntArrayRegion函數第1個參數是JNIEnv函數指標，第2個參數是Java數組對象，第3個參數是拷貝數組的開始索引，第4個參數是拷貝數組的長度，第5個參數是拷貝目的地。是計算結果：

在前面的例子當中，我們通過調用GetIntArrayRegion函數，將int數組中的所有元素拷貝到C臨時緩衝區中，然後在本地代碼中訪問緩衝區中的元素來實現求和的計算，JNI還提供了一個和GetIntArrayRegion相對應的函SetIntArrayRegion，本地代碼可以通過這個函數來修改所有基礎資料型別 (Elementary Data Type)數組的元素。另外JNI還提供一系列直接擷取數組元素指標的函數Get/Release<Type>ArrayElements，比如：GetIntArrayElements、ReleaseArrayElements、GetFloatArrayElements、ReleaseFloatArrayElements等。下面我們用這種方式重新實現計算數組元素的和：

JNIEXPORT jint JNICALL Java_com_study_jnilearn_IntArray_sumArray2(JNIEnv *env, jobject obj, jintArray j_array){    jint i, sum = 0;    jint *c_array;    jint arr_len;    // 可能數組中的元素在記憶體中是不連續的，JVM可能會複製所有未經處理資料到緩衝區，然後返回這個緩衝區的指標    c_array = (*env)->GetIntArrayElements(env,j_array,NULL);    if (c_array == NULL) {        return 0;   // JVM複製未經處理資料到緩衝區失敗    }    arr_len = (*env)->GetArrayLength(env,j_array);    printf("arr_len = %d\n", arr_len);    for (i = 0; i < arr_len; i++) {        sum += c_array[i];    }    (*env)->ReleaseIntArrayElements(env,j_array, c_array, 0); // 釋放可能複製的緩衝區    return sum;}

GetIntArrayElements第三個參數表示返回的數組指標是原始數組，還是拷貝未經處理資料到臨時緩衝區的指標，如果是JNI_TRUE：表示臨時緩衝區數組指標，JNI_FALSE：表示臨時原始數組指標。開發當中，我們並不關心它從哪裡返回的數組指標，這個參數填NULL即可，但在擷取到的指標必須做校正，因為當未經處理資料在記憶體當中不是連續存放的情況下，JVM會複製所有未經處理資料到一個臨時緩衝區，並返回這個臨時緩衝區的指標。有可能在申請開闢臨時緩衝區記憶體空間時，會記憶體不足導致申請失敗，這時會返回NULL。
    寫過Java的程式員都知道，在Java中建立的對象全都由GC（記憶體回收行程）自動回收，不需要像C/C++一樣需要程式員自己管理記憶體。GC會即時掃描所有建立的對象是否還有引用，如果沒有引用則會立即清理掉。當我們建立一個像int數組對象的時候，當我們在本地代碼想去訪問時，發現這個對象正被GC線程佔用了，這時本地代碼會一直處於阻塞狀態，直到等待GC釋放這個對象的鎖之後才能繼續訪問。為了避免這種現象的發生，JNI提供了Get/ReleasePrimitiveArrayCritical這對函數，本地代碼在訪問數組對象時會暫停GC線程。不過使用這對函數也有個限制，在Get/ReleasePrimitiveArrayCritical這兩個函數期間不能調用任何會讓線程阻塞或等待JVM中其它線程的本地函數或JNI函數，和處理字串的Get/ReleaseStringCritical函數限制一樣。這對函數和GetIntArrayElements函數一樣，返回的是數組元素的指標。下面用這種方式重新實現上例中的功能：

JNIEXPORT jint JNICALL Java_com_study_jnilearn_IntArray_sumArray(JNIEnv *env, jobject obj, jintArray j_array){    jint i, sum = 0;    jint *c_array;    jint arr_len;    jboolean isCopy;    c_array = (*env)->GetPrimitiveArrayCritical(env,j_array,&isCopy);    printf("isCopy: %d \n", isCopy);    if (c_array == NULL) {        return 0;    }    arr_len = (*env)->GetArrayLength(env,j_array);    printf("arr_len = %d\n", arr_len);    for (i = 0; i < arr_len; i++) {        sum += c_array[i];    }    (*env)->ReleasePrimitiveArrayCritical(env, j_array, c_array, 0);    return sum;}

小結：

1、對於小量的、固定大小的數組，應該選擇Get/SetArrayRegion函數來運算元組元素是效率最高的。因為這對函數要求提前分配一個C臨時緩衝區來儲存數組元素，你可以直接在Stack（棧）上或用malloc在堆上來動態申請，當然在棧上申請是最快的。有童鞋可能會認為，訪問數組元素還需要將未經處理資料全部拷貝一份到臨時緩衝區才能訪問而覺得效率低？我想告訴你的是，像這種複製少量數組元素的代價是很小的，幾乎可以忽略。這對函數的另外一個優點就是，允許你傳入一個開始索引和長度來實現對子數組元素的訪問和操作（SetArrayRegion函數可以修改數組），不過傳入的索引和長度不要越界，函數會進行檢查，如果越界了會拋出ArrayIndexOutOfBoundsException異常。

2、如果不想預先分配C緩衝區，並且原始數組長度也不確定，而本地代碼又不想在擷取數組元素指標時被阻塞的話，使用Get/ReleasePrimitiveArrayCritical函數對，就像Get/ReleaseStringCritical函數對一樣，使用這對函數要非常小心，以免死結。

3、Get/Release<type>ArrayElements系列函數永遠是安全的，JVM會選擇性的返回一個指標，這個指標可能指向未經處理資料，也可能指向未經處理資料的複製。

二、訪問對象數組

       JNI提供了兩個函數來訪問對象數組，GetObjectArrayElement返回數組中指定位置的元素，SetObjectArrayElement修改數組中指定位置的元素。與基本類型不同的是，我們不能一次得到資料中的所有對象元素或者一次複製多個對象元素到緩衝區。因為字串和數組都是參考型別，只能通過Get/SetObjectArrayElement這樣的JNI函數來訪問字串數組或者數組中的數組元素。下面的例子通過調用一個本地方法來建立一個二維的int數組，然後列印這個二維數組的內容：

package com.study.jnilearn;public class ObjectArray {private native int[][] initInt2DArray(int size);public static void main(String[] args) {ObjectArray obj = new ObjectArray();int[][] arr = obj.initInt2DArray(3);for (int i = 0; i < 3; i++) {for (int j = 0; j < 3; j++) {System.out.format("arr[%d][%d] = %d\n", i, j, arr[i][j]);}}}static {System.loadLibrary("ObjectArray");}}

本地代碼：

/* DO NOT EDIT THIS FILE - it is machine generated */#include <jni.h>/* Header for class com_study_jnilearn_ObjectArray */#ifndef _Included_com_study_jnilearn_ObjectArray#define _Included_com_study_jnilearn_ObjectArray#ifdef __cplusplusextern "C" {#endif/* * Class:     com_study_jnilearn_ObjectArray * Method:    initInt2DArray * Signature: (I)[[I */JNIEXPORT jobjectArray JNICALL Java_com_study_jnilearn_ObjectArray_initInt2DArray  (JNIEnv *, jobject, jint);#ifdef __cplusplus}#endif#endif// ObjectArray.c#include "com_study_jnilearn_ObjectArray.h"/* * Class:     com_study_jnilearn_ObjectArray * Method:    initInt2DArray * Signature: (I)[[I */JNIEXPORT jobjectArray JNICALL Java_com_study_jnilearn_ObjectArray_initInt2DArray  (JNIEnv *env, jobject obj, jint size){    jobjectArray result;    jclass clsIntArray;    jint i,j;    // 1.獲得一個int型二維數組類的引用    clsIntArray = (*env)->FindClass(env,"[I");    if (clsIntArray == NULL)    {        return NULL;    }    // 2.建立一個數組對象（裡面每個元素用clsIntArray表示）    result = (*env)->NewObjectArray(env,size,clsIntArray,NULL);    if (result == NULL)    {        return NULL;    }        // 3.為數組元素賦值    for (i = 0; i < size; ++i)    {        jint buff[256];        jintArray intArr = (*env)->NewIntArray(env,size);        if (intArr == NULL)        {            return NULL;        }        for (j = 0; j < size; j++)        {            buff[j] = i + j;        }        (*env)->SetIntArrayRegion(env,intArr, 0,size,buff);        (*env)->SetObjectArrayElement(env,result, i, intArr);        (*env)->DeleteLocalRef(env,intArr);    }        return result;}

結果：

     本地函數initInt2DArray首先調用JNI函數FindClass獲得一個int型的二維數組類的引用，傳遞給FindClass的參數"[I"是JNI class descript（JNI類型描述元，後面為詳細介紹），它對應著JVM中的int[]類型。如果int[]類載入失敗的話，FindClass會返回NULL，然後拋出一個java.lang.NoClassDefFoundError: [I異常。

     接下來，NewObjectArray建立一個新的數組，這個數組裡面的元素類型用intArrCls(int[])類型來表示。函數NewObjectArray只能分配第一維，JVM沒有與多維陣列相對應的資料結構，JNI也沒有提供類似的函數來建立二維數組。由於JNI中的二維數組直接操作的是JVM中的資料結構，相比JAVA和C/C++建立二維數組要複雜很多。給二維數組設定資料的方式也非常直接，首先用NewIntArray建立一個JNI的int數組，並為每個數組元素分配空間，然後用SetIntArrayRegion把buff[]緩衝中的內容複寫到新分配的一維數組中去，最後在外層迴圈中依次將int[]數組賦值到jobjectArray數組中，一維數組中套一維數組，就形成了一個所謂的二維數組。

     另外，為了避免在迴圈內建立大量的JNI局部引用，造成JNI參考資料表溢出，所以在外層迴圈中每次都要調用DeleteLocalRef將新建立的jintArray引用從參考資料表中移除。在JNI中，只有jobject以及子類屬於引用變數，會佔用參考資料表的空間，jint，jfloat，jboolean等都是基本類型變數，不會佔用參考資料表空間，即不需要釋放。參考資料表最大空間為512個，如果超出這個範圍，JVM就會掛掉。