JNI學習積累之一 ---- 經常使用函數大全

         最近一段時間，在工做方面比較閒，分配的Bug不是不少，因而好好利用這段時間就着源代碼看了些許模塊， 主要方式

   仍是賊看賊看代碼， 同時利用燒機的便利，加Log觀看，基本上都能弄個臉熟 。內心想着該寫點什麼了？但是水平不夠，再加上

   包括不少真正實現地方--中間層，基本上沒看。因而乎，也就很差賣弄了。

 

      花了幾天時間研究了下JNI，基本上知道如何使用了。照個人觀點JNI仍是不難的，可貴只是咱們一份嘗試的心。 學習過程當中，

  發現關於JNI函數資料真的不多，所謂「工欲善其事，便先利其器」，整理出了這份資料，但願能幫助你克服JNI學習的坎。

     

      主要資料來源： 百度文庫的《JNI經常使用函數》 。

      同時對其加以了補充 。

   

 

要素  ：一、 該函數大全是基於C語言方式的，對於C++方式能夠直接轉換 ，例如，對於生成一個jstring類型的方法轉換分別以下：

                     C編程環境中使用方法爲：(*env) ->NewStringUTF(env , "123") ;

                    C++編程環境中（例如，VC下）則是： env ->NewStringUTF( "123") ;             (使用起來更簡單)

 

           二、關於下列有些函數中：*isCopy     的說明，例如，以下函數：                     

                            const char* GetStringUTFChars(JNIEnv*env, jstring string, jboolean *isCopy);  

 

        對第三個參數 jboolean *isCopy說明以下：

             當從JNI函數GetStringUTFChars函數中返回獲得字符串B時，若是B是原始字符串java.lang.String的一份拷貝，

      則isCopy  被賦值爲JNI_TRUE。若是B是和原始字符串指向的是JVM中的同一份數據，則isCopy  被賦值爲JNI_FALSE。

     當isCopy  爲JNI_FALSE時，本地代碼毫不能修改字符串的內容，不然JVM中的原始字符串也會被修改，這會打破Java語言

      中字符串不可變的規則。

            一般，咱們沒必要關心JVM是否會返回原始字符串的拷貝，只須要爲isCopy傳遞NULL做爲參數 。

                                                                                                           ----     以上內容來自 《JNI編程指南》

 

1、類操做             

                            

  jclass DefineClass (JNIEnv *env, jobject loader,   const jbyte *buf , jsize bufLen);                 

     功能：從原始類數據的緩衝區中加載類。             

     參數： env        JNI 接口指針。            

                 loader    分派給所定義的類的類加載器。          

                 buf        包含 .class 文件數據的緩衝區。               

                 bufLen  緩衝區長度。          

     返回值：返回 Java 類對象。若是出錯則返回NULL。            

     拋出： ClassFormatError      若是類數據指定的類無效。                 

                       ClassCircularityError  若是類或接口是自身的超類或超接口。               

                       OutOfMemoryError  若是系統內存不足。                  

                        

   jclass FindClass (JNIEnv *env, const char *name);                

     功能: 該函數用於加載本地定義的類。它將搜索由CLASSPATH 環境變量爲具備指定名稱的類所指定的目錄和 zip文件。            

     參數：env    JNI 接口指針。            

              name  類全名（即包名後跟類名，之間由"/"分隔）.若是該名稱以「[（數組簽名字符）打頭，則返回一個數組類。         

     返回值：返回類對象全名。若是找不到該類，則返回 NULL。               

     拋出：   ClassFormatError          若是類數據指定的類無效。                 

                  ClassCircularityError      若是類或接口是自身的超類或超接口。                

                  NoClassDefFoundError  若是找不到所請求的類或接口的定義。            

                  OutOfMemoryError       若是系統內存不足。                  

 

  jclass GetObjectClass (JNIEnv *env, jobject obj); 

     功能：經過對象獲取這個類。該函數比較簡單，惟一注意的是對象不能爲NULL，不然獲取的class確定返回也爲NULL。     

     參數：  env   JNI 接口指針。            

                obj   Java 類對象實例。         

   

  jclass GetSuperclass (JNIEnv *env, jclass clazz);          

     功能：獲取父類或者說超類 。 若是 clazz 表明類class而非類 object，則該函數返回由 clazz 所指定的類的超類。 若是 clazz 

           指定類 object 或表明某個接口，則該函數返回NULL。           

     參數：  env   JNI 接口指針。            

                clazz  Java 類對象。            

     返回值：    由 clazz 所表明的類的超類或 NULL。               

                          

  jboolean IsAssignableFrom (JNIEnv *env, jclass clazz1,  jclass clazz2);           

    功能：肯定 clazz1 的對象是否可安全地強制轉換爲clazz2。            

    參數：  env  JNI 接口指針。            

              clazz1 第一個類參數。               

              clazz2 第二個類參數。               

    返回值：  下列某個狀況爲真時返回 JNI_TRUE：               

                    一、 第一及第二個類參數引用同一個 Java 類。              

                    二、 第一個類是第二個類的子類。             

                    三、 第二個類是第一個類的某個接口。    

 

   ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

         

2、異常操做                  

                        

  jint  Throw(JNIEnv *env, jthrowable obj);         

      功能：拋出 java.lang.Throwable 對象。                 

       參數： env  JNI 接口指針。            

                 obj   java.lang.Throwable 對象。         

       返回值：  成功時返回 0，失敗時返回負數。             

       拋出：    java.lang.Throwable 對象 obj。           

                

  jint ThrowNew (JNIEnv *env ,  jclass clazz,  const char *message);            

     功能：利用指定類的消息（由 message 指定）構造異常對象並拋出該異常。               

     參數： env    JNI 接口指針。            

                clazz  java.lang.Throwable 的子類。          

                message  用於構造java.lang.Throwable對象的消息。           

     返回值： 成功時返回 0，失敗時返回負數。             

     拋出：  新構造的 java.lang.Throwable 對象。                 

                   

  jthrowable ExceptionOccurred (JNIEnv *env);              

    功能：肯定是否某個異常正被拋出。在平臺相關代碼調用 ExceptionClear() 或 Java 代碼處理該異常前，異常將始終保持

        拋出狀態。                  

    參數：  env  JNI 接口指針。            

    返回值： 返回正被拋出的異常對象，若是當前無異常被拋出，則返回NULL。           

                      

 void ExceptionDescribe (JNIEnv *env);         

    功能：將異常及堆棧的回溯輸出到系統錯誤報告信道（例如 stderr）。該例程可便利調試操做。               

    參數：env   JNI 接口指針。            

                    

  void ExceptionClear (JNIEnv *env);                

   功能：清除當前拋出的任何異常。若是當前無異常，則此例程不產生任何效果。                  

   參數： env   JNI 接口指針。            

                  

  void FatalError (JNIEnv *env, const char *msg);           

   功能：拋出致命錯誤而且不但願虛擬機進行修復。該函數無返回值。             

   參數：  env   JNI 接口指針。            

               msg   錯誤消息。          

             

   ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

     

 

3、全局及局部引用             

                      

   jobject NewGlobalRef (JNIEnv *env, jobject obj);         

     功能：建立 obj 參數所引用對象的新全局引用。obj 參數既能夠是全局引用，也能夠是局部引用。全局引用經過調用 

          DeleteGlobalRef() 來顯式撤消。          

     參數：env   JNI 接口指針。            

                obj    全局或局部引用。                 

     返回值： 返回全局引用。若是系統內存不足則返回 NULL。          

                      

  void DeleteGlobalRef (JNIEnv *env, jobject globalRef);                 

     功能： 刪除 globalRef 所指向的全局引用。         

     參數： env    JNI 接口指針。            

                globalRef  全局引用。         

                              

  void  DeleteLocalRef (JNIEnv *env, jobject localRef);          

     功能： 刪除 localRef所指向的局部引用。             

     參數： env   JNI 接口指針。            

                 localRef  局部引用。            

             

   ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

    

 

4、對象操做          

          

  jobject AllocObject (JNIEnv *env, jclass clazz);              

     功能：分配新 Java 對象而不調用該對象的任何構造函數。返回該對象的引用。clazz 參數務必不要引用數組類。               

     參數： env  JNI 接口指針。            

               clazz  Java 類對象。            

     返回值： 返回 Java 對象。若是沒法構造該對象，則返回NULL。                 

     拋出： InstantiationException：若是該類爲一個接口或抽象類。                 

                OutOfMemoryError：若是系統內存不足。                  

                        

  jobject NewObject (JNIEnv *env ,  jclass clazz,  jmethodID methodID, ...);   //參數附加在函數後面             

  jobject NewObjectA (JNIEnv *env , jclassclazz,  jmethodID methodID, jvalue *args);    //參數以指針形式附加           

  jobjec tNewObjectV (JNIEnv *env , jclassclazz,  jmethodID methodID, va_list args);    //參數以"鏈表"形式附加            

  功能：構造新 Java 對象。方法 ID指示應調用的構造函數方法。注意：該 ID特指該類class的構造函數ID ， 必須經過調用 

      GetMethodID() 得到，且調用時的方法名必須爲 <init>，而返回類型必須爲 void (V)。clazz參數務必不要引用數組類。 

  參數：  env  JNI 接口指針。            

              clazz  Java 類對象。            

              methodID 構造函數的方法 ID。               

     NewObject 的其它參數：  傳給構造函數的參數，能夠爲空 。                  

     NewObjectA 的其它參數： args：傳給構造函數的參數數組。              

     NewObjectV 的其它參數： args：傳給構造函數的參數 va_list。       

           

  返回值： 返回 Java 對象，若是沒法構造該對象，則返回NULL。                 

  拋出：   InstantiationException  若是該類爲接口或抽象類。                 

              OutOfMemoryError   若是系統內存不足。                  

              構造函數拋出的任何異常。                  

                               

  jclass GetObjectClass (JNIEnv *env, jobject obj);         

   功能：返回對象的類。             

   參數： env  JNI 接口指針。            

              obj  Java 對象（不能爲 NULL）。               

   返回值： 返回 Java 類對象。              

                          

 jboolean IsInstanceOf (JNIEnv *env, jobject obj, jclass clazz);             

   功能：測試對象是否爲某個類的實例。                  

   參數：  env  JNI 接口指針。            

               obj  Java 對象。           

               clazz Java 類對象。            

   返回值：若是可將 obj 強制轉換爲 clazz，則返回 JNI_TRUE。不然返回 JNI_FALSE。NULL 對象可強制轉換爲任何類。           

                           

 jbooleanIsSameObject (JNIEnv *env, jobjectref1, jobject ref2);            

    功能：測試兩個引用是否引用同一 Java 對象。         

    參數：  env  JNI 接口指針。            

               ref1  Java 對象。                  

               ref2   Java 對象。                  

    返回值： 若是 ref1 和 ref2 引用同一 Java 對象或均爲 NULL，則返回 JNI_TRUE。不然返回 JNI_FALSE。         

        

   ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

    

                  

5、 字符串操做             

                                 

  jstring  NewString (JNIEnv *env, const jchar *unicodeChars,   jsize len);         

    功能：利用 Unicode 字符數組構造新的 java.lang.String 對象。               

    參數：   env：JNI 接口指針。            

                 unicodeChars：指向 Unicode 字符串的指針。         

                 len：Unicode 字符串的長度。             

    返回值： Java 字符串對象。若是沒法構造該字符串，則爲NULL。             

    拋出： OutOfMemoryError：若是系統內存不足。                  

                              

 jsize  GetStringLength (JNIEnv *env, jstring string);            

    功能：返回 Java 字符串的長度（Unicode 字符數）。                 

    參數：  env：JNI 接口指針。            

                string：Java 字符串對象。          

    返回值： Java 字符串的長度。            

                              

  const  jchar *  GetStringChars (JNIEnv*env, jstring string,  jboolean *isCopy);           

   功能：返回指向字符串的 Unicode 字符數組的指針。該指針在調用 ReleaseStringchars() 前一直有效。          

         若是 isCopy 非空，則在複製完成後將 *isCopy 設爲 JNI_TRUE。若是沒有複製，則設爲JNI_FALSE。  

   參數：   env：JNI 接口指針。            

                string：Java 字符串對象。          

                isCopy：指向布爾值的指針。               

   返回值：   指向 Unicode 字符串的指針，若是操做失敗，則返回NULL。               

                                    

 void  ReleaseStringChars (JNIEnv *env, jstring string,  const jchar *chars);                  

   功能：通知虛擬機平臺相關代碼無需再訪問 chars。參數chars 是一個指針，可經過 GetStringChars() 從 string 得到。    

   參數： env：JNI 接口指針。            

              string：Java 字符串對象。          

              chars：指向 Unicode 字符串的指針。               

                        

 jstring  NewStringUTF (JNIEnv *env, const char *bytes);            

   功能：利用 UTF-8 字符數組構造新 java.lang.String 對象。               

   參數： env：JNI 接口指針。若是沒法構造該字符串，則爲 NULL。         

              bytes：指向 UTF-8 字符串的指針。          

   返回值：Java 字符串對象。若是沒法構造該字符串，則爲NULL。             

   拋出：  OutOfMemoryError：若是系統內存不足。                  

                            

 jsize  GetStringUTFLength (JNIEnv *env, jstring string);              

   功能：以字節爲單位返回字符串的 UTF-8 長度。                

   參數：   env：JNI 接口指針。            

               string：Java 字符串對象。          

   返回值：  返回字符串的 UTF-8

 const char* GetStringUTFChars (JNIEnv*env, jstring string, jboolean *isCopy);           

   功能：返回指向字符串的 UTF-8 字符數組的指針。該數組在被ReleaseStringUTFChars() 釋放前將一直有效。    若是 isCopy 

      不是 NULL，*isCopy 在複製完成後即被設爲 JNI_TRUE。若是未複製，則設爲 JNI_FALSE。             

   參數：  env：JNI 接口指針。            

              string：Java 字符串對象。          

              isCopy：指向布爾值的指針。               

   返回值：  指向 UTF-8 字符串的指針。若是操做失敗，則爲 NULL。             

                            

  void  ReleaseStringUTFChars (JNIEnv *env, jstring string,  const char *utf);               

   功能：通知虛擬機平臺相關代碼無需再訪問 utf。utf 參數是一個指針，可利用 GetStringUTFChars() 得到。                  

   參數：   env：JNI 接口指針。            

               string：Java 字符串對象。          

               utf：指向 UTF-8 字符串的指針。               

 

 

   ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

         

6、數組操做                          

 jsize GetArrayLength (JNIEnv *env, jarray array);                 

   功能：返回數組中的元素數。                  

   參數：  env：JNI 接口指針。            

              array：Java 數組對象。                

   返回值： 數組的長度。                  

                             

 jarray NewObjectArray (JNIEnv *env, jsize length,  jclass elementClass, jobject initialElement);           

   功能：構造新的數組，它將保存類 elementClass 中的對象。全部元素初始值均設爲 initialElement。               

   參數： env：JNI 接口指針。            

             length：數組大小。               

             elementClass：數組元素類。               

             initialElement：初始值。    能夠爲NULL 。           

   返回值：Java 數組對象。若是沒法構造數組，則爲 NULL。                  

   拋出：  OutOfMemoryError：若是系統內存不足。                  

   

   說明： 使用該函數時，爲了便於易操做性，咱們通常能夠用jobjectArray數組類型或得返回值，例如：

                 jobjectArray objArray = env->NewObjectArray ( );

                 //操做該對象

                 env->GetObjectArrayElement (objArray, 0);//得到該object數組在索引0處的值 ,(能夠強制轉換類型).

 jobject  GetObjectArrayElement (JNIEnv *env,   jobjectArray array, jsize index);                

   功能：返回 Object 數組的元素。          

   參數：   env：JNI 接口指針。            

                array：Java 數組。                

                index：數組下標。                 

   返回值： Java 對象。            

   拋出： ArrayIndexOutOfBoundsException：若是 index 不是數組中的有效下標。             

                  

  void  SetObjectArrayElement (JNIEnv *env, jobjectArray array,  jsize index, jobject value);                

   功能：設置 Object 數組的元素。          

   參數：  env：JNI 接口指針。            

              array：Java 數組。                

               index：數組下標。                 

               value：新值。                 

   拋出： ArrayIndexOutOfBoundsException：若是 index 不是數組中的有效下標。             

              ArrayStoreException：若是 value 的類不是數組元素類的子類。           

                      

    New<PrimitiveType>Array方法類型      

         

  NativeType New<PrimitiveType>Array (JNIEnv *env, ArrayType array, jboolean*isCopy);                  

 

     說明： 用於構造新基本類型數組對象的一系列操做。下表說明了特定的基本類型數組構造函數。用戶應把

    New<PrimitiveType>Array 替換爲某個實際的基本類型數組構造函數例程名（見下表），而後將 ArrayType替換爲

　該例程相應的數組類型。

     參數：  env ： JNI 接口指針。            

                 length：數組長度。               

     返回值：  Java 數組。若是沒法構造該數組，則爲 NULL。

       　    

            New<PrimitiveType>Array 方法組               數組類型        

                  NewBooleanArray()                            jbooleanArray 

                  NewByteArray()                                  jbyteArray       

                  NewCharArray()                                 jcharArray       

                  NewShortArray()                                jshortArray      

                  NewIntArray()                                    jintArray 

                  NewLongArray()                                 jlongArray        

                  NewFloatArray()                                 jfloatArray       

                  NewDoubleArray()                             jdoubleArray   

                 

                  

 Get<PrimitiveType>ArrayElements 方法類型       

 

  NativeType *Get<PrimitiveType>ArrayElements (JNIEnv *env, ArrayType array, jboolean*isCopy);                  

   說明：一組返回基本類型數組體的函數。結果在調用相應的 Release<PrimitiveType>ArrayElements()函數前將一直有效。

     因爲返回的數組多是 Java 數組的副本，所以對返回數組的更改沒必要在基本類型數組中反映出來，直到調用了

     Release<PrimitiveType>ArrayElements()。 若是 isCopy 不是 NULL，*isCopy 在複製完成後即被設爲 JNI_TRUE。若是

     未複製，則設爲 JNI_FALSE。          

 　　 使用說明：   

   　　　   將 Get<PrimitiveType>ArrayElements 替換爲表中某個實際的基本類型元素訪問器例程名。             

      　　　將 ArrayType 替換爲對應的數組類型。             

      　　　將 NativeType 替換爲該例程對應的本地類型。               

    參數：   env：JNI 接口指針。            

                array：Java 字符串對象。           

                isCopy：指向布爾值的指針。               

    返回值：    返回指向數組元素的指針，若是操做失敗，則爲 NULL。          

             

     無論布爾數組在 Java 虛擬機中如何表示，GetBooleanArrayElements() 將始終返回一個 jbooleans 類型的指針，其中每一

　字節表明一個元素（開包表示）。內存中將確保全部其它類型。

      　     　

            Get<PrimitiveType>ArrayElements 例程         數組類型                  本地類型

                  GetBooleanArrayElements()                   jbooleanArray            jboolean

                  GetByteArrayElements()                         jbyteArray                  jbyte

                  GetCharArrayElements()                        jcharArray                  jchar

                  GetShortArrayElements()                       jshortArray                 jshort

                  GetIntArrayElements()                           jintArray                     jint

                  GetLongArrayElements()                        jlongArray                  jlong

                  GetFloatArrayElements()                        jfloatArray                  jfloat

                  GetDoubleArrayElements()                     jdoubleArray              jdouble

      

                  

      Release<PrimitiveType>ArrayElements 方法類型                

 

  void  Release<PrimitiveType>ArrayElements (JNIEnv *env, ArrayType array, NativeType *elems,jint mode);            

     功能：通知虛擬機平臺相關代碼無需再訪問 elems 的一組函數。elems 參數是一個經過使用對應的

        Get<PrimitiveType>ArrayElements() 函數由 array 導出的指針。必要時，該函數將把對 elems 的修改複製回基本

        類型數組。mode參數將提供有關如何釋放數組緩衝區的信息。若是elems 不是 array 中數組元素的副本，mode將無效。

        不然，mode 將具備下表所述的功能：             

                        模式                                         動做        

                         0                            複製回內容並釋放elems 緩衝區      

                   JNI_COMMIT               複製回內容但不釋放elems 緩衝區  

                   JNI_ABORT                   釋放緩衝區但不復制回變化        

       多數狀況下，編程人員將把「0」傳給 mode 參數以確保固定的數組和複製的數組保持一致。其它選項可使編程人員進一步

   控制內存管理，但使用時務必慎重。             

     使用說明：

         將 ArrayType 替換爲對應的數組類型。             

         將 NativeType 替換爲該例程對應的本地類型。               

    

   參數： env：JNI 接口指針。            

             array：Java 數組對象。                

             elems：指向數組元素的指針。           

             mode：釋放模式。      

 

         Release<PrimitiveType>ArrayElements 方法組         數組類型             本地類型

              ReleaseBooleanArrayElements()                      jbooleanArray       jboolean

              ReleaseByteArrayElements()                           jbyteArray              jbyte

              ReleaseCharArrayElements()                          jcharArray              jchar

              ReleaseShortArrayElements()                         jshortArray             jshort

              ReleaseIntArrayElements()                             jintArray                 jint

              ReleaseLongArrayElements()                       jlongArray             jlong

              ReleaseFloatArrayElements()                       jfloatArray            jfloat

              ReleaseDoubleArrayElements()                   jdoubleArray         jdouble

          

                  

    Get<PrimitiveType>ArrayRegion 方法類型          

 

  void  Get<PrimitiveType>ArrayRegion (JNIEnv *env, ArrayType array,  jsize start, jsize len, NativeType *buf);            

    功能：將基本類型數組某一區域複製到緩衝區中的一組函數。                    

      使用說明：        

               將 Get<PrimitiveType>ArrayRegion 替換爲下表的某個實際基本類型元素訪問器例程名。

               將 ArrayType 替換爲對應的數組類型。             

               將 NativeType 替換爲該例程對應的本地類型。     

   參數：     env：JNI 接口指針。            

                 array：Java 指針。                

                 start：起始下標。                  

                 len：要複製的元素數。                 

                 buf：目的緩衝區。                

   拋出：  ArrayIndexOutOfBoundsException：若是區域中的某個下標無效。  

          

   方法族以下：                      　     　

                    Get<PrimitiveType>ArrayRegion方法           數組類型             本地類型

                        GetBooleanArrayRegion()                          jbooleanArray     jboolean

                        GetByteArrayRegion()                                jbyteArray           jbyte

                        GetCharArrayRegion()                               jcharArray           jchar

                        GetShortArrayRegion()                              jshortArray          jhort

                        GetIntArrayRegion()                                  jintArray              jint

                        GetLongArrayRegion()                               jlongArray          jlong

                        GetFloatArrayRegion()                               jfloatArray         jloat

                        GetDoubleArrayRegion()                           jdoubleArray    jdouble

          

                  

        Set<PrimitiveType>ArrayRegion 方法類型          

 

 void  Set<PrimitiveType>ArrayRegion (JNIEnv *env, ArrayType array,   jsize start, jsize len, NativeType *buf);            

    功能：將基本類型數組的某一區域從緩衝區中複製回來的一組函數。             

        使用說明：  將 Set<PrimitiveType>ArrayRegion 替換爲表中的實際基本類型元素訪問器例程名。          

                          將 ArrayType 替換爲對應的數組類型。             

                          將 NativeType 替換爲該例程對應的本地類型。               

    參數： env：JNI 接口指針。            

              array: Java 數組。              

              start：起始下標。                  

              len：要複製的元素數。                 

              buf：源緩衝區。            

    拋出： ArrayIndexOutOfBoundsException：若是區域中的某個下標無效。 

 　     　

                  Set<PrimitiveType>ArrayRegion 方法族            數組類型             本地類型

                        SetBooleanArrayRegion()                          jbooleanArray     jboolean

                        SetByteArrayRegion()                                jbyteArray           jbyte

                        SetCharArrayRegion()                               jcharArray           jchar

                        SetShortArrayRegion()                              jshortArray          jshort

                        SetIntArrayRegion()                                  jintArray              jint

                        SetLongArrayRegion()                               jlongArray           jlong

                        SetFloatArrayRegion()                               jfloatArray           jfloat

                        SetDoubleArrayRegion()                            jdoubleArray      jdouble

       

   ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

 

 

 6、訪問對象的屬性和方法                  

   

一、實例屬性的訪問

                           

  jfieldID  GetFieldID (JNIEnv *env, jclass clazz, const char *name, const char *sig);                

   功能：返回類的實例（非靜態）域的屬性 ID。該域由其名稱及簽名指定。訪問器函數的Get<type>Field 及 Set<type>Field

        系列使用域 ID 檢索對象域。GetFieldID() 不能用於獲取數組的長度域。應使用GetArrayLength()。          

   參數：  env：JNI 接口指針。            

               clazz：Java 類對象。            

               name: 該屬性的Name名稱                

               sig：   該屬性的域簽名。               

   返回值：屬性ID。若是操做失敗，則返回NULL。              

   拋出： NoSuchFieldError：若是找不到指定的域。                  

              ExceptionInInitializerError：若是因爲異常而致使類初始化程序失敗。          

              OutOfMemoryError：若是系統內存不足。                 

               

   Get<type>Field 例程               

 

   NativeType  Get<type>Field (JNIEnv*env, jobject obj, jfieldID fieldID);                

    功能：該訪問器例程系列返回對象的實例（非靜態）域的值。要訪問的域由經過調用GetFieldID() 而獲得的域 ID 指定。           

    參數：   env：JNI 接口指針。            

                 obj：Java 對象（不能爲 NULL）。               

                 fieldID：有效的域 ID。                 

    返回值：   屬性的內容。      

    　     Get<type>Field 例程名        本地類型        

               GetObjectField()                  jobject     

               GetBooleanField()               jboolean  

               GetByteField()                     jbyte        

               GetCharField()                     jchar        

               GetShortField()                    jshort       

               GetIntField()                        jint  

               GetLongField()                    jlong         

               GetFloatField()                    jfloat        

               GetDoubleField()      jdouble    

 

   Set<type>Field 方法族 

        

  void  Set<type>Field (JNIEnv *env, jobject obj, jfieldID fieldID,  NativeType value);           

  功能： 該訪問器例程系列設置對象的實例（非靜態）屬性的值。要訪問的屬性由經過調用SetFieldID() 而獲得的屬性 ID指定。

   參數：  env：JNI 接口指針。            

               obj：Java 對象（不能爲 NULL）。               

              fieldID：有效的域 ID。                 

              value：域的新值。   

      方法族 以下：                 　    

               Set<type>Field 方法族            本地類型        

                  SetObjectField()                    jobject     

                  SetBooleanField()                  jboolean  

                  SetByteField()                       jbyte        

                  SetCharField()                      jchar        

                  SetShortField()                     jshort       

                  SetIntField()                         jint  

                  SetLongField()                      jlong         

                  SetFloatField()                      jfloat        

                  SetDoubleField()                  jdouble    

 

 二、靜態屬性的訪問 :也存在相同的方法，

 

        jfieldID  GetStaticFieldID (JNIEnv *env,jclass clazz, const char *name, const char *sig);     

       NativeType  GetStatic<type>Field (JNIEnv*env,jclass classzz , jfieldID fieldID);           

            void  SetStatic<type>Field (JNIEnv *env,jclassclasszz, jfieldID fieldID,  NativeType value);           

   

   它們與實例屬性的惟一區別在於第二個參數jclass classzz表明的是類引用，而不是類實例。

        

 三、調用實例方法 

      

   jmethodID GetMethodID(JNIEnv *env, jclass clazz,    const char *name, const char *sig);                

    功能：返回類或接口實例（非靜態）方法的方法 ID。方法可在某個 clazz 的超類中定義，也可從 clazz 繼承。該方法由其名稱

         和簽名決定。 GetMethodID() 可以使未初始化的類初始化。要得到構造函數的方法 ID，應將 <init> 做爲方法名，同時將 

         void (V) 做爲返回類型。          

    參數：  env：JNI 接口指針。            

                clazz：Java 類對象。            

                name：方法名。          

                sig：方法的簽名。           

    返回值： 方法 ID，若是找不到指定的方法，則爲 NULL。             

    拋出：    NoSuchMethodError：若是找不到指定方法。            

                  ExceptionInInitializerError：若是因爲異常而致使類初始化程序失敗。          

                  OutOfMemoryError：若是系統內存不足。                  

                  

  Call<type>Method 例程  、Call<type>MethodA 例程  、Call<type>MethodV 例程 

              

  NativeType Call<type>Method (JNIEnv*en v,  jobject obj , jmethodID methodID, ...);     //參數附加在函數後面,              

  NativeType Call<type>MethodA (JNIEnv *env, jobject obj, jmethodID methodID, jvalue *args);  //參數以指針形式附加  

  NativeType Call<type>MethodV (JNIEnv *env, jobject obj,jmethodID methodID, va_list args); //參數以"鏈表"形式附加

     

  說明：這三個操做的方法用於從本地方法調用Java 實例方法。它們的差異僅在於向其所調用的方法傳遞參數時所用的機制。   

      這三個操做將根據所指定的方法 ID 調用 Java 對象的實例（非靜態）方法。參數 methodID 必須經過調用 GetMethodID() 

      來得到。當這些函數用於調用私有方法和構造函數時，方法 ID 必須從obj 的真實類派生而來，而不該從其某個超類派生。

      固然，附加參數能夠爲空 。

  參數：  env：JNI 接口指針。            

             obj：Java 對象。           

             methodID：方法 ID。                  

  返回值： 返回調用 Java 方法的結果。              

  拋出：  執行 Java 方法時拋出的異常。    

             

     

   下表根據結果類型說明了各個方法類型。用戶應將Call<type>Method 中的 type 替換爲所調用方法的Java 類型（或使用表

 中的實際方法名），同時將 NativeType 替換爲該方法相應的本地類型。省略掉了其餘兩種類型。 

 

           Java層返回值                  方法族                                            本地返回類型NativeType

           返回值爲void ：          CallVoidMethod( )   A / V                               (無)

           返回值爲引用類型：     CallObjectMethod( )                              jobect

           返回值爲boolean ：    CallBooleanMethod ( )                           jboolean

           返回值爲byte ：          CallByteMethod( )                                  jbyte

           返回值爲char  ：         CallCharMethod( )                                 jchar

           返回值爲short             CallShortMethod( )                                jshort       

           返回值爲int   ：          CallIntMethod( )                                     jint  

           返回值爲long：          CallLongMethod()                                   jlong         

           返回值爲float ：         CallFloatMethod()                                   jfloat        

           返回值爲double：      CallDoubleMethod()                                jdouble    

 

 

 四、調用靜態方法：也存在以下方法羣，

 

        jfieldID   GetStaticMethodID (JNIEnv *env,jclass clazz, const char *name, const char *sig);     

       NativeType  Call<type>Method (JNIEnv*env,jclass classzz , jfieldID fieldID);           

       

   它們與於實例方法的惟一區別在於第二個參數jclass classzz表明的是類引用，而不是類實例。

     

  ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

 

7、註冊本地方法                  

                

  jint  RegisterNatives (JNIEnv *env, jclass clazz, const JNINativeMethod *methods,    jint  nMethods);               

   功能：向 clazz 參數指定的類註冊本地方法。methods 參數將指定 JNINativeMethod 結構的數組，其中包含本地方法的名稱、

    簽名和函數指針。nMethods 參數將指定數組中的本地方法數。JNINativeMethod 結構定義以下所示：            

         typedef struct {                       

               char *name;          

               char *signature;               

              void *fnPtr;               

         } JNINativeMethod;                  

     函數指針一般必須有下列簽名：                                  

              ReturnType (*fnPtr)(JNIEnv *env, jobject objectOrClass, ...);                  

                  

   參數： env：JNI 接口指針。            

              clazz：Java 類對象。            

             methods：類中本地方法和具體實現方法的映射指針。               

             nMethods：類中的本地方法數。                 

   返回值：  成功時返回 "0"；失敗時返回負數。         

   拋出：  NoSuchMethodError：若是找不到指定的方法或方法不是本地方法。            

                  

 jint  UnregisterNatives (JNIEnv *env, jclass clazz);              

  功能： 取消註冊類的本地方法。類將返回到連接或註冊了本地方法函數前的狀態。      該函數不該在常規平臺相關代碼中使用。

        相反，它能夠爲某些程序提供一種從新加載和從新連接本地庫的途徑。             

  參數：  env：JNI 接口指針。            

             clazz：Java 類對象。            

  返回值： 成功時返回「0」；失敗時返回負數。                  

 

 ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

 

 

    其實，JNI方面的書籍仍是比較少的，建議你們看看《JNI編程指南》，算的上個入門書籍吧，期望你能耐心點看。