net.gdface.utils

Class NativeUtils

java.lang.Object

net.gdface.utils.NativeUtils

public class NativeUtils
extends java.lang.Object

从jar包中加载指定路径下的动态库

See Also:

http://adamheinrich.com/blog/2012/how-to-load-native-jni-library-from-jar, https://github.com/adamheinrich/native-utils

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	NATIVE_FOLDER_PATH_PREFIX

Method Summary

Modifier and Type	Method and Description
static java.io.File	copyToTempFromJar(java.lang.String path)
static java.io.File	copyToTempFromJar(java.lang.String path, java.lang.Class<?> loadClass) copy file from current JAR archive to system temporary directory The file from JAR is copied into system temporary directory and then loaded.
static java.io.File	getTemporaryDir()
static void	loadFromJar(java.lang.String name) 从jar包中位置'/lib/os_prefix'加载指定名字的动态库 os_prefix由Platform.getNativeLibraryResourcePrefix()计算
static void	loadLibraryFromJar(java.lang.String path) 从jar包中加载指定的动态库
static void	loadLibraryFromJar(java.lang.String path, java.lang.Class<?> loadClass) Loads library from current JAR archive
static void	loadLibraryFromResource(java.lang.String name, java.lang.Class<?> loaderClass) 从资源中加载动态库

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NATIVE_FOLDER_PATH_PREFIX

public static final java.lang.String NATIVE_FOLDER_PATH_PREFIX

See Also:

Constant Field Values

Method Detail

loadLibraryFromJar

public static void loadLibraryFromJar(java.lang.String path,
                                      java.lang.Class<?> loadClass)
                               throws java.io.IOException

Loads library from current JAR archive

Throws:

java.io.IOException

See Also:

copyToTempFromJar(String, Class)

copyToTempFromJar

public static java.io.File copyToTempFromJar(java.lang.String path,
                                             java.lang.Class<?> loadClass)
                                      throws java.io.IOException

copy file from current JAR archive to system temporary directory The file from JAR is copied into system temporary directory and then loaded. The temporary file is deleted after exiting. Method uses String as filename because the pathname is "abstract", not system-dependent.

Parameters:

path - The path of file inside JAR as absolute path (beginning with '/'), e.g. /package/File.ext

loadClass - class that provide ClassLoader to load library file by input stream,if null, current class instead.

Throws:

java.io.IOException - If temporary file creation or read/write operation fails

java.lang.IllegalArgumentException - If the path is not absolute or if the filename is shorter than three characters (restriction of File.createTempFile(java.lang.String, java.lang.String)).

java.io.FileNotFoundException - If the file could not be found inside the JAR.

copyToTempFromJar

public static java.io.File copyToTempFromJar(java.lang.String path)
                                      throws java.io.IOException

Throws:

java.io.IOException

See Also:

#copyToTempFromJar(String, Class)}

loadLibraryFromJar

public static void loadLibraryFromJar(java.lang.String path)
                               throws java.io.IOException

从jar包中加载指定的动态库

Parameters:

path -

Throws:

java.io.IOException

See Also:

#loadLibraryFromJar(String, Class)}

loadFromJar

public static void loadFromJar(java.lang.String name)
                        throws java.io.IOException

从jar包中位置'/lib/os_prefix'加载指定名字的动态库
os_prefix由Platform.getNativeLibraryResourcePrefix()计算

Parameters:

name - 库名

Throws:

java.io.IOException

See Also:

#loadLibraryFromJar(String, Class)}

getTemporaryDir

public static java.io.File getTemporaryDir()

loadLibraryFromResource

public static void loadLibraryFromResource(java.lang.String name,
                                           java.lang.Class<?> loaderClass)
                                    throws java.io.IOException

从资源中加载动态库

Parameters:

name - 动态库名,参见 System.loadLibrary(String)

loaderClass -

Throws:

java.io.IOException