解析Java和Eclipse中加载本地库(.dll文件)的详细说明
作者：
本篇文章是对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的设置项，也是用于加载本地库的，有待进一步研究
本文匆匆而就，希望对自己对大家都能有所帮助
首先，应当明确，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的设置项，也是用于加载本地库的，有待进一步研究
本文匆匆而就，希望对自己对大家都能有所帮助