前言
鐵鋒網(wǎng)站制作公司哪家好,找成都創(chuàng)新互聯(lián)!從網(wǎng)頁設計、網(wǎng)站建設、微信開發(fā)、APP開發(fā)、響應式網(wǎng)站建設等網(wǎng)站項目制作,到程序開發(fā),運營維護。成都創(chuàng)新互聯(lián)于2013年創(chuàng)立到現(xiàn)在10年的時間,我們擁有了豐富的建站經(jīng)驗和運維經(jīng)驗,來保證我們的工作的順利進行。專注于網(wǎng)站建設就選成都創(chuàng)新互聯(lián)。
JNI 中有兩種數(shù)組操作,基礎數(shù)據(jù)類型數(shù)組和對象數(shù)組,JNI 對待基礎數(shù)據(jù)類型數(shù)組和對象數(shù)組是不一樣的。
基本數(shù)據(jù)類型數(shù)組
對于基本數(shù)據(jù)類型數(shù)組,JNI 都有和 Java 相對應的結構,在使用起來和基本數(shù)據(jù)類型的使用類似。
在 Android JNI 基礎知識篇提到了 Java 數(shù)組類型對應的 JNI 數(shù)組類型。比如,Java int 數(shù)組對應了 jintArray,boolean 數(shù)組對應了 jbooleanArray。
如同 String 的操作一樣,JNI 提供了對應的轉換函數(shù):GetArrayElements、ReleaseArrayElements。
intArray = env->GetIntArrayElements(intArray_, NULL); env->ReleaseIntArrayElements(intArray_, intArray, 0);
另外,JNI 還提供了如下的函數(shù):
GetTypeArrayRegion / SetTypeArrayRegion
將數(shù)組內容復制到 C 緩沖區(qū)內,或將緩沖區(qū)內的內容復制到數(shù)組上。
GetArrayLength
得到數(shù)組中的元素個數(shù),也就是長度。
NewTypeArray
返回一個指定數(shù)據(jù)類型的數(shù)組,并且通過 SetTypeArrayRegion 來給指定類型數(shù)組賦值。
GetPrimitiveArrayCritical / ReleasePrimitiveArrayCritical
如同 String 中的操作一樣,返回一個指定基礎數(shù)據(jù)類型數(shù)組的直接指針,在這兩個操作之間不能做任何阻塞的操作。
實際操作如下:
// Java 傳遞 數(shù)組 到 Native 進行數(shù)組求和 private native int intArraySum(int[] intArray, int size);
對應的 C++ 代碼如下:
JNIEXPORT jint JNICALL Java_com_glumes_cppso_jnioperations_ArrayTypeOps_intArraySum(JNIEnv *env, jobject instance, jintArray intArray_, jint num) { jint *intArray; int sum = 0; // 操作方法一: // 如同 getUTFString 一樣,會申請 native 內存 intArray = env->GetIntArrayElements(intArray_, NULL); if (intArray == NULL) { return 0; } // 得到數(shù)組的長度 int length = env->GetArrayLength(intArray_); LOGD("array length is %d", length); for (int i = 0; i < length; ++i) { sum += intArray[i]; } LOGD("sum is %d", sum); // 操作方法二: jint buf[num]; // 通過 GetIntArrayRegion 方法來獲取數(shù)組內容 env->GetIntArrayRegion(intArray_, 0, num, buf); sum = 0; for (int i = 0; i < num; ++i) { sum += buf[i]; } LOGD("sum is %d", sum); // 使用完了別忘了釋放內存 env->ReleaseIntArrayElements(intArray_, intArray, 0); return sum; }
假如需要從 JNI 中返回一個基礎數(shù)據(jù)類型的數(shù)組,對應的代碼如下:
// 從 Native 返回基本數(shù)據(jù)類型數(shù)組 private native int[] getIntArray(int num);
對應的 C++ 代碼如下:
/** * 從 Native 返回 int 數(shù)組,主要調用 setArrayRegion 來填充數(shù)據(jù),其他數(shù)據(jù)類型類似操作 */ extern "C" JNIEXPORT jintArray JNICALL Java_com_glumes_cppso_jnioperations_ArrayTypeOps_getIntArray(JNIEnv *env, jobject instance, jint num) { jintArray intArray; intArray = env->NewIntArray(num); jint buf[num]; for (int i = 0; i < num; ++i) { buf[i] = i * 2; } // 使用 setIntArrayRegion 來賦值 env->SetIntArrayRegion(intArray, 0, num, buf); return intArray; }
以上例子,基本把相關的操作都使用上了,可以發(fā)現(xiàn)和 String 的操作大都是相似的。
對象數(shù)組
對于對象數(shù)組,也就是引用類型數(shù)組,數(shù)組中的每個類型都是引用類型,JNI 只提供了如下函數(shù)來操作。
GetObjectArrayElement / SetObjectArrayElement
和基本數(shù)據(jù)類型不同的是,不能一次得到數(shù)據(jù)中的所有對象元素或者一次復制多個對象元素到緩沖區(qū)。只能通過上面的函數(shù)來訪問或者修改指定位置的元素內容。
字符串和數(shù)組都是引用類型,因此也只能通過上面的方法來訪問。
例如在 JNI 中創(chuàng)建一個二維的整型數(shù)組并返回:
// 從 Native 返回二維整型數(shù)組,相當于是一個一維整型數(shù)組,數(shù)組中的每一項內容又是數(shù)組 private native int[][] getTwoDimensionalArray(int size);
二維數(shù)組具有特殊性在于,可以將它看成一維數(shù)組,其中數(shù)組的每項內容又是一維數(shù)組。
具體 C++ 代碼如下:
/** * 從 Native 返回一個二維的整型數(shù)組 */ extern "C" JNIEXPORT jobjectArray JNICALL Java_com_glumes_cppso_jnioperations_ArrayTypeOps_getTwoDimensionalArray(JNIEnv *env, jobject instance, jint size) { // 聲明一個對象數(shù)組 jobjectArray result; // 找到對象數(shù)組中具體的對象類型,[I 指的就是數(shù)組類型 jclass intArrayCls = env->FindClass("[I"); if (intArrayCls == NULL) { return NULL; } // 相當于初始化一個對象數(shù)組,用指定的對象類型 result = env->NewObjectArray(size, intArrayCls, NULL); if (result == NULL) { return NULL; } for (int i = 0; i < size; ++i) { // 用來給整型數(shù)組填充數(shù)據(jù)的緩沖區(qū) jint tmp[256]; // 聲明一個整型數(shù)組 jintArray iarr = env->NewIntArray(size); if (iarr == NULL) { return NULL; } for (int j = 0; j < size; ++j) { tmp[j] = i + j; } // 給整型數(shù)組填充數(shù)據(jù) env->SetIntArrayRegion(iarr, 0, size, tmp); // 給對象數(shù)組指定位置填充數(shù)據(jù),這個數(shù)據(jù)就是一個一維整型數(shù)組 env->SetObjectArrayElement(result, i, iarr); // 釋放局部引用 env->DeleteLocalRef(iarr); } return result; }
首先需要使用 NewObjectArray 方法來創(chuàng)建對象數(shù)組。
然后使用 SetObjectArrayElement 函數(shù)填充數(shù)據(jù)時,需要構建好每個位置對應的對象。這里就使用了 NewIntArray 來創(chuàng)造了一個對象,并給對象填充數(shù)據(jù)后,在賦值給對象數(shù)組。
通過一個 for 循環(huán)就完成給對象數(shù)組賦值的操作。
在創(chuàng)建對象數(shù)組時,有一個操作是找到對應的對象類型,通過 findClass 方法。findClass 的參數(shù) [I 這里就涉及到 Java 與 JNI 對應簽名的轉換。
Java 與 JNI 簽名的轉換
在前一篇文章中,用表格列出了 Java 與 JNI 對應的數(shù)據(jù)類型格式的轉換關系,現(xiàn)在要列舉的是 Java 與 JNI 對應簽名的轉換關系。
這里的簽名指的是在 JNI 中去查找 Java 中對應的數(shù)據(jù)類型、對應的方法時,需要將 Java 中的簽名轉換成 JNI 所能識別的。
對于類的簽名轉換
對于 Java 中類或者接口的轉換,需要用到 Java 中類或者接口的全限定名,把 Java 中描述類或者接口的 . 換成 / 就好了,比如 String 類型對應的 JNI 描述為:
java/lang/String // . 換成 /
對于數(shù)組類型,則是用 [ 來表示數(shù)組,然后跟一個字段的簽名轉換。
[I // 代表一維整型數(shù)組,I 表示整型 [[I // 代表二維整型數(shù)組 [Ljava/lang/String; // 代表一維字符串數(shù)組,
對于字段的簽名轉換
對應基礎類型字段的轉換:
Java 類型 | JNI 對應的描述轉 |
---|---|
boolean | Z |
byte | B |
char | C |
short | S |
int | I |
long | J |
float | F |
double | D |
對于引用類型的字段簽名轉換,是大寫字母 L 開頭,然后是類的簽名轉換,最后以 ; 結尾。
Java 類型 | JNI 對應的描述轉換 |
---|---|
String | Ljava/lang/String; |
Class | Ljava/lang/Class; |
Throwable | Ljava/lang/Throwable |
int[] | "[I" |
Object[] | "[Ljava/lang/Object;" |
對于方法的簽名轉換
對于方法簽名描述的轉換,首先是將方法內所有參數(shù)轉換成對應的字段描述,并全部寫在小括號內,然后在小括號外再緊跟方法的返回值類型描述。
Java 類型 | JNI 對應的描述轉換 |
---|---|
String f(); | ()Ljava/lang/String; |
long f(int i, Class c); | (ILjava/lang/Class;)J |
String(byte[] bytes); | ([B)V |
這里要注意的是在 JNI 對應的描述轉換中不要出現(xiàn)空格。
了解并掌握這些轉換后,就可以進行更多的操作了,實現(xiàn) Java 與 C++ 的相互調用。
比如,有一個自定義的 Java 類,然后再 Native 中打印類的對象數(shù)組的某一個字段值。
private native void printAnimalsName(Animal[] animal);
具體 C++ 代碼如下:
/** * 打印對象數(shù)組中的信息 */ extern "C" JNIEXPORT void JNICALL Java_com_glumes_cppso_jnioperations_ArrayTypeOps_printAnimalsName(JNIEnv *env, jobject instance, jobjectArray animals) { jobject animal; // 數(shù)組長度 int size = env->GetArrayLength(animals); // 數(shù)組中對應的類 jclass cls = env->FindClass("com/glumes/cppso/model/Animal"); // 類對應的字段描述 jfieldID fid = env->GetFieldID(cls, "name", "Ljava/lang/String;"); // 類的字段具體的值 jstring jstr; // 類字段具體值轉換成 C/C++ 字符串 const char *str; for (int i = 0; i < size; ++i) { // 得到數(shù)組中的每一個元素 animal = env->GetObjectArrayElement(animals, i); // 每一個元素具體字段的值 jstr = (jstring) (env->GetObjectField(animal, fid)); str = env->GetStringUTFChars(jstr, NULL); if (str == NULL) { continue; } LOGD("str is %s", str); env->ReleaseStringUTFChars(jstr, str); } }
具體示例代碼可參考我的 Github 項目,歡迎 Star。
https://github.com/glumes/AndroidDevWithCpp (本地下載)
總結
以上就是這篇文章的全部內容了,希望本文的內容對大家的學習或者工作具有一定的參考學習價值,如果有疑問大家可以留言交流,謝謝大家對創(chuàng)新互聯(lián)的支持。