基礎(chǔ)類型數(shù)組 與 對象數(shù)組

int[] iarr;             // 基礎(chǔ)類型數(shù)組
float[] farr;           // 基礎(chǔ)類型數(shù)組
Object[] oarr;          // 對象數(shù)組
int[][] iarr2;          // 對象數(shù)組

基礎(chǔ)類型數(shù)組

函數(shù)表

簡單示例：Get<Type>ArrayRegion()

public class IntArray {
static {
        System.loadLibrary("IntArray");
    }

    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);
    }

    private native int sumArray(int[] arr);
}

JNIEXPORT jint JNICALL Java_IntArray_sumArray(JNIEnv * env, jobject obj, jintArray arr) {
    jint buf[10], sum = 0;

    // 獲取數(shù)組長度
    const int length = (* env)->GetArrayLength(env, arr);

    // 獲取數(shù)組到buf中
    (* env)->GetIntArrayRegion(env, arr, 0, length, buf);
    for (int i = 0; i < 10; i++) {
        sum += buf[i];
    }
    return sum;
}

簡單示例：Get<Type>ArrayElements()

public class IntArray {
    static {
        System.loadLibrary("IntArray");
    }

    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);
    }

    private native int sumArray(int[] arr);
}

JNIEXPORT jint JNICALL Java_IntArray_sumArray(JNIEnv * env, jobject obj, jintArray arr) {
    jint sum = 0;

    // 返回?cái)?shù)組指針，可能是本體也可能是拷貝。
    jint * carr = (* env)->GetIntArrayElements(env, arr, NULL);
    if (!carr) {
        return 0;
    }

    // 獲取數(shù)組長度
    const int length = (* env)->GetArrayLength(env, arr);
    for (int i = 0; i < length; i++) {
        sum += carr[i];
    }

    // 釋放數(shù)組資源
    (* env)->ReleaseIntArrayElements(env, arr, carr, 0);
    return sum;
}

函數(shù)解說

• Get<Type>ArrayRegion()：復(fù)制基礎(chǔ)類型數(shù)組的內(nèi)容到 C緩沖區(qū) 。
• Set<Type>ArrayRegion()：將 C緩沖區(qū) 的內(nèi)容設(shè)置到基礎(chǔ)類型數(shù)組中去。
• Get<Type>ArrayElements()：獲取指向基礎(chǔ)類型數(shù)組內(nèi)容的指針，可能返回原始數(shù)組內(nèi)容的拷貝。
• Release<Type>ArrayElements()：釋放Get<Type>ArrayElements()獲取的指向基礎(chǔ)類型數(shù)組內(nèi)容的指針。
• GetArrayLength()：返回?cái)?shù)組中元素的個(gè)數(shù)。
• New<Type>Array()：創(chuàng)建指定長度的數(shù)組。
• GetPrimitiveArrayCritical()：獲取基礎(chǔ)類型數(shù)組的內(nèi)容，可能禁止垃圾回收，可能返回原始數(shù)組的一份拷貝。
• ReleasePrimitiveArrayCritical()：釋放GetPrimitiveArrayCritical()獲取的基礎(chǔ)類型數(shù)組的內(nèi)容。

函數(shù)選擇策略

• 關(guān)于以下三種函數(shù)的選擇策略：
  • Get<Type>ArrayRegion()和Set<Type>ArrayRegion()：通常用于小的，固定長度的數(shù)組，也可以用于訪問大數(shù)組中的一小部分。
  • Get<Type>ArrayElements()和Release<Type>ArrayElements()：通常用于大小未知，面向release1.1或release1.2但有阻塞的情況。
  • GetPrimitiveArrayCritical()和ReleasePrimitiveArrayCritical()：通常用于大小未知，代碼沒有阻塞，面向release1.2的情況

• 示意圖：

  
  

對象數(shù)組

簡單示例

public class ObjectArrayTest {
    static {
        System.loadLibrary("ObjectArrayTest");
    }

    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();
        }
    }

    private static native int[][] initInt2DArray(int size);
}

JNIEXPORT jobjectArray JNICALL Java_ObjectArrayTest_initInt2DArray(JNIEnv * env, jclass cls, jint size) {
    // 獲取一個(gè)"int[]"對應(yīng)的類
    jclass intArrCls = (* env)->FindClass(env, "[I");
    if (!intArrCls) {
        return NULL;
    }

    // 創(chuàng)建一個(gè)元素為intArrCls類對象的對象數(shù)組result
    jobjectArray result = (* env)->NewObjectArray(env, size, intArrCls, NULL);
    if (!result) {
        return NULL;
    }

    for (int i = 0; i < size; ++i) {
        // 創(chuàng)建一個(gè)Int元素的基本類型數(shù)組iarr
        jintArray iarr = (* env)->NewIntArray(env, size);
        if (!iarr) {
            return NULL;
        }

        jint tmp[256];
        for (int j = 0; j < size; j++) {
            tmp[j] = i + j;
        }

        (* env)->SetIntArrayRegion(env, iarr, 0, size, tmp);
        // 設(shè)置對象數(shù)組result中索引i的元素為iarr
        (* env)->SetObjectArrayElement(env, result, i, iarr);
        // 釋放資源，確保虛擬機(jī)不會(huì)因?yàn)樾枰钟写罅肯駃arr這樣的JNI引用而發(fā)生out-of-memory異常
        (* env)->DeleteLocalRef(env, iarr);
    }

    return result;
}

函數(shù)解說

• FindClass()：通過類描述符來獲取jclass。
• NewObjectArray()：創(chuàng)建對象數(shù)組。
• GetObjectArrayElement()：獲取對象數(shù)組元素。
• SetObjectArrayElement()：設(shè)置對象數(shù)組。