Package electrostatic4j.snaploader

Class ConcurrentNativeBinaryLoader

java.lang.Object

electrostatic4j.snaploader.NativeBinaryLoader

electrostatic4j.snaploader.ConcurrentNativeBinaryLoader

public class ConcurrentNativeBinaryLoader
extends NativeBinaryLoader

A thread-safe implementation for the NativeBinaryLoader.

Field Summary

Fields

Modifier and Type	Field	Description
protected final ReentrantLock	lock	The monitor object.

Fields inherited from class electrostatic4j.snaploader.NativeBinaryLoader

libraryExtractionListener, libraryExtractor, libraryInfo, libraryLocalizingListener, maxNumberOfLoadingFailure, nativeBinaryLoadingListener, nativeDynamicLibrary, numberOfLoadingFailure, registeredLibraries, retryWithCleanExtraction, systemDetectionListener

Constructor Summary

Constructors

Constructor	Description
ConcurrentNativeBinaryLoader(List<NativeDynamicLibrary> registeredLibraries, LibraryInfo libraryInfo)	Instantiates a thread-safe NativeBinaryLoader object.

Method Summary

Modifier and Type	Method	Description
protected void	cleanExtractBinary(NativeDynamicLibrary library)	Cleanly extracts and loads the native binary to the current [user.dir].
NativeBinaryLoader	initPlatformLibrary()	Initializes the platform-dependent native dynamic library.
NativeBinaryLoader	loadLibrary(LoadingCriterion criterion)	Extracts and loads the system and the architecture-specific library from the output jar to a specified directory according to a loading criterion (incremental-load or clean-extract).

Methods inherited from class electrostatic4j.snaploader.NativeBinaryLoader

getLibraryExtractionListener, getLibraryLocalizingListener, getNativeBinaryLoadingListener, getNativeDynamicLibrary, getRegisteredLibraries, getSystemDetectionListener, initializeLibraryExtractor, isRetryWithCleanExtraction, loadBinary, loadSystemBinary, preInitLibraryLocator, registerNativeLibraries, setLibraryExtractionListener, setLibraryLocalizingListener, setLoggingEnabled, setMaxNumberOfLoadingFailure, setNativeBinaryLoadingListener, setRetryWithCleanExtraction, setSystemDetectionListener

Methods inherited from class java.lang.Object

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

Field Details

lock

protected final ReentrantLock lock

The monitor object.

Constructor Details

ConcurrentNativeBinaryLoader

public ConcurrentNativeBinaryLoader(List<NativeDynamicLibrary> registeredLibraries,
 LibraryInfo libraryInfo)

Instantiates a thread-safe NativeBinaryLoader object.

Parameters:

libraryInfo - a data structure object holding the platform independent data for the library to load

Method Details

initPlatformLibrary

public NativeBinaryLoader initPlatformLibrary()
                                       throws UnSupportedSystemError

Description copied from class: NativeBinaryLoader

Initializes the platform-dependent native dynamic library.

Overrides:

initPlatformLibrary in class NativeBinaryLoader

Returns:

this instance for chained invocations

Throws:

UnSupportedSystemError - if the OS is not supported by jSnapLoader

loadLibrary

public NativeBinaryLoader loadLibrary(LoadingCriterion criterion)
                               throws Exception

Description copied from class: NativeBinaryLoader

Extracts and loads the system and the architecture-specific library from the output jar to a specified directory according to a loading criterion (incremental-load or clean-extract). The directory is determined by the selected NativeDynamicLibrary from the registered platform libraries.

Note: The default loading action for Android Systems is loading the libraries from the System directories (i.e., /lib/ABI inside the APK packages), while the default loading action for other desktop systems is determined by the user through this parameterized function.

Fallback loading routines can be implemented as needed via NativeBinaryLoadingListener.onLoadingFailure(NativeBinaryLoader, CallingStackMetaData) and are left for the user applications.

Overrides:

loadLibrary in class NativeBinaryLoader

Parameters:

criterion - the initial loading criterion, either LoadingCriterion.INCREMENTAL_LOADING, LoadingCriterion.CLEAN_EXTRACTION or LoadingCriterion.SYSTEM_LOAD for loading native dlls from system directories.

Returns:

this instance for chained invocations

Throws:

IOException - if the library to extract is not present in the jar filesystem

Exception

cleanExtractBinary

protected void cleanExtractBinary(NativeDynamicLibrary library)
                           throws Exception

Description copied from class: NativeBinaryLoader

Cleanly extracts and loads the native binary to the current [user.dir].

Overrides:

cleanExtractBinary in class NativeBinaryLoader

Parameters:

library - the platform-specific library to extract and load

Throws:

IOException - in case the binary to be extracted is not found on the specified jar, or an interrupted I/O operation has occurred

Exception