Android中的JNI數(shù)組操作教程
前言
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ù)組，主要調用 set<Type>ArrayRegion 來填充數(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 （本地下載）
總結
以上就是這篇文章的全部內容了，希望本文的內容對大家的學習或者工作具有一定的參考學習價值，如果有疑問大家可以留言交流，謝謝大家對腳本之家的支持。
相關文章
Android開源AndroidSideMenu實現(xiàn)抽屜和側滑菜單
這篇文章主要為大家詳細介紹了Android開源AndroidSideMenu實現(xiàn)抽屜和側滑菜單，具有一定的參考價值，感興趣的小伙伴們可以參考一下2017-02-02
Android圖片的Base64編碼與解碼及解碼Base64圖片方法
Base64是網(wǎng)絡上最常見的用于傳輸8Bit字節(jié)碼的編碼方式之一，Base64就是一種基于64個可打印字符來表示二進制數(shù)據(jù)的方法。接下來通過本文給大家分享Android圖片的Base64編碼與解碼及解碼Base64圖片，需要的朋友參考下吧2017-12-12
這篇文章主要介紹了Android中創(chuàng)建快捷方式代碼實例,本文分為三個步驟實現(xiàn),并分別給出對應實現(xiàn)代碼,需要的朋友可以參考下2015-04-04
這篇文章主要介紹了Android控制閃光燈的方法,可實現(xiàn)閃光燈打開與關閉的效果,涉及Android操作Camera拍照閃光燈的相關技巧,需要的朋友可以參考下2016-01-01
Android協(xié)程作用域與序列發(fā)生器限制介紹梳理
協(xié)程的作用是什么？協(xié)程是一種輕量級的線程，解決異步編程的復雜性，異步的代碼使用協(xié)程可以用順序進行表達，文中通過示例代碼介紹詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習吧2022-08-08
Android在fragment中編寫toobar的步驟詳解
這篇文章主要介紹了Android在fragment中編寫toobar,本文分步驟通過實例代碼給大家介紹的非常詳細，對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下2021-01-01
詳解Android中Intent對象與Intent Filter過濾匹配過程
這篇文章主要介紹了Android中Intent對象與Intent Filter過濾匹配過程，感興趣的小伙伴們可以參考一下2015-12-12
Android編程中沉浸式狀態(tài)欄的三種實現(xiàn)方式詳解
這篇文章主要介紹了Android編程中沉浸式狀態(tài)欄的三種實現(xiàn)方式,簡單描述了沉浸式狀態(tài)欄的概念、功能并結合實例形式詳細分析了Android實現(xiàn)沉浸式狀態(tài)欄的三種操作技巧與注意事項,需要的朋友可以參考下2018-02-02
這篇文章主要介紹了Android Bitmap和Drawable的對比的相關資料,需要的朋友可以參考下2017-05-05
android通過okhttpClient下載網(wǎng)頁內容的實例代碼
本篇文章主要介紹了android通過okhttpClient下載網(wǎng)頁內容的實例代碼，具有一定的參考價值，感興趣的小伙伴們可以參考一下2017-08-08