解析Java和Eclipse中載入本地庫(.dll檔案)的詳細說明

最近在做的工作要用到本地方法，需要在Java中載入不少動態連結程式庫（以下為方便延用Windows平台下的簡寫dll，但並不局限於Windows）。剛剛把程式跑通，趕緊把一些心得寫出來，mark。也希望對大家的類似工作有所協助
首先，應當明確，dll有兩類：（1）Java所依賴的dll和，（2）dll所依賴的dll。正是由於第（2）種dll的存在，才導致了java中載入dll的複雜性大大增加，許多說法都是這樣的，但我實驗的結果卻表明似乎沒有那麼複雜，後面會予以詳細闡述。
其次，Java中載入dll的方式也有兩種：（1）通過調用System.loadLibrary(String filename)和，（2）通過調用System.load(String filename)方法。其底層都是通過使用ClassLoader中的loadLibrary(Class fromClass, String name, boolean isAbsolute)方法來實現的，區別僅在於（1）中的filename必須是絕對路徑，（2）中的filename只能是dll名，不允許包含檔案夾。
再者，Eclipse是一個相當強大的平台，其提供的BundleClassLoader的強大是一個很重要的原因，對於dll的載入也有自己一套很別緻的做法，值得我們採納。
根據上面的介紹，分兩部分闡述Java中載入dll面臨的主要問題和解決途徑。
1. 在一般Java程式中載入dll
我所做的工作，需要載入的dll如下：
DigitDll.dll
DsivsAcct.dll
DsivsComm.dll
DsivsTrans.dll
JBPack.dll
XCodeDll.dll
ImageDllCtrl.dll
yhfiche.dll
yhocr.dll
yhbill.dll
TSealSvrDll.dll
TImg.dll
TImage.dll
直接調用的是TImage中的若干方法，列表中TImage之前的所有其直接或間接依賴的，不僅要把所有的dll load全，更要注意他們之間的依賴關係，被依賴dll一定要先載入，否則就會報錯：UnsatisfiedLinkError。故而，首先應理清dll 之間的依賴關係，上面的列表已經是處理過的了。

接下來是設定JVM的搜尋路徑，使其能夠找到你的dll。JVM的搜尋路徑由java.library.path系統屬性決定，其預設值為系統內容變數中的PATH 內容。因此，可以通過修改PATH變數來達到設定java.library.path屬性的目的（改變之後Eclipse需要重新啟動），一般的方法是在 PATH中加入dll所在檔案夾的絕對路徑。另一種方法是在Java命令的參數中加入“-Djava.library.path=dll所在檔案夾的絕對路徑”來設定（可以用；分開多個路徑）。對於Eclipse開發環境上的應用程式，可以通過修改其啟動參數，在VM arguments編輯框中加入前述參數。對於打包出來的Eclipse安裝包，可編輯其啟動目錄下的application.ini（假設其開機檔案為 application.exe），在-vmargs後加入前述參數來設定java.library.path的值。需要注意的是，一旦JVM已經啟動，則無法再修改java.library.path的內容了，也就是說，通過：
System.setProperty("java.library.path", "c:/mylib");
這樣的方式是無法達到目的的，因為該屬性是唯讀。Sun公司的論壇上曾經討論過如何在代碼中修改java.library.path的問題，結論是：不能通過代碼修改！如果嫌"java -Djava.library.path=c:/mylib"這樣的方式寫得太死，也只能是通過shell編程之類的方法對路徑進行預先處理，以改善其靈活性了。
如果你的dll是封裝在jar包中的，則需要首先將之解壓縮到一個臨時路徑上，然後再將該路徑加入到Djava.library.path中，或者乾脆將其解壓縮到系統路徑上。
2. 在Eclipse平台上載入dll
上面提到，Java中對本地庫路徑的設定方式做得太死，這也是我自己的切身體會，但令人感到欣慰的是我們的Eclipse平台的提供了一套比較靈活的做法，通過eclipse提供的BundleClassLoader，你可以將dll封在plugin中，既不需要在使用時解壓縮，也不需要額外設定 java.library.path屬性，BundleClassLoader會自行到以相對plugin根目錄的指定目錄下去尋找你的dll，這些目錄是：ws/win32/, os/win32/x86/, os/win32/, nl/zh/CN/, nl/zh/，見org.eclipse.osgi.internal.baseadaptor.DefaultClassLoader和 org.eclipse.core.runtime.internal.adaptor.EclipseClassLoadingHook。
我的目錄設定是：
.classpath
.cvsignore
.project
build.properties
classes
CVS
lib
META-INF
os
plugin.xml
src
我把所有的dll都放到了os下面的win32目錄內，同樣可以建立ws/win32等目錄用於放置本地庫。如此處理之後，不用再修改任何系統變數就可以順利載入本地庫了。
另外，Eclipse還在MANIFEST檔案中提供了Bundle-NativeCode的設定項，也是用於載入本地庫的，有待進一步研究
本文匆匆而就，希望對自己對大家都能有所協助