com.aparapi.natives.util

Class NativeUtils

java.lang.Object

com.aparapi.natives.util.NativeUtils

public class NativeUtils
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).

Method Summary

Modifier and Type	Method and Description
static void	loadLibraryFromJar(String path, String libraryTargetFileName) Loads library from current JAR archive The file from JAR is copied into system temporary directory and then loaded.

Methods inherited from class java.lang.Object

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

Method Detail

loadLibraryFromJar

public static void loadLibraryFromJar(String path,
                                      String libraryTargetFileName)
                               throws IOException

Loads library from current JAR archive The file from JAR is copied into system temporary directory and then loaded. The temporary file and folder are 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 @see File#createTempFile(java.lang.String, java.lang.String)).