Java System.load 与 System.loadLibrary

一、System.load与System.loadLibrary

它们都可以用来装载库文件，不论是JNI库文件还是非JNI库文件。在任何本地方法被调用之前必须先用这个两个方法之一把相应的JNI库文件装载。

• System.load(filename) 中filename参数为库文件的绝对路径，可以是任意路径。例如你可以这样载入一个windows平台下JNI库文件：
  System.load(“D://TestJNI.dll”);
• System.loadLibrary(libname) 中libname参数为库文件名，不包含库文件的扩展名。例如你可以这样载入一个windows平台下JNI库文件：
  System. loadLibrary (“TestJNI”);
  这里，“TestJNI” 必须是在java.library.path这一jvm变量所指向的路径中。
  可以通过如下方法来获得该变量的值：
  System.getProperty(“java.library.path”);
  默认情况下，在Windows平台下，该值包含如下位置：
  • 1）和jre相关的一些目录
  • 2）程序当前目录
  • 3）Windows目录
  • 4）系统目录（system32）
  • 5）系统环境变量path指定目录

二、依赖

如果你要载入的库文件静态链接到其它动态链接库，例如TestJNI.dll 静态链接到dependency.dll, 那么你必须注意：

• 1）如果你选择
  System.load(“D://TestJNI.dll”);
  那么即使你把dependency.dll同样放在D://下，load还是会因为找不到依赖的dll而失败。因为jvm在载入TestJNI.dll会先去载入TestJNI.dll所依赖的库文件dependency.dll，而dependency.dll并不位于java.library.path所指定的目录下，所以jvm找不到dependency.dll。
  你有两个方法解决这个问题：
  • 1、把D://加入到java.library.path的路径中，例如加入到系统的path中。
  • 2、先调用System.load(“D://dependency.dll”); 让jvm先载入dependency.dll，然后再调用System.load(“D://TestJNI.dll”);
• 2）如果你选择
  System. loadLibrary (“TestJNI”);
  那么你只要把dependency.dll放在任何java.library.path包含的路径中即可，当然也包括和TestJNI.dll相同的目录。

三、设置java.library.path

1、通过VM参数设置-Djava.library.path=D:\\lib\\,此方法会覆盖默认值
2、添加系统环境变量path指定目录(windows下设置后需要重启电脑)
3、通过反射机制在代码中设置（直接使用System.setProperty(“java.library.path”,“%ProjectPath%/dll”);是无法设置成功的）
4、设置环境变量LD_LIBRARY_PATH=/test//lib/:$LD_LIBRARY_PATH

/**
* 需要注意，如果jvm实现不是用的变量usr_paths来保存java.library.path的值，
* 这个方法就不适用了。<br>
* 测试发现使用System.getProperty("java.library.path")取到的值中没有包含新加入de值，
* 但是可以正常使用System.loadLibrary(libname)加载指定的库。<br>
**/
public static void addLibraryDir(String libraryPath) throws IOException {
	try {
		Field field = ClassLoader.class.getDeclaredField("usr_paths");
		field.setAccessible(true);
		String[] paths = (String[]) field.get(null);
		for (int i = 0; i < paths.length; i++) {
			if (libraryPath.equals(paths[i])) {
				return;
			}
		}
	
		String[] tmp = new String[paths.length + 1];
		System.arraycopy(paths, 0, tmp, 0, paths.length);
		tmp[paths.length] = libraryPath;
		field.set(null, tmp);
	} catch (IllegalAccessException e) {
		throw new IOException(
				"Failedto get permissions to set library path");
	} catch (NoSuchFieldException e) {
		throw new IOException(
				"Failedto get field handle to set library path");
	}
}