如何在Java中調(diào)用DLL方法
Java語言本身具有跨平臺性,如果通過Java調(diào)用DLL的技術(shù)方便易用,使用Java開發(fā)前臺界面可以更快速,也能帶來跨平臺性。
Java調(diào)用C/C寫好的DLL庫時,由于基本數(shù)據(jù)類型不同、使用字節(jié)序列可能有差異,所以在參數(shù)傳遞過程中容易出現(xiàn)問題。
使用Java調(diào)用DLL動態(tài)鏈接庫的方案通常有三種:JNI, Jawin, Jacob. 其中JNI(Java Native Interface)是Java語言本身提供的調(diào)用本地已編譯的函數(shù)庫的方法,本身具有跨平臺性,可以在不同的機器上調(diào)用不同的本地庫。Jawin和 Jacob都是sourceforge.net的開源項目,都是基于JNI技術(shù)的依賴Windows的實現(xiàn),使得在Windows平臺下使用COM和 DLL的更加方便。
JNI
JNI的應(yīng)用方案是基于Java類和本地函數(shù)相映射的。其使用Java調(diào)用DLL的步驟還是相對比較麻煩,不但涉及到Java編程,還涉及到C/C編程。
JNI的使用步驟是:
1.編寫Java類,用該類將DLL對外提供的函數(shù)服務(wù)進行聲明,其中的Java方法均聲明為native,其方法簽名可以自定義,不用實現(xiàn)函數(shù)體。
2.用Javah工具將該Java類生成對應(yīng)的.h頭文件。
3.最重要的比較麻煩的一步:編寫C/C代碼實現(xiàn).h頭文件中聲明的函數(shù),該C/C代碼中包含jni.h頭文件,并且編寫代碼時使用其中定義好的數(shù)據(jù)類型作為函數(shù)的輸入和返回數(shù)據(jù)類型進行編程。用這種方法實現(xiàn)數(shù)據(jù)類型轉(zhuǎn)換。例如數(shù)據(jù)類型:boolean(java) à jboolean(jni.h: typedef unsigned char jboolean),在自己編寫的C/C代碼中使用數(shù)據(jù)類型jboolean映射Java中的boolean類型。在該步驟中,可以在C/C代碼中調(diào)用已經(jīng)存在的DLL庫。
4.另外編寫的Java代碼時就可以使用該Java類了。
在第3步中,編寫C/C函數(shù)時,可以使用一個叫interface pointer的env指針來調(diào)用JNI提供的一系列(很多)函數(shù),用這些函數(shù)來訪問JVM的對象和數(shù)據(jù)。
使用JNI的缺點:使用比較麻煩,需要對已有的DLL進行封裝,需要對C/C比較了解。
使用JNI的優(yōu)點:可以跨平臺調(diào)用本地庫。
Jawin
Jawin的應(yīng)用方案是基于函數(shù)調(diào)用時采用原始字節(jié)流傳遞數(shù)據(jù)的。就是在Java中指明一個DLL中的某個函數(shù)后,通過原始字節(jié)流(需要考慮參數(shù)數(shù)據(jù)類型所占的存儲字節(jié)數(shù)及系統(tǒng)使用的字節(jié)序列)傳遞給該DLL函數(shù)需要的參數(shù),其返回值也是通過原始字節(jié)流解析的方式獲得正確的值。
Jawin的使用步驟:
1.環(huán)境配置:下載Jawin;Jawin.dll放入工程目錄下;Jawin.jar相關(guān)jar文件加入到運行庫中(LibPath或者Eclipse下配置工程的BuildPath-AddLibrary)。
2.獲得函數(shù)指針:new FuncPtr("DllFileName.DLL", "dllFunctionName");
3.用LittleEndianOutputStream將函數(shù)需要的參數(shù)寫入到一個原始字節(jié)流NakedByteStream。
4.最重要的一步:調(diào)用FuncPtr.invoke()。傳入?yún)?shù)比較復雜。
5.解析上一步的返回值(字節(jié)數(shù)組)。
第4步中傳入的參數(shù)包括:
1.指令字符串。一個"XXX:Y:ZZZ"格式的字符串。其含義分別是傳入?yún)?shù)中的每個字節(jié)的數(shù)據(jù)類型意義、返回值的類型、需要從傳入指針中讀取的數(shù)據(jù)(inout類型參數(shù))。比如:
函數(shù)簽名int func(int, int, struct s*, char*); //其中struct s*調(diào)用完函數(shù)后需要讀出,struct s所占字節(jié)數(shù)為16。
其指令字符串為:IIP16G:I4L4n16L4。該字符串在解析返回值(字節(jié)數(shù)組)時,首先應(yīng)該是返回類型I對應(yīng)的4個字節(jié),然后是inout類型的參數(shù)中n16對應(yīng)的16個字節(jié)。
其中字符串的意義可以在Jawin提供的文件instructions.h中找到,或者在官方文檔(Jawin數(shù)據(jù)指令)中找到常用的一些指令字符串的意義。
2.傳入?yún)?shù)的總字節(jié)大小。
3.前面寫好的傳入?yún)?shù)的原始字節(jié)流。
4.一個object數(shù)組。
5.ReturnFlags,用以根據(jù)C/C返回值將C/C的錯誤轉(zhuǎn)換為Java的異常并拋出。其中CHECK_NONE表示不檢查;CHECK_FALSE和CHECK_WIN32分別表示返回0是FALSE和 SUCCESS,根據(jù)是否出錯決定是否拋出異常;CHECK_HRESULT表示使用COM模型中的HRESULT作為返回值,其錯誤碼可以配置。
使用Jawin的缺點:不方便調(diào)試,幾乎所有的錯誤都拋出同樣的異常COMException;需要對數(shù)據(jù)類型的轉(zhuǎn)換比較了解;不能跨平臺,對Windows的依賴性比較強。
使用Jawin的優(yōu)點:方便使用,不用進行C/C開發(fā),不用對原始DLL進行封裝就可以方便使用。
Jacob
Jacob是Java-Com Bridge的縮寫,也可以用來調(diào)用DLL。其底層也是使用JNI實現(xiàn),也具有Windows 的平臺依賴性,但是網(wǎng)上有人反映其易用性不如jawin。
【編輯推薦】