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 GetStaticMethodID(JNIEnv *env, jclass clazz,const char *name, const char *sig);

5. NativeType CallStaticXXXMethod(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開發技巧系列文章。