eu.aschuetz.nativeutils.impl

Class NativeLibraryLoaderHelper

java.lang.Object

eu.aschuetz.nativeutils.impl.NativeLibraryLoaderHelper

public class NativeLibraryLoaderHelper
extends Object

Utility to load the native libraries. It can be used to unpack the .so/.dll files from the jar and load them into the jvm. If you wish to manually load the native libraries by other means then don't use it otherwise call loadNativeLibraries before using JavaNativeUtils.

Constructor Summary

Constructors

Constructor and Description
NativeLibraryLoaderHelper()

Method Summary

Modifier and Type	Method and Description
static Map<String,byte[]>	getNativeLibraryBinaries() Helper method to get all shared lib binaries in a map, so you can load them yourself more easily.
static void	load(String file) Shortcut to System.load so it loads a library using JavaNativeUtils Classloader.
static void	loadNativeLibraries() Will load the native libraries if necessary.
static void	loadNativeLibraries(String aPath) Will load the native libraries if necessary.

Methods inherited from class java.lang.Object

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

Constructor Detail

NativeLibraryLoaderHelper

public NativeLibraryLoaderHelper()

Method Detail

loadNativeLibraries

public static void loadNativeLibraries()
                                throws LinkageError

Will load the native libraries if necessary. If the loading fails then a LinkageError is thrown. This method will use the temporary directory to unpack the .dll/.so files (this is necessary as native libraries cannot be loaded from inside the jar) On Windows this is %TEMP% on linux this is /tmp.

Throws:

LinkageError

getNativeLibraryBinaries

public static Map<String,byte[]> getNativeLibraryBinaries()

Helper method to get all shared lib binaries in a map, so you can load them yourself more easily.

load

public static void load(String file)
                 throws LinkageError

Shortcut to System.load so it loads a library using JavaNativeUtils Classloader.

Throws:

LinkageError

loadNativeLibraries

public static void loadNativeLibraries(String aPath)
                                throws LinkageError

Will load the native libraries if necessary. If the loading fails then a LinkageError is thrown. The given path will be used as a directory to unpack the native libraries to. If the directory at the given path does not exist it will be created. If that fails a LinkageError is thrown. This method tries to guess the OS and architecture of your system based on System Properties. Due to lack of documentation this is not perfect and may fail even tho your system would be supported. In this case you may have to load the correct library by hand by calling getSharedLibraryBinaries and writing your desired library to a file and calling load on it.

Throws:

LinkageError