如何在C/C++中調用Java的方法

來自：http://blog.csdn.net/jacksonwj/archive/2005/08/08/448549.aspx

Java跨平臺的特性使Java越來越受開發人員的歡迎，但也往往會聽到不少的抱怨：用Java開發的圖形用戶窗口界面每次在啓動的時候都會跳出一個控制檯窗口，這個控制檯窗口讓本來非常棒的界面失色不少。怎麼能夠讓通過Java開發的GUI程序不彈出Java的控制檯窗口呢？

其實現在很多流行的開發環境例如JBuilder、Eclipse都是使用純Java開發的集成環境。這些集成環境啓動的時候並不會打開一個命令窗口，因爲它使用了JNI（Java Native Interface）的技術。

通過這種技術，開發人員不一定要用命令行來啓動Java程序，可以通過編寫一個本地GUI程序直接啓動Java程序，這樣就可避免另外打開一個命令窗口，讓開發的Java程序更加專業。

JNI允許運行在虛擬機的Java程序能夠與其它語言（例如C和C++）編寫的程序或者類庫進行相互間的調用。同時JNI提供的一整套的API，允許將Java虛擬機直接嵌入到本地的應用程序中。

本文將介紹如何在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打開選項對話框。

將目錄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("<init>:" + 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 <jni.h>
　　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 <jni.h>
　　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)
　　<error handler>
　　jmethodID mid = (*env)->GetMethodID(env,cls,"<init>","(Ljava/lang/String;)V ");
　　if(mid == 0)
　　<error handler>
　　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==NULL||str==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編碼格式字符串
len = WideCharToMultiByte(CP_ACP,0,w_buffer,1024,desc,desc_len,NULL,NULL);
　　//len = wcslen(w_buffer);
　　if(len>0 && len<desc_len)　　 desc[len]=0;
　　delete[] w_buffer;
　　return strlen(desc);
　　}

方法二，將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，但是其中有很大一部分文件並不需要，可以根據實際的應用情況進行刪除。例如程序a如果沒有用到Java Swing，就可以把涉及到Swing的文件都刪除後重新打包。

站內首發文章

xuleicsu

發佈了52 篇原創文章 · 獲贊 18 · 訪問量 49萬+

私信關注

如何在C/C++中調用Java的方法

Delphi與XML專題之二 -----Delphi 與 XML 示例（直接利用IXMLDocument）

計算機科學與技術反思錄

在IE瀏覽器中使用Windows窗體控件

如何在C/C++中調用Java的方法

路由器原理和路由協議、算法詳解

Mac下配置sublime實現LaTeX

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結