Android JNI入門第三篇——jni頭文件分析 · Android JNI入門

## 一、首先寫了java文件： ~~~ public class HeaderFile { private native void doVoid(); native int doShort(); native void doArray(Object[] o ); native int doInt(int i); //byte ,short ,int,long,float,double ,boolean,char native int doInt(double d); //byte ,short ,int,long,float,double ,boolean,char native int doInt(Object o); native int doInt(double d1,double d2); static native int doInt(double d1 ,double d2,double d3); static native int doInt(double d1 ,float f,boolean b ,char[] c ); native int doInt(int[] i); native int doInt(int[] i1,double[] i2 ); static native int doInt(int[] i1,double[] i2 ,Object[] o ); public native String doString(String s); public native Object doObject(Object o ); public native Enumeration doInterface(Iterator it); public native Student doStudent(Student s); // native int[] doInt(int[] i); //byte ,short ,int,long,float,double ,boolean,char public native String[] doString(String[] s); public native Object[] doObjects(Object[] o ); public native Enumeration[] doInterface(Iterator[] it); public native Student[] doStudent(Student[] s); public native static Object doAll(int[] i , String[] s , Student[] student ); } ~~~ java文件中包含了private、public、protect等類型的方法，static 方法和非static 方法，返回類型有基礎類型、對象等。 ## 二、下面看一下生成的頭文件： ~~~ /* DO NOT EDIT THIS FILE - it is machine generated */ #include <jni.h> /* Header for class com_nedu_jni_helloword_HeaderFile */ #ifndef _Included_com_nedu_jni_helloword_HeaderFile #define _Included_com_nedu_jni_helloword_HeaderFile #ifdef __cplusplus extern "C" { #endif /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doVoid * Signature: ()V */ JNIEXPORT void JNICALL Java_com_nedu_jni_helloword_HeaderFile_doVoid (JNIEnv *, jobject); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doShort * Signature: ()I */ JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doShort (JNIEnv *, jobject); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doArray * Signature: ([Ljava/lang/Object;)V */ JNIEXPORT void JNICALL Java_com_nedu_jni_helloword_HeaderFile_doArray (JNIEnv *, jobject, jobjectArray); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doInt * Signature: (I)I */ JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt__I (JNIEnv *, jobject, jint); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doInt * Signature: (D)I */ JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt__D (JNIEnv *, jobject, jdouble); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doInt * Signature: (Ljava/lang/Object;)I */ JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt__Ljava_lang_Object_2 (JNIEnv *, jobject, jobject); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doInt * Signature: (DD)I */ JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt__DD (JNIEnv *, jobject, jdouble, jdouble); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doInt * Signature: (DDD)I */ JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt__DDD (JNIEnv *, jclass, jdouble, jdouble, jdouble); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doInt * Signature: (DFZ[C)I */ JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt__DFZ_3C (JNIEnv *, jclass, jdouble, jfloat, jboolean, jcharArray); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doInt * Signature: ([I)I */ JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt___3I (JNIEnv *, jobject, jintArray); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doInt * Signature: ([I[D)I */ JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt___3I_3D (JNIEnv *, jobject, jintArray, jdoubleArray); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doInt * Signature: ([I[D[Ljava/lang/Object;)I */ JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt___3I_3D_3Ljava_lang_Object_2 (JNIEnv *, jclass, jintArray, jdoubleArray, jobjectArray); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doString * Signature: (Ljava/lang/String;)Ljava/lang/String; */ JNIEXPORT jstring JNICALL Java_com_nedu_jni_helloword_HeaderFile_doString__Ljava_lang_String_2 (JNIEnv *, jobject, jstring); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doObject * Signature: (Ljava/lang/Object;)Ljava/lang/Object; */ JNIEXPORT jobject JNICALL Java_com_nedu_jni_helloword_HeaderFile_doObject (JNIEnv *, jobject, jobject); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doInterface * Signature: (Ljava/util/Iterator;)Ljava/util/Enumeration; */ JNIEXPORT jobject JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInterface__Ljava_util_Iterator_2 (JNIEnv *, jobject, jobject); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doStudent * Signature: (Lcom/nedu/jni/helloword/Student;)Lcom/nedu/jni/helloword/Student; */ JNIEXPORT jobject JNICALL Java_com_nedu_jni_helloword_HeaderFile_doStudent__Lcom_nedu_jni_helloword_Student_2 (JNIEnv *, jobject, jobject); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doString * Signature: ([Ljava/lang/String;)[Ljava/lang/String; */ JNIEXPORT jobjectArray JNICALL Java_com_nedu_jni_helloword_HeaderFile_doString___3Ljava_lang_String_2 (JNIEnv *, jobject, jobjectArray); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doObjects * Signature: ([Ljava/lang/Object;)[Ljava/lang/Object; */ JNIEXPORT jobjectArray JNICALL Java_com_nedu_jni_helloword_HeaderFile_doObjects (JNIEnv *, jobject, jobjectArray); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doInterface * Signature: ([Ljava/util/Iterator;)[Ljava/util/Enumeration; */ JNIEXPORT jobjectArray JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInterface___3Ljava_util_Iterator_2 (JNIEnv *, jobject, jobjectArray); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doStudent * Signature: ([Lcom/nedu/jni/helloword/Student;)[Lcom/nedu/jni/helloword/Student; */ JNIEXPORT jobjectArray JNICALL Java_com_nedu_jni_helloword_HeaderFile_doStudent___3Lcom_nedu_jni_helloword_Student_2 (JNIEnv *, jobject, jobjectArray); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doAll * Signature: ([I[Ljava/lang/String;[Lcom/nedu/jni/helloword/Student;)Ljava/lang/Object; */ JNIEXPORT jobject JNICALL Java_com_nedu_jni_helloword_HeaderFile_doAll (JNIEnv *, jclass, jintArray, jobjectArray, jobjectArray); #ifdef __cplusplus } #endif #endif ~~~ ## 三、頭文件分析如下： 1、文件的前九行就不用說了，他們是是C、C++的頭，應該很好理解。 2、方法的注釋部分，每個方法都有它的注釋部分，這些都是相似的，對其中一個分析： ~~~ /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doVoid * Signature: ()V */ ~~~ 注釋部分分為三部分Class、Method、Signature。 Class：表示Native方法的類名稱。 Method：表示方法名稱 Signature：是方法的標識，它是一個標識符，主要供我們在JNI操作java對象的方法使用的。 Signature一般是兩部分構成，一個方法的參數，另一個是返回類型。方法參數在括號里面，返回類型在后面，例如 ~~~ ()V 返回為void，沒有參數。 ~~~ ~~~ (DFZ[C)I 返回為int，參數為double、float、char[] ~~~ ~~~ (Ljava/lang/String;)Ljava/lang/String;返回String，參數為String ~~~ 如果不清楚其中的字符含義，就不能知道其中的意思，其中字符對應有基本類型、對象類型、數組類型。分析如下 1）基本類型的對應關系如下： ![](https://box.kancloud.cn/2016-01-14_56971f3f7261f.gif) 2）方法參數或者返回值為java中的對象時，必須以“L”加上其路徑，不過此路徑必須以“/”分開，自定義的對象也使用本規則，不在包中時直接“L”加上類名稱。比如說java.lang.String為“java/lang/String”,com.nedu.jni.helloword.Student為"com/nedu/jni/helloword/Student" 3)方法參數或者返回值為數組時類型前加上[,例如[I表示int[],[[[D表示 double[][][]，即幾維數組就加幾個[。看一下例子： ![](https://box.kancloud.cn/2016-01-14_56971f3f8190f.gif) 3、方法的聲明 ~~~ JNIEXPORT void JNICALL Java_com_nedu_jni_helloword_HeaderFile_doArray(JNIEnv *,jobject,jobjectArray); ~~~ 從上面的頭文件可以看出方法基本有7部分組成。 ![](https://box.kancloud.cn/2016-01-14_56971f3f95a78.gif) 1、3部分是都是JNI的關鍵字，表示此函數是要被JNI調用的。 2、表示方法的返回類型 4、為JNI中標識此方法來源于java的標識頭 5、方法所在類的包名+類名 6、方法名 7、參數，它們有一個共同的特點，包含JNIEnv *――它是一個接口指針，用于定位函數表中的函數！在JNI規范中一般稱? 為?? “Interface Pointer”。看到這兒好像和過程調用很類似了！是的，JNI中的操作過程就是面向過程的！后面的jobject是?一個指向該類的指針，類似與C語言中的this。這個第二個參數是變化的，當該方法為類的實例方法時該參數為jobject；當該方法為類方法（即靜態方法）時該參數為jclass，指向該類的class。根據不同方法前綴生成的頭文件比較如下： 1、static與非static的比較： ~~~ /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doInt * Signature: (DD)I */ JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt__DD (JNIEnv *, <span style="background-color: rgb(255, 0, 0);">jobject</span>, jdouble, jdouble); /* * Class: com_nedu_jni_helloword_HeaderFile * Method: doInt * Signature: (DDD)I */ JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt__DDD (JNIEnv *, <span style="color:#000000;background-color: rgb(255, 0, 0);">jclass</span>, jdouble, jdouble, jdouble); ~~~ 第一個是非static方法，第二個是static方法，不同點如上紅色標記。其中的不同將在以后提到。 2、?private、friendly、protected以及public這些方法限制符不會在JNI的頭文件中出現。這些訪問修飾符只有在其它類使用這些方法時有效！JNI中不關心此修飾符！