Android JNI開發高級篇

有關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開發技巧系列文章。

發佈了146 篇原創文章 · 獲贊 7 · 訪問量 43萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章