edu.harvard.econcs.util

Class NativeUtils

java.lang.Object

edu.harvard.econcs.util.NativeUtils

public class NativeUtils
extends Object

A library based on the NativeUtils library of Adam Heinrich:

A simple library class which helps with loading dynamic libraries stored in the JAR archive. These libraries usualy 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"

Method Summary

Modifier and Type	Method and Description
static void	addLibraryPath(String pathToAdd) Adds the specified path to the java library path
static File	createTempDir(String dirname)
static void	loadLibraryFromJar(String path, File directory) Loads library from current JAR archive

Methods inherited from class java.lang.Object

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

Method Detail

loadLibraryFromJar

public static void loadLibraryFromJar(String path,
                                      File directory)
                               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:

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

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

addLibraryPath

public static void addLibraryPath(String pathToAdd)
                           throws Exception

Adds the specified path to the java library path

Parameters:

pathToAdd - the path to add

Throws:

Exception

createTempDir

public static File createTempDir(String dirname)