Java System.load 与 System.loadLibrary

素颜马尾好姑娘i 2023-10-01 16:39 8阅读 0赞

# `一、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");
    	}
    }