解析Java和Eclipse中加载本地库(.dll文件)的详细说明
更新时间：2013年05月17日 11:15:16 作者：
本篇文章是对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的设置项，也是用于加载本地库的，有待进一步研究
本文匆匆而就，希望对自己对大家都能有所帮助
相关文章
这篇文章主要为大家介绍了针对Dubbo接口Mock的解决方案详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪2023-09-09
数据库连接池在编写应用服务是经常需要用到的模块，太过频繁的连接数据库对服务性能来讲是一个瓶颈，使用缓冲池技术可以来消除这个瓶颈，本文就来介绍Java常见的几种，感兴趣的可以了解一下2021-05-05
哈哈！经过一个阶段的学习，Java基础知识学习终于到多线程了！Java多线程以及后面互斥锁的概念都是Java基础学习的难点，所以我做了一个总结，希望对大家也有帮助2022-05-05
本篇文章主要介绍了SpringBoot 实战 之 优雅终止服务的方法，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧2018-05-05
这篇文章主要介绍了快速入门HarmonyOS的Java UI框架,本文给大家介绍的非常详细对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2020-09-09
SpringBoot mybatis-plus使用json字段实战指南
在现代应用开发中经常会使用JSON格式存储和传输数据,为了便捷地处理数据库中的JSON字段,MyBatis-Plus提供了强大的JSON处理器,这篇文章主要给大家介绍了关于SpringBoot mybatis-plus使用json字段的相关资料,需要的朋友可以参考下2024-01-01
下面小编就为大家带来一篇深入剖析构建JSON字符串的三种方式(推荐)。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧2017-10-10
String代表字符串,Java 程序中的所有字符串字面值(如 "abc" )都作为此类的实例实现,这篇文章主要给大家介绍了关于java中String类的相关资料,需要的朋友可以参考下2021-10-10
掌握Java运算符技巧,能让你的编程之旅轻松许多,本指南将带你深入了解如何巧妙地使用这些强大的工具,让代码不仅高效,还充满乐趣,跟着我们一起,让你的Java代码在运算符的魔法下焕发新生！2023-12-12
这篇文章主要介绍了关于SpringSecurity的基本使用示例,SpringSecurity 本质是一个过滤器链SpringSecurity 采用的是责任链的设计模式，它有一条很长的过滤器链,需要的朋友可以参考下2023-05-05
最新评论