com.github.jjYBdx4IL.utils

Class ResourceUtils

java.lang.Object

com.github.jjYBdx4IL.utils.ResourceUtils

public class ResourceUtils
extends Object

Author:

Github jjYBdx4IL Projects

Field Summary

Fields

Modifier and Type	Field and Description
protected static Set<String>	libRegistry

Method Summary

Modifier and Type	Method and Description
static File	extractResource(String resourceId) Same as getClass().getResource(), but returns a File handle to an extracted file copy.
static File	getResFileUnchecked(Class<?> resourceClass, String resourceId) Get a File to a resource.
static File	getResFileUnchecked(String resourceId) Get a File to a resource.
static void	loadLibrary(String libName) Loads native libraries from the classpath.
static void	loadLibrary(String libName, boolean deleteOnExit)

Methods inherited from class java.lang.Object

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

Field Detail

libRegistry

protected static final Set<String> libRegistry

Method Detail

loadLibrary

public static void loadLibrary(String libName)

Loads native libraries from the classpath. Extracts from jar files if necessary. Follows the path naming convention of JNA, Platform.RESOURCE_PREFIX. Strictly loads libraries from the classpath. Ignores jni.library.path setting. This function will detect repeated loads of the same library and silently skip any further loads using the same libName argument.

Parameters:

libName - the native library to load, ie. "fann" for "libfann.so" on Linux systems

Throws:

RuntimeException - checked exception are wrapped in RuntimeException

loadLibrary

public static void loadLibrary(String libName,
                               boolean deleteOnExit)

Parameters:

libName - the native library to load, ie. "fann" for "libfann.so" on Linux systems

deleteOnExit - if true, delete unpacked library on VM exit, not before

Throws:

RuntimeException - checked exception are wrapped in RuntimeException

See Also:

loadLibrary(String)

extractResource

public static File extractResource(String resourceId)
                            throws IOException

Same as getClass().getResource(), but returns a File handle to an extracted file copy. Beware: it's your duty to clean up this file, though it's created inside your system's temp folder.

Parameters:

resourceId - an absolute resourceId (ie. starts with "/")

Returns:

the extracted file

Throws:

IOException - if there was an I/O problem

getResFileUnchecked

public static File getResFileUnchecked(String resourceId)

Get a File to a resource. Because you don't give this method a class, only absolute resource IDs are usually sensible choices. This function only works for extracted resources, not for resource packed inside jars. The function will throw only unchecked exceptions and is mainly useful for static initializers and test units.

Parameters:

resourceId - the resource path, preferably an absolute one

Returns:

the resource

getResFileUnchecked

public static File getResFileUnchecked(Class<?> resourceClass,
                                       String resourceId)

Get a File to a resource. The resourceId argument can be relative, it will be resolved relative to the resourceClass argument. This function only works for extracted resources, not for resource packed inside jars. The function will throw only unchecked exceptions and is mainly useful for static initializers and test units.

Parameters:

resourceClass - the class

resourceId - the resource path, sensibly a relative one

Returns:

the resource