Package com.github.weisj.darklaf.nativeutil

Class NativeUtil

java.lang.Object

com.github.weisj.darklaf.nativeutil.NativeUtil

public final class NativeUtil
extends Object

A simple library class which helps with loading dynamic libraries stored in the JAR archive. These libraries usually contain implementation of some methods in native code (using JNI - Java Native Interface).

See Also:

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

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	NativeUtil.Resource

Field Summary

Fields

Modifier and Type	Field	Description
static final String	NATIVE_FOLDER_PATH_PREFIX

Method Summary

Modifier and Type	Method	Description
static void	loadLibraryFromJar(Class<?> loaderClass, String path, String identifier)	Loads library from current JAR archive
static void	loadLibraryFromJarWithExtraResources(Class<?> loaderClass, String path, List<NativeUtil.Resource> resources, String identifier)	Loads library from current JAR archive

Methods inherited from class java.lang.Object

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

Field Details

NATIVE_FOLDER_PATH_PREFIX

public static final String NATIVE_FOLDER_PATH_PREFIX

See Also:

• Constant Field Values

Method Details

loadLibraryFromJarWithExtraResources

public static void loadLibraryFromJarWithExtraResources(Class<?> loaderClass,
 String path,
 List<NativeUtil.Resource> resources,
 String identifier)
                                                 throws IOException

Loads library from current JAR archive

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:

loaderClass - the class to use for loading.

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

identifier - The library identifier for clean-up purposes

Throws:

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

IllegalArgumentException - If source file (param path) does not exist

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)).

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

loadLibraryFromJar

public static void loadLibraryFromJar(Class<?> loaderClass,
 String path,
 String identifier)
                               throws IOException

Loads library from current JAR archive

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:

loaderClass - the class to use for loading.

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

identifier - The library identifier for clean-up purposes

Throws:

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

IllegalArgumentException - If source file (param path) does not exist

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)).

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