ljbo82.util

Class LibraryBundle

java.lang.Object

ljbo82.util.LibraryBundle

Direct Known Subclasses:

EmbeddedLibraryBundle

public class LibraryBundle
extends Object

Represents a native library bundle.

Author:

Leandro Oliveira (ljbo.82@gmail.com)

Constructor Summary

Constructors

Constructor and Description
LibraryBundle()

Method Summary

Modifier and Type	Method and Description
protected Path	getLibraryFile(String libname) Returns the file pointing to given library.
protected String	getLibraryPrefix() Returns the library filename prefix.
protected Path[]	getLibrarySearchDirs() Returns the list of paths to search when loading libraries.
protected String	getLibrarySuffix() Returns the library filename suffix.
boolean	isLoaded(String libname) Returns a boolean indicating if given library is loaded.
void	loadLibraries() Loads all registered libraries in appropriate sequencing (according to internal dependencies).
protected void	loadLibrary(String libname) Loads a library.
void	registerLibrary(String libname, String... dependencies) Registers a library and its dependencies.

Methods inherited from class java.lang.Object

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

Constructor Detail

LibraryBundle

public LibraryBundle()

Method Detail

getLibrarySearchDirs

protected Path[] getLibrarySearchDirs()

Returns the list of paths to search when loading libraries.

Returns:

the list of paths to search when loading libraries.

getLibraryPrefix

protected String getLibraryPrefix()

Returns the library filename prefix.

Returns:

the library filename prefix. Default implementation returns Platform.getLibPrefix()

getLibrarySuffix

protected String getLibrarySuffix()

Returns the library filename suffix.

Returns:

the library filename suffix. Default implementation returns Platform.getLibSuffix()

registerLibrary

public void registerLibrary(String libname,
                            String... dependencies)

Registers a library and its dependencies.

Parameters:

libname - library name.

dependencies - library dependencies.

getLibraryFile

protected Path getLibraryFile(String libname)
                       throws Path.PathAccessException

Returns the file pointing to given library.

Parameters:

libname - library name.

Returns:

the file pointing to given library in current.

Throws:

Path.PathAccessException - if library file could not be found.

isLoaded

public boolean isLoaded(String libname)

Returns a boolean indicating if given library is loaded.

Parameters:

libname - library name.

Returns:

a boolean indicating if given library is loaded.

loadLibrary

protected void loadLibrary(String libname)
                    throws UnsatisfiedLinkError

Loads a library. If a library is already loaded, nothing happens.

Parameters:

libname - library name

Throws:

UnsatisfiedLinkError - if library could not be loaded.

loadLibraries

public void loadLibraries()
                   throws UnsatisfiedLinkError

Loads all registered libraries in appropriate sequencing (according to internal dependencies).

Throws:

UnsatisfiedLinkError - if a library could not be loaded.