原文網址：http://blog.csdn.net/qinjuning/article/details/7595104

?本文原創，轉載請注明出處：http://blog.csdn.net/qinjuning

?????? ? 最近一段時間，在工作方面比較閑，分配的Bug不是很多，于是好好利用這段時間就著源代碼看了些許模塊，?主要方式

?? 還是賊看賊看代碼，?同時利用燒機的便利，加Log觀看，基本上都能弄個臉熟 。心里想著該寫點什么了？可是水平不夠，再加上

?? 包括很多真正實現地方--中間層，基本上沒看。于是乎，也就不好賣弄了。

?

????? 花了幾天時間研究了下JNI，基本上知道如何使用了。照我的觀點JNI還是不難的，難得只是我們一份嘗試的心。 學習過程中，

??發現關于JNI函數資料真的很少，所謂“工欲善其事，便先利其器”，整理出了這份資料，希望能幫助你克服JNI學習的坎。

?????

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

???? ?同時對其加以了補充 。

???

?

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

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

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

?

???????????2、關于下列有些函數中：*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編程指南》

?

一、類操作?????????????

? ? ? ? ? ? ? ? ??? ? ? ? ??

? 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： ? ? ? ? ? ? ??

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

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

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

?

? ?

?

?????????

二、異常操作 ??? ?? ? ? ? ? ??

? ? ? ? ??? ? ? ? ? ? ??

? 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 ? 錯誤消息。??????????

?????????????

? ?

?????

?

三、全局及局部引用?????????????

? ? ? ? ? ? ? ? ??? ??

? ?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 ?局部引用。????????????

?????????????

? ?

????

?

四、對象操作 ? ?? ? ??

? ? ? ? ??

? 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。 ? ? ? ??

????????

? ?

????

??????????????????

五、?字符串操作?????????????

? ? ? ? ? ? ? ? ?? ? ? ? ? ? ? ??

? 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 字符串的指針。???????????????

?

?

? ?

?????????

六、數組操作 ? ? ? ??? ? ? ??? ? ? ? ?

?

?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

???????

? ?

?

?

?

?六、訪問對象的屬性和方法??????????????????

???

1、實例屬性的訪問

???????????????????????????

??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????

?

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

?

????? ??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代表的是類引用，而不是類實例。

????????

?3、調用實例方法?

??????

? ?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????

?

?

?4、調用靜態方法：也存在如下方法群，

?

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

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

???????

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

?????

??

?

?

七、注冊本地方法??????????????????

????????????????

??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編程指南》，算的上個入門書籍吧，指望你能耐心點看。

?

???? 下一篇，我會繼續整理JNI的基礎知識，包括類型映射、域簽名等；

轉載于:https://www.cnblogs.com/wi100sh/p/4309700.html

總結

以上是生活随笔為你收集整理的【转】JNI学习积累之一 ---- 常用函数大全的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。