如何在C/C++中調用Java

轉的一篇文章，看的不懂，先坐下記錄吧~~~

java跨平臺的特性使Java愈來愈受開發人員的歡迎，但也每每會聽到很多的抱怨：用Java開發的圖形用戶窗口界面每次在啓動的時候都會跳出一個控制檯窗口，這個控制檯窗口讓原本很是棒的界面失色很多。怎麼可以讓經過Java開發的GUI程序不彈出Java的控制檯窗口呢？其實如今不少流行的開發環境例如JBuilder、Eclipse都是使用純Java開發的集成環境。這些集成環境啓動的時候並不會打開一個命令窗口，由於它使用了JNI（Java Native Interface）的技術。經過這種技術，開發人員不必定要用命令行來啓動Java程序，能夠經過編寫一個本地GUI程序直接啓動Java程序，這樣就可避免另外打開一個命令窗口，讓開發的Java程序更加專業。

JNI答應運行在虛擬機的Java程序可以與其它語言（例如C和C++）編寫的程序或者類庫進行相互間的調用。同時JNI提供的一整套的API，答應將Java虛擬機直接嵌入到本地的應用程序中。圖1是Sun站點上對JNI的基本結構的描述。

本文將介紹如何在C/C++中調用Java方法，並結合可能涉及到的問題介紹整個開發的步驟及可能碰到的難題和解決方法。本文所採用的工具是Sun公司建立的 Java Development Kit (JDK) 版本 1.3.1，以及微軟公司的Visual C++ 6開發環境。

環境搭建

爲了讓本文如下部分的代碼可以正常工做，咱們必須創建一個完整的開發環境。首先須要下載並安裝JDK 1.3.1，其下載地址爲「http://java.sun.com」。假設安裝路徑爲C：\JDK。下一步就是設置集成開發環境，經過Visual C++ 6的菜單Tools→Options打開選項對話框如圖2。

將目錄C:\JDK\include和C:\JDK\include\win32加入到開發環境的Include Files目錄中，同時將C:\JDK\lib目錄添加到開發環境的Library Files目錄中。這三個目錄是JNI定義的一些常量、結構及方法的頭文件和庫文件。集成開發環境已經設置完畢，同時爲了執行程序須要把Java虛擬機所用到的動態連接庫所在的目錄C:\JDK \jre\bin\classic設置到系統的Path環境變量中。這裏須要提出的是，某些開發人員爲了方便直接將JRE所用到的DLL文件直接拷貝到系統目錄下。這樣作是不行的，將致使初始化Java虛擬機環境失敗（返回值-1），緣由是Java虛擬機是以相對路徑來尋找所用到的庫文件和其它一些相關文件的。至此整個JNI的開發環境設置完畢，爲了讓這次JNI旅程可以順利進行，還必須先預備一個Java類。在這個類中將用到Java中幾乎全部有表明性的屬性及方法，如靜態方法與屬性、數組、異常拋出與捕捉等。咱們定義的Java程序(Demo.java)以下，本文中全部的代碼演示都將基於該Java程序，代碼以下：

package jni.test; /** * 該類是爲了演示JNI如何訪問各類對象屬性等 * @author liudong */ public class Demo { //用於演示如何訪問靜態的基本類型屬性 public static int COUNT = 8; //演示對象型屬性 public String msg; PRivate int[] counts; public Demo() { this("缺省構造函數"); } /** * 演示如何訪問構造器 */ public Demo(String msg) { System.out.println(":" + msg); this.msg = msg; this.counts = null; } /** * 該方法演示如何訪問一個訪問以及中文字符的處理 */ public String getMessage() { return msg; } /** * 演示數組對象的訪問 */ public int[] getCounts() { return counts; } /** * 演示如何構造一個數組對象 */ public void setCounts(int[] counts) { this.counts = counts; } /** * 演示異常的捕捉 */ public void throwExcp() throws IllegalaccessException { throw new IllegalAccessException("exception occur."); } }

初始化虛擬機

本地代碼在調用Java方法以前必須先加載Java虛擬機，然後全部的Java程序都在虛擬機中執行。爲了初始化Java虛擬機，JNI提供了一系列的接口函數Invocation API。經過這些API能夠很方便地將虛擬機加載到內存中。建立虛擬機能夠用函數 jint JNI_CreateJavaVM(JavaVM **pvm, void **penv, void *args)。對於這個函數有一點須要注重的是，在JDK 1.1中第三個參數老是指向一個結構JDK1_ 1InitArgs， 這個結構沒法徹底在全部版本的虛擬機中進行無縫移植。在JDK 1.2中已經使用了一個標準的初始化結構JavaVMInitArgs來替代JDK1_1InitArgs。下面咱們分別給出兩種不一樣版本的示例代碼。

在JDK 1.1初始化虛擬機:

#include int main() { JNIEnv *env; JavaVM *jvm; JDK1_1InitArgs vm_args; jint res; /* IMPORTANT: 版本號設置必定不能漏 */ vm_args.version = 0x00010001; /*獲取缺省的虛擬機初始化參數*/ JNI_GetDefaultJavaVMInitArgs(&vm_args); /* 添加自定義的類路徑 */ sprintf(classpath, "%s%c%s", vm_args.classpath, PATH_SEPARATOR, USER_CLASSPATH); vm_args.classpath = classpath; /*設置一些其餘的初始化參數*/ /* 建立虛擬機 */ res = JNI_CreateJavaVM(&jvm,&env,&vm_args); if (res < 0) { fprintf(stderr, "Can't create Java VM\n"); exit(1); } /*釋放虛擬機資源*/ (*jvm)->DestroyJavaVM(jvm); }

JDK 1.2初始化虛擬機：

/* invoke2.c */ #include int main() { int res; JavaVM *jvm; JNIEnv *env; JavaVMInitArgs vm_args; JavaVMOption options[3]; vm_args.version=JNI_VERSION_1_2;//這個字段必須設置爲該值 /*設置初始化參數*/ options[0].optionString = "-Djava.compiler=NONE"; options[1].optionString = "-Djava.class.path=."; options[2].optionString = "-verbose:jni";//用於跟蹤運行時的信息 /*版本號設置不能漏*/ vm_args.version = JNI_VERSION_1_2; vm_args.nOptions = 3; vm_args.options = options; vm_args.ignoreUnrecognized = JNI_TRUE; res = JNI_CreateJavaVM(&jvm, (void**)&env, &vm_args); if (res < 0) { fprintf(stderr, "Can't create Java VM\n"); exit(1); } (*jvm)->DestroyJavaVM(jvm); fprintf(stdout, "Java VM destory.\n"); }

爲了保證JNI代碼的可移植性，建議使用JDK 1.2的方法來建立虛擬機。JNI_CreateJavaVM函數的第二個參數JNIEnv *env，就是貫穿整個JNI始末的一個參數，由於幾乎全部的函數都要求一個參數就是JNIEnv *env。

訪問類方法

初始化了Java虛擬機後，就能夠開始調用Java的方法。要調用一個Java對象的方法必須通過幾個步驟：

1.獲取指定對象的類定義(jclass)

有兩種途徑來獲取對象的類定義：第一種是在已知類名的狀況下使用FindClass來查找對應的類。可是要注重類名並不一樣於平時寫的Java代碼，例如要獲得類jni.test.Demo的定義必須調用以下代碼：

jclass cls = (*env)->FindClass(env, "jni/test/Demo");//把點號換成斜槓

而後經過對象直接獲得其所對應的類定義：

jclass cls = (*env)-> GetObjectClass(env, obj); //其中obj是要引用的對象，類型是jobject

2.讀取要調用方法的定義(jmethodID)

咱們先來看看JNI中獲取方法定義的函數：

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

這兩個函數的區別在於GetStaticMethodID是用來獲取靜態方法的定義，GetMethodID則是獲取非靜態的方法定義。這兩個函數都須要提供四個參數：env就是初始化虛擬機獲得的JNI環境；第二個參數class是對象的類定義，也就是第一步獲得的obj；第三個參數是方法名稱；最重要的是第四個參數，這個參數是方法的定義。由於咱們知道Java中答應方法的多態，僅僅是經過方法名並無辦法定位到一個具體的方法，所以須要第四個參數來指定方法的具體定義。可是怎麼利用一個字符串來表示方法的具體定義呢？JDK中已經預備好一個反編譯工具javap，經過這個工具就能夠獲得類中每一個屬性、方法的定義。下面就來看看jni.test.Demo的定義：

打開命令行窗口並運行 javap -s -p jni.test.Demo 獲得運行結果以下：

Compiled from Demo.java public class jni.test.Demo extends java.lang.Object { public static int COUNT; /* I */ public java.lang.String msg; /* Ljava/lang/String; */ private int counts[]; /* [I */ public jni.test.Demo(); /* ()V */ public jni.test.Demo(java.lang.String); /* (Ljava/lang/String;)V */ public java.lang.String getMessage(); /* ()Ljava/lang/String; */ public int getCounts()[]; /* ()[I */ public void setCounts(int[]); /* ([I)V */ public void throwExcp() throws java.lang.IllegalAccessException; /* ()V */ static {}; /* ()V */ }

咱們看到類中每一個屬性和方法下面都有一段註釋。註釋中不包含空格的內容就是第四個參數要填的內容(關於javap具體參數請查詢JDK的使用幫助)。下面這段代碼演示如何訪問jni.test.Demo的getMessage方法：

/* 假設咱們已經有一個jni.test.Demo的實例obj */ jmethodID mid; jclass cls = (*env)-> GetObjectClass (env, obj);//獲取實例的類定義 mid=(*env)->GetMethodID(env,cls,"getMessage"," ()Ljava/lang/String; "); /*假如mid爲0表示獲取方法定義失敗*/ jstring msg = (*env)-> CallObjectMethod(env, obj, mid); /* 假如該方法是靜態的方法那隻須要將最後一句代碼改成如下寫法便可： jstring msg = (*env)-> CallStaticObjectMethod(env, cls, mid); */

3.調用方法

爲了調用對象的某個方法，可使用函數CallMethod或者CallStaticMethod（訪問類的靜態方法），根據不一樣的返回類型而定。這些方法都是使用可變參數的定義，假如訪問某個方法須要參數時，只須要把全部參數按照順序填寫到方法中就能夠。在講到構造函數的訪問時，將演示如何訪問帶參數的構造函數。

訪問類屬性

訪問類的屬性與訪問類的方法大致上是一致的，只不過是把方法變成屬性而已。

1.獲取指定對象的類(jclass)

這一步與訪問類方法的第一步徹底相同，具體使用參看訪問類方法的第一步。

2.讀取類屬性的定義(jfieldID)

在JNI中是這樣定義獲取類屬性的方法的：

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

這兩個函數中第一個參數爲JNI環境；clazz爲類的定義；name爲屬性名稱；第四個參數一樣是爲了表達屬性的類型。前面咱們使用javap工具獲取類的具體定義的時候有這樣兩行：

public java.lang.String msg; /* Ljava/lang/String; */

其中第二行註釋的內容就是第四個參數要填的信息，這跟訪問類方法時是相同的。

3.讀取和設置屬性值

有了屬性的定義要訪問屬性值就很輕易了。有幾個方法用來讀取和設置類的屬性，它們是：GetField、SetField、GetStaticField、SetStaticField。好比讀取Demo類的msg屬性就能夠用GetObjectField，而訪問COUNT用GetStaticIntField，相關代碼以下：

jfieldID field = (*env)->GetFieldID(env,obj,"msg"," Ljava/lang/String;"); jstring msg = (*env)-> GetObjectField(env, cls, field);//msg就是對應Demo的msg jfieldID field2 = (*env)->GetStaticFieldID(env,obj,"COUNT","I"); jint count = (*env)->GetStaticIntField(env,cls,field2);

訪問構造函數

不少人剛剛接觸JNI的時候每每會在這一節碰到問題，查遍了整個jni.h看到這樣一個函數NewObject，它應該是能夠用來訪問類的構造函數。可是該函數須要提供構造函數的方法定義，其類型是jmethodID。從前面的內容咱們知道要獲取方法的定義首先要知道方法的名稱，可是構造函數的名稱怎麼來填寫呢？其實訪問構造函數與訪問一個普通的類方法大致上是同樣的，唯一不一樣的只是方法名稱不一樣及方法調用時不一樣而已。訪問類的構造函數時方法名必須填寫「」。下面的代碼演示如何構造一個Demo類的實例：

jclass cls = (*env)->FindClass(env, "jni/test/Demo"); /** 首先經過類的名稱獲取類的定義，至關於Java中的Class.forName方法 */ if (cls == 0) jmethodID mid = (*env)->GetMethodID(env,cls,"","(Ljava/lang/String;)V "); if(mid == 0) jobject demo = jenv->NewObject(cls,mid,0); /** 訪問構造函數必須使用NewObject的函數來調用前面獲取的構造函數的定義 上面的代碼咱們構造了一個Demo的實例並傳一個空串null */

數組處理

建立一個新數組

要建立一個數組，咱們首先應該知道數組元素的類型及數組長度。JNI定義了一批數組的類型jArray及數組操做的函數NewArray，其中就是數組中元素的類型。例如，要建立一個大小爲10而且每一個位置值分別爲1－10的整數數組，編寫代碼以下：

int i = 1; jintArray array;//定義數組對象 (*env)-> NewIntArray(env, 10); for(; i<= 10; i++) (*env)->SetIntArrayRegion(env, array, i-1, 1, &i);

訪問數組中的數據

訪問數組首先應該知道數組的長度及元素的類型。如今咱們把建立的數組中的每一個元素值打印出來，代碼以下：

int i; /* 獲取數組對象的元素個數 */ int len = (*env)->GetArrayLength(env, array); /* 獲取數組中的全部元素 */ jint* elems = (*env)-> GetIntArrayElements(env, array, 0); for(i=0; i< len; i++) printf("ELEMENT %d IS %d\n", i, elems[i]);

中文處理

中文字符的處理每每是讓人比較頭疼的事情，非凡是使用Java語言開發的軟件，在JNI這個問題更加突出。因爲Java中全部的字符都是Unicode編碼，可是在本地方法中，例如用VC編寫的程序，假如沒有非凡的定義通常都沒有使用Unicode的編碼方式。爲了讓本地方法可以訪問Java中定義的中文字符及Java訪問本地方法產生的中文字符串，我定義了兩個方法用來作相互轉換。

· 方法一，將Java中文字符串轉爲本地字符串

/** 第一個參數是虛擬機的環境指針第二個參數爲待轉換的Java字符串定義第三個參數是本地存儲轉換後字符串的內存塊第三個參數是內存塊的大小 */ int JStringToChar(JNIEnv *env, jstring str, LPTSTR desc, int desc_len) { int len = 0; if(desc==NULLstr==NULL) return -1; //在VC中wchar_t是用來存儲寬字節字符(UNICODE)的數據類型 wchar_t *w_buffer = new wchar_t[1024]; ZeroMemory(w_buffer,1024*sizeof(wchar_t)); //使用GetStringChars而不是GetStringUTFChars wcscpy(w_buffer,env->GetStringChars(str,0)); env->ReleaseStringChars(str,w_buffer); ZeroMemory(desc,desc_len); //調用字符編碼轉換函數(Win32 API)將UNICODE轉爲ASCII編碼格式字符串 //關於函數WideCharToMultiByte的使用請參考MSDN len = WideCharToMultiByte(CP_ACP,0,w_buffer,1024,desc,desc_len,NULL,NULL); //len = wcslen(w_buffer); if(len>0 && len

· 方法二，將C的字符串轉爲Java能識別的Unicode字符串

jstring NewJString(JNIEnv* env,LPCTSTR str) { if(!env !str) return 0; int slen = strlen(str); jchar* buffer = new jchar[slen]; int len = MultiByteToWideChar(CP_ACP,0,str,strlen(str),buffer,slen); if(len>0 && len < slen) buffer[len]=0; jstring js = env->NewString(buffer,len); delete [] buffer; return js; }

異常

因爲調用了Java的方法，所以不免產生操做的異常信息。這些異常沒有辦法經過C++自己的異常處理機制來捕捉到，但JNI能夠經過一些函數來獲取Java中拋出的異常信息。以前咱們在Demo類中定義了一個方法throwExcp，下面將訪問該方法並捕捉其拋出來的異常信息，代碼以下：

/** 假設咱們已經構造了一個Demo的實例obj，其類定義爲cls */ jthrowable excp = 0;/* 異常信息定義 */ jmethodID mid=(*env)->GetMethodID(env,cls,"throwExcp","()V"); /*假如mid爲0表示獲取方法定義失敗*/ jstring msg = (*env)-> CallVoidMethod(env, obj, mid); /* 在調用該方法後會有一個IllegalAccessException的異常拋出 */ excp = (*env)->ExceptionOccurred(env); if(excp){ (*env)->ExceptionClear(env); //經過訪問excp來獲取具體異常信息 /* 在Java中，大部分的異常信息都是擴展類java.lang.Exception，所以能夠訪問excp的toString 或者getMessage來獲取異常信息的內容。訪問這兩個方法同前面講到的如何訪問類的方法是相同的。 */ }

線程和同步訪問

有些時候須要使用多線程的方式來訪問Java的方法。咱們知道一個Java虛擬機是很是消耗系統的內存資源，差很少每一個虛擬機須要內存大約在20MB左右。爲了節省資源要求每一個線程使用的是同一個虛擬機，這樣在整個的JNI程序中只須要初始化一個虛擬機就能夠了。全部人都是這樣想的，可是一旦子線程訪問主線程建立的虛擬機環境變量，系統就會出現錯誤對話框，而後整個程序終止。

其實這裏面涉及到兩個概念，它們分別是虛擬機(JavaVM *jvm)和虛擬機環境（JNIEnv *env）。真正消耗大量系統資源的是jvm而不是env，jvm是答應多個線程訪問的，可是env只能被建立它自己的線程所訪問，並且每一個線程必須建立本身的虛擬機環境env。這時候會有人提出疑問，主線程在初始化虛擬機的時候就建立了虛擬機環境env。爲了讓子線程可以建立本身的env，JNI提供了兩個函數：AttachCurrentThread和DetachCurrentThread。下面代碼就是子線程訪問Java方法的框架：

DWord WINAPI ThreadProc(PVOID dwParam) { JavaVM jvm = (JavaVM*)dwParam;/* 將虛擬機經過參數傳入 */ JNIEnv* env; (*jvm)-> AttachCurrentThread(jvm, (void**)&env, NULL); ......... (*jvm)-> DetachCurrentThread(jvm); }

時間

關於時間的話題是我在實際開發中碰到的一個問題。當要發佈使用了JNI的程序時，並不必定要求客戶要安裝一個Java運行環境，由於能夠在安裝程序中打包這個運行環境。爲了讓打包程序利於下載，這個包要比較小，所以要去除JRE（Java運行環境）中一些沒必要要的文件。可是假如程序中用到Java中的日曆類型，例如java.util.Calendar等，那麼有個文件必定不能去掉，這個文件就是[JRE]\lib\tzmappings。它是一個時區映射文件，一旦沒有該文件就會發現時間操做上常常出現與正確時間相差幾個小時的狀況。下面是打包JRE中必不可少的文件列表(以Windows環境爲例)，其中[JRE]爲運行環境的目錄，同時這些文件之間的相對路徑不能變。

文件名目錄 hpi.dll [JRE]\bin ioser12.dll [JRE]\bin java.dll [JRE]\bin net.dll [JRE]\bin verify.dll [JRE]\bin zip.dll [JRE]\bin jvm.dll [JRE]\bin\classic rt.jar [JRE]\lib tzmappings [JRE]\lib

因爲rt.jar有差很少10MB，可是其中有很大一部分文件並不須要，能夠根據實際的應用狀況進行刪除。例如程序假如沒有用到Java Swing，就能夠把涉及到Swing的文件都刪除後從新打包。