com.goterl.lazysodium.utils

Class LibraryLoader

java.lang.Object

com.goterl.lazysodium.utils.LibraryLoader

public final class LibraryLoader
extends java.lang.Object

A simple library class which helps with loading dynamic sodium library stored in the JAR archive. Works with JNA.

This class is thread-safe.

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 and Description
static class	LibraryLoader.Mode Library loading mode controls which libraries are attempted to be loaded (installed in the system or bundled in the Lazysodium JAR) and in which order.

Constructor Summary

Constructors

Constructor and Description
LibraryLoader(java.util.List<java.lang.Class> classesToRegister)

Method Summary

Modifier and Type	Method and Description
static java.lang.String	getSodiumPathInResources() Returns the absolute path to sodium library inside JAR (beginning with '/'), e.g.
void	loadAbsolutePath(java.lang.String absPath)
void	loadLibrary(LibraryLoader.Mode mode, java.lang.String systemFallBack) Loads the sodium library and registers the native methods of Sodium and SodiumJava using the specified loading mode.
void	loadSystemLibrary(java.lang.String library)

Methods inherited from class java.lang.Object

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

Constructor Detail

LibraryLoader

public LibraryLoader(java.util.List<java.lang.Class> classesToRegister)

Method Detail

loadLibrary

public void loadLibrary(LibraryLoader.Mode mode,
                        java.lang.String systemFallBack)

Loads the sodium library and registers the native methods of Sodium and SodiumJava using the specified loading mode. The library will be loaded at most once.

Parameters:

mode - controls which sodium library (installed in the system or bundled in the JAR) is loaded, and in which order

systemFallBack - If loading directly fails then it will fall to the system fallback specified here

Throws:

LibraryLoadingException - if fails to load the library

See Also:

Native.register(Class, String)

loadSystemLibrary

public void loadSystemLibrary(java.lang.String library)

loadAbsolutePath

public void loadAbsolutePath(java.lang.String absPath)

getSodiumPathInResources

public static java.lang.String getSodiumPathInResources()

Returns the absolute path to sodium library inside JAR (beginning with '/'), e.g. /linux/libsodium.so.

Returns:

The path to the libsodium binary.