天天看點

Android JNI入門第三篇——jni頭檔案分析

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);  

 * Method:    doShort  

 * Signature: ()I  

JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doShort  

 * Method:    doArray  

 * Signature: ([Ljava/lang/Object;)V  

JNIEXPORT void JNICALL Java_com_nedu_jni_helloword_HeaderFile_doArray  

  (JNIEnv *, jobject, jobjectArray);  

 * Method:    doInt  

 * Signature: (I)I  

JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt__I  

  (JNIEnv *, jobject, jint);  

 * Signature: (D)I  

JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt__D  

  (JNIEnv *, jobject, jdouble);  

 * Signature: (Ljava/lang/Object;)I  

JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt__Ljava_lang_Object_2  

  (JNIEnv *, jobject, jobject);  

 * Signature: (DD)I  

JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt__DD  

  (JNIEnv *, jobject, jdouble, jdouble);  

 * Signature: (DDD)I  

JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt__DDD  

  (JNIEnv *, jclass, jdouble, jdouble, jdouble);  

 * Signature: (DFZ[C)I  

JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt__DFZ_3C  

  (JNIEnv *, jclass, jdouble, jfloat, jboolean, jcharArray);  

 * Signature: ([I)I  

JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt___3I  

  (JNIEnv *, jobject, jintArray);  

 * Signature: ([I[D)I  

JNIEXPORT jint JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInt___3I_3D  

  (JNIEnv *, jobject, jintArray, jdoubleArray);  

 * 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);  

 * 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);  

 * Method:    doObject  

 * Signature: (Ljava/lang/Object;)Ljava/lang/Object;  

JNIEXPORT jobject JNICALL Java_com_nedu_jni_helloword_HeaderFile_doObject  

 * Method:    doInterface  

 * Signature: (Ljava/util/Iterator;)Ljava/util/Enumeration;  

JNIEXPORT jobject JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInterface__Ljava_util_Iterator_2  

 * 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  

 * Signature: ([Ljava/lang/String;)[Ljava/lang/String;  

JNIEXPORT jobjectArray JNICALL Java_com_nedu_jni_helloword_HeaderFile_doString___3Ljava_lang_String_2  

 * Method:    doObjects  

 * Signature: ([Ljava/lang/Object;)[Ljava/lang/Object;  

JNIEXPORT jobjectArray JNICALL Java_com_nedu_jni_helloword_HeaderFile_doObjects  

 * Signature: ([Ljava/util/Iterator;)[Ljava/util/Enumeration;  

JNIEXPORT jobjectArray JNICALL Java_com_nedu_jni_helloword_HeaderFile_doInterface___3Ljava_util_Iterator_2  

 * 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  

 * 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);  

}  

                       1、檔案的前九行就不用說了,他們是是C、C++的頭,應該很好了解。

          2、方法的注釋部分,每個方法都有它的注釋部分,這些都是相似的,對其中一個分析:

注釋部分分為三部分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)基本類型的對應關系如下:

<a href="http://blog.51cto.com/attachment/201203/115247568.gif" target="_blank"></a>

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[][][],即幾維數組就加幾個[。

看一下例子:

<a href="http://blog.51cto.com/attachment/201203/115318176.gif" target="_blank"></a>

3、方法的聲明

JNIEXPORT void JNICALL Java_com_nedu_jni_helloword_HeaderFile_doArray(JNIEnv *,jobject,jobjectArray); 

從上面的頭檔案可以看出方法基本有7部分組成。

<a href="http://blog.51cto.com/attachment/201203/115406463.gif" target="_blank"></a>

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的比較:

  (JNIEnv *, &lt;span style="background-co

lor: rgb(255, 0, 0);"&gt;jobject&lt;/span&gt;, jdouble, jdouble);  

  (JNIEnv *, &lt;span style="color:#000000;background-color: rgb(255, 0, 0);"&gt;jclass&lt;/span&gt;, jdouble, jdouble, jdouble); 

第一個是非static方法,第二個是static方法,不同點如上紅色标記。其中的不同将在以後提到。 2、 private、friendly、protected以及public這些方法限制符不會在JNI的頭檔案中出現。這些通路修飾符隻有在其它類        使用這些方法時有效!JNI中不關心此修飾符!

/**  

* @author 張興業  

* 郵箱:[email protected]  

* qq:363302850  

*/ 

本文轉自xyz_lmn51CTO部落格,原文連結:http://blog.51cto.com/xyzlmn/817213,如需轉載請自行聯系原作者

繼續閱讀