有關Android JNI開發中比較強大和有用的功能就是從JNI層創建、構造Java的類或執行Java層的方法獲取屬性等操作。
一、類的相關操作
1. jclass FindClass(JNIEnv *env, const char *name); 查找類
該函數可能做過Java開發的不會陌生,這個是JNI層的實現,需要注意的是第二個參數爲const char*類型的,我們如果從Java從層傳入unicode編碼的jstring類型需要使用GetStringUTFChars函數轉換成utf8的 const char*,如果成功返回這個Java類的對象jclass,相關的異常可能有
(1. ClassFormatError 類的數據格式無效
(2. ClassCircularityError 該類或接口是自身的超類或超接口
(3. NoClassDefFoundError 沒有找到指定名稱的類或接口
(4. OOM內存不足錯誤,即OutOfMemoryError
2. jclass GetSuperclass(JNIEnv *env, jclass clazz); 獲取父類或者說超類
該函數的第二個參數爲jclass類,我們調用時傳入的是子類,否則返回將是NULL
3. jboolean IsAssignableFrom(JNIEnv *env, jclass clazz1,jclass clazz2); 判斷class1對象能否安全的強制轉換爲class2對象
如果可以將返回 JNI_TRUE,JNI_TRUE的定義值爲1,否則返回JNI_FALSE即0 ,這裏Android123詳細說明下哪些情況可能返回真:
(1 這兩個類參數引用同一個 Java 類
(2 第一個類是第二個類的子類
(3 第二個類是第一個類的某個接口
4. jclass GetObjectClass(JNIEnv *env, jobject obj); 通過對象獲取這個類
該函數比較簡單,唯一注意的是對象不能爲NULL,否則獲取的class肯定返回也爲NULL。
5. jboolean IsInstanceOf(JNIEnv *env, jobject obj,jclass clazz); 判斷對象是否爲某個類的實例
這個函數是JNI層的實現,相信大家都不陌生,Android開發網提醒大家需要注意的是返回值可能產生異議,就是如果傳入的第二個參數爲NULL對象,NULL對象可以強制轉換爲各種類,所以這種情況也將會返回JNI_TRUE,所以一定判斷傳入的對象是否爲空。
6. jboolean IsSameObject(JNIEnv *env, jobject ref1,jobject ref2); 判斷兩個對象是否引用同一個類
需要注意的是如果兩個對象均爲空,返回的值也會是JNI_TRUE所以使用時判斷對象爲空。
二、調用Java方法
首先說下有關簽名sig相關的比如 "Ljava/lang/String;"
1. jmethodID GetMethodID(JNIEnv *env, jclass clazz,const char *name, const char *sig); 獲取一個Java方法的ID
這個函數將返回非靜態類或接口實例方法的方法 ID。這個方法可以是某個clazz 的超類中定義,也可從clazz 繼承,最後一個參數爲簽名,最後兩個參數是const char*類型,是utf8類型。需要注意的是Android123提醒大家執行GetMethodID()函數將導致未初始化的類初始化,如果要獲得構 造函數的方法ID,使用 <init> 作爲方法名,同時將 void (V) 作爲返回類型,如果找不到指定的ID將返回NULL,同時異常可能有:
(1 NoSuchMethodError 找不到指定的Java方法。
(2 ExceptionInInitializerError 如果由於異常而導致類初始化程序失敗
(3 OutOfMemoryError 內存不足
2 . NativeType CallXXXMethod (JNIEnv *env, jobject obj,jmethodID methodID, va_list args); 調用XXX類型的Java方法
執行Java類中某個方法,需要注意的是這個裏的java類是非靜態的,由於Java的方法的類型比較多,所以該函數可能有以下幾種形式,如 CallObjectMethod,CallBooleanMethod,CallByteMethod,CallCharMethod,CallShortMethod,CallIntMethod,CallLongMethod,CallFloatMethod,CallDoubleMethod 和CallVoidMethod,需要注意的是,該函數的第三個參數爲通過GetMethodID函數獲取的方法ID,最後一個參數爲這個方法的參數表, 最後的va_list宏可以通過搜索獲取具體的使用方法,這裏Android開發網不再贅述。
3.NativeType CallNonvirtualXXXMethod (JNIEnv *env, jobject obj,jclass clazz, jmethodID methodID, jvalue *args);
CallNonvirtualXXXMethod函數和上面的CallXXXMethod 不同之處是多了一個jclass參數,CallXXXMethod是根據對象來調用方法,而CallNonvirtualXXXMethod是根據類的實 例調用,區別在這點。
上面的三個均爲非靜態類的獲取,執行調用,需要實例化這個類纔可以執行,下面的爲靜態調用。
4. jmethodID GetStatic MethodID(JNIEnv *env, jclass clazz,const char *name, const char *sig);
5. NativeType CallStatic XXXMethod(JNIEnv *env, jclass clazz,jmethodID methodID, ...);
三、訪問Java對象的域
Java對象的域或者說字段、屬性(Field) 類似方法的執行
1. jfieldID GetFieldID(JNIEnv *env, jclass clazz,const char *name, const char *sig); 獲取實例對象的域ID
需要注意的是,非靜態的實例化後的對象,可能產生的異常有
(1 NoSuchFieldError 找不到指定的域
(2 ExceptionInInitializerError 因爲異常而導致類初始化失敗
(3 OutOfMemoryError內存不足。
2. NativeType GetXXXField(JNIEnv *env, jobject obj,jfieldID fieldID);
類似GetXXXMethod函數,可能有的類型有 GetObjectField,GetBooleanField,GetByteField,GetCharField,GetShortField,GetIntField,GetLongField,GetFloatField,GetDoubleField。
3. void SetXXXField(JNIEnv *env, jobject obj, jfieldID fieldID,NativeType value);
Java的域可以賦值的,可能有的類型有 SetObjectField,SetBooleanField,SetByteField,SetCharField,SetShortField,SetIntField,SetLongField,SetFloatField,SetDoubleField。
上面3種情況均爲非靜態對象的域,對於不需要實例化對象的域,可以直接使用下面的。
4. jfieldID GetStaticFieldID(JNIEnv *env, jclass clazz,const char *name, const char *sig);
5. NativeType GetStaticXXXField(JNIEnv *env, jclass clazz,jfieldID fieldID);
6. void SetStaticXXXField(JNIEnv *env, jclass clazz,jfieldID fieldID, NativeType value);
四、實例代碼,Android123給網友準備了一個例子,幫助大家實戰Android JNI開發,大家可以移植到Android NDK環境中執行,網友可以訪問 Android JNI開發代碼 (Android JNI實例代碼(一) )
最後有關Android JNI最後的終極內容,Android開發網主要說明下JVM和JNI的全局引用相關內容,比如本地全局引用LocalGlobalRef,弱全局引用 WeakGlobalRef,JNI中線程處理的高級方法比如AttachCurrentThread,以及JNI中的NIO的相關特性將在明天繼續講 解,更多的有關Android平臺NDK開發內容可以查看我們 Android NDK開發技巧系列文章。