com.github.fommil.jni

Class JniLoader

java.lang.Object

com.github.fommil.jni.JniLoader

public final class JniLoader
extends Object

Simple (for the end user) native library loader.

The static method in this class enables developers to ship native libraries in jar files which are extracted and loaded at runtime, making native loading transparent for the end-user (as long as they are on a supported platform). Native libraries can also be placed in java.library.path for slightly faster startup times.

Field Summary

Fields

Modifier and Type	Field and Description
static String	JNI_EXTRACT_DIR_PROP

Constructor Summary

Constructors

Constructor and Description
JniLoader()

Method Summary

Methods

Modifier and Type	Method and Description
static void	load(String... paths) Attempts to load a native library from the java.library.path and (if that fails) will extract the named file from the classpath into a pre-defined directory ("com.github.fommil.jni.dir", or - if not defined - a temporary directory is created) and load from there.

Methods inherited from class java.lang.Object

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

Field Detail

JNI_EXTRACT_DIR_PROP

public static final String JNI_EXTRACT_DIR_PROP

See Also:

Constant Field Values

Constructor Detail

JniLoader

public JniLoader()

Method Detail

load

public static void load(String... paths)

Attempts to load a native library from the java.library.path and (if that fails) will extract the named file from the classpath into a pre-defined directory ("com.github.fommil.jni.dir", or - if not defined - a temporary directory is created) and load from there.

Will stop on the first successful load of a native library.

Parameters:

paths - alternative relative path of the native library on either the library path or classpath.

Throws:

ExceptionInInitializerError - if the input parameters are invalid or all paths failed to load (making this safe to use in static code blocks).