Modifier and Type	Class and Description
pack-priv static class	NativeLibraryLoader.LoadResult A result of a single attempt to load a library.

Modifier and Type	Field and Description
private static final String	DELETE_LIB_PROPERTY_NAME
private static final boolean	DELETE_NATIVE_LIB_AFTER_LOADING
private static final Logger	logger
private static final String	NATIVE_RESOURCE_HOME
private static final String	WORK_DIR_PROPERTY_NAME
private static final File	WORKDIR

Access	Constructor and Description
private	NativeLibraryLoader()

Method Summary

Modifier and Type	Method and Description
private static byte[]	Returns: The binary content of helper `Class`. classToByteArray(Class<?> - The helper `Class` provided by this bundle clazz) Load the helper `Class` as a byte array, to be redefined in specified `ClassLoader`.
private static void	closeQuietly(Closeable c)
private static void	copyLibrary(URL the URL of the library on classpath classpathUrl, File the destination temporary file. tmpFile) Copies the given shared library file from classpath to a temporary file.
private static void	debug(String message, Throwable t)
private static File	getWorkDir()
private static boolean	load(String name, ClassLoader loader, List<NativeLibraryLoader.LoadResult> results) Load the given library with the specified `ClassLoader`
pack-priv static boolean	loadFirstAvailable(ClassLoader loader, List<NativeLibraryLoader.LoadResult> results, String... names) Loads the first available library in the collection with the specified `ClassLoader`.
private static boolean	loadFromWorkdir(String name, ClassLoader loader, List<NativeLibraryLoader.LoadResult> results)
private static boolean	Returns: `true` if the library was successfully loaded. loadLibrary(final ClassLoader - The `ClassLoader` where the native library will be loaded into loader, final String - The native library path or name name, final boolean - Whether the native library will be loaded by path or by name absolute, List<NativeLibraryLoader.LoadResult> results) Loading the native library into the specified `ClassLoader`.
private static NativeLibraryLoader.LoadResult	Returns: the result of the load operation. loadLibraryFromCurrentClassloader(String the name of the library to load. name, boolean true if `name` is an absolute path absolute) Attempts to load the library using the `NativeLibraryUtil` helper from the current classloader.
private static NativeLibraryLoader.LoadResult	Returns: the result of the load operation. loadLibraryFromHelperClassloader(final Class<?> The `NativeLibraryUtil` helper class helper, final String the name of the library to load. name, final boolean true if `name` is an absolute path to the file. absolute) Attempts to load the library by reflectively using the `NativeLibraryUtil` helper from its classloader.
private static void	log(String format, Object arg)
private static void	log(String format, Object arg1, Object arg2)
private static void	log(String format, Object arg1, Object arg2, Throwable t)
private static Class<?>	Returns: A new helper Class defined in the specified ClassLoader. tryToLoadClass(final ClassLoader - The `ClassLoader` where to load the helper `Class` loader, final Class<?> - The helper `Class` helper) Try to load the helper `Class` into specified `ClassLoader`.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

DELETE_LIB_PROPERTY_NAME	back to summary
private static final String DELETE_LIB_PROPERTY_NAME

DELETE_NATIVE_LIB_AFTER_LOADING	back to summary
private static final boolean DELETE_NATIVE_LIB_AFTER_LOADING

logger	back to summary
private static final Logger logger

NATIVE_RESOURCE_HOME	back to summary
private static final String NATIVE_RESOURCE_HOME

WORK_DIR_PROPERTY_NAME	back to summary
private static final String WORK_DIR_PROPERTY_NAME

WORKDIR	back to summary
private static final File WORKDIR

Constructor Detail

NativeLibraryLoader	back to summary
private NativeLibraryLoader()

Method Detail

classToByteArray back to summary

classToByteArray	back to summary
private static byte[] classToByteArray(Class<?> clazz) throws ClassNotFoundException Load the helper `Class` as a byte array, to be redefined in specified `ClassLoader`. Parameters clazz:Class<?> - The helper `Class` provided by this bundle Returns:byte[] The binary content of helper `Class`. Exceptions ClassNotFoundException: Helper class not found or loading failed

private static byte[] classToByteArray(Class<?> clazz) throws ClassNotFoundException

Load the helper Class as a byte array, to be redefined in specified ClassLoader.

Parameters

clazz:Class<?>: - The helper Class provided by this bundle

Returns:byte[]

The binary content of helper Class.

Exceptions

ClassNotFoundException:: Helper class not found or loading failed

closeQuietly	back to summary
private static void closeQuietly(Closeable c)

copyLibrary	back to summary
private static void copyLibrary(URL classpathUrl, File tmpFile) throws IOException Copies the given shared library file from classpath to a temporary file. Parameters classpathUrl:URL the URL of the library on classpath tmpFile:File the destination temporary file.

copyLibrary

back to summary

private static void copyLibrary(URL classpathUrl, File tmpFile) throws IOException

Copies the given shared library file from classpath to a temporary file.

Parameters

classpathUrl:URL: the URL of the library on classpath
tmpFile:File: the destination temporary file.

debug	back to summary
private static void debug(String message, Throwable t)

getWorkDir	back to summary
private static File getWorkDir()

load	back to summary
private static boolean load(String name, ClassLoader loader, List<NativeLibraryLoader.LoadResult> results) Load the given library with the specified `ClassLoader`

loadFirstAvailable	back to summary
pack-priv static boolean loadFirstAvailable(ClassLoader loader, List<NativeLibraryLoader.LoadResult> results, String... names) Loads the first available library in the collection with the specified `ClassLoader`.

loadFromWorkdir	back to summary
private static boolean loadFromWorkdir(String name, ClassLoader loader, List<NativeLibraryLoader.LoadResult> results)

loadLibrary back to summary

loadLibrary	back to summary
private static boolean loadLibrary(final ClassLoader loader, final String name, final boolean absolute, List<NativeLibraryLoader.LoadResult> results) Loading the native library into the specified `ClassLoader`. Parameters loader:ClassLoader - The `ClassLoader` where the native library will be loaded into name:String - The native library path or name absolute:boolean - Whether the native library will be loaded by path or by name Returns:boolean `true` if the library was successfully loaded.

private static boolean loadLibrary(final ClassLoader loader, final String name, final boolean absolute, List<NativeLibraryLoader.LoadResult> results)

Loading the native library into the specified ClassLoader.

Parameters

loader:ClassLoader: - The ClassLoader where the native library will be loaded into
name:String: - The native library path or name
absolute:boolean: - Whether the native library will be loaded by path or by name

Returns:boolean

true if the library was successfully loaded.

loadLibraryFromCurrentClassloader back to summary

loadLibraryFromCurrentClassloader	back to summary
private static NativeLibraryLoader.LoadResult loadLibraryFromCurrentClassloader(String name, boolean absolute) Attempts to load the library using the `NativeLibraryUtil` helper from the current classloader. Parameters name:String the name of the library to load. absolute:boolean true if `name` is an absolute path Returns:NativeLibraryLoader.LoadResult the result of the load operation.

private static NativeLibraryLoader.LoadResult loadLibraryFromCurrentClassloader(String name, boolean absolute)

Attempts to load the library using the NativeLibraryUtil helper from the current classloader.

Parameters

name:String: the name of the library to load.
absolute:boolean: true if name is an absolute path

Returns:NativeLibraryLoader.LoadResult

the result of the load operation.

loadLibraryFromHelperClassloader back to summary

loadLibraryFromHelperClassloader	back to summary
private static NativeLibraryLoader.LoadResult loadLibraryFromHelperClassloader(final Class<?> helper, final String name, final boolean absolute) Attempts to load the library by reflectively using the `NativeLibraryUtil` helper from its classloader. Parameters helper:Class<?> The `NativeLibraryUtil` helper class name:String the name of the library to load. absolute:boolean true if `name` is an absolute path to the file. Returns:NativeLibraryLoader.LoadResult the result of the load operation.

private static NativeLibraryLoader.LoadResult loadLibraryFromHelperClassloader(final Class<?> helper, final String name, final boolean absolute)

Attempts to load the library by reflectively using the NativeLibraryUtil helper from its classloader.

Parameters

helper:Class<?>: The NativeLibraryUtil helper class
name:String: the name of the library to load.
absolute:boolean: true if name is an absolute path to the file.

Returns:NativeLibraryLoader.LoadResult

the result of the load operation.

log	back to summary
private static void log(String format, Object arg)

log	back to summary
private static void log(String format, Object arg1, Object arg2)

log	back to summary
private static void log(String format, Object arg1, Object arg2, Throwable t)

tryToLoadClass back to summary

tryToLoadClass	back to summary
private static Class<?> tryToLoadClass(final ClassLoader loader, final Class<?> helper) throws ClassNotFoundException Try to load the helper `Class` into specified `ClassLoader`. Parameters loader:ClassLoader - The `ClassLoader` where to load the helper `Class` helper:Class<?> - The helper `Class` Returns:Class<?> A new helper Class defined in the specified ClassLoader. Exceptions ClassNotFoundException: Helper class not found or loading failed

private static Class<?> tryToLoadClass(final ClassLoader loader, final Class<?> helper) throws ClassNotFoundException

Try to load the helper Class into specified ClassLoader.

Parameters

loader:ClassLoader: - The ClassLoader where to load the helper Class
helper:Class<?>: - The helper Class

Returns:Class<?>

A new helper Class defined in the specified ClassLoader.

Exceptions

ClassNotFoundException:: Helper class not found or loading failed

org.conscrypt back to summary

pack-priv final Class NativeLibraryLoader.LoadResult

Class Inheritance

extends Object

java.lang.Object
org.conscrypt.NativeLibraryLoader.LoadResult

A result of a single attempt to load a library.

Field Summary

Modifier and Type	Field and Description
pack-priv final boolean	absolute
pack-priv final Throwable	error
pack-priv final boolean	loaded
pack-priv final String	name
pack-priv final boolean	usingHelperClassloader

Constructor Summary

Access	Constructor and Description
private	LoadResult(String name, boolean absolute, boolean loaded, boolean usingHelperClassloader, Throwable error)

Method Summary

Modifier and Type	Method and Description
pack-priv void	log()
private static NativeLibraryLoader.LoadResult	newFailureResult(String name, boolean absolute, boolean usingHelperClassloader, Throwable error)
private static NativeLibraryLoader.LoadResult	newSuccessResult(String name, boolean absolute, boolean usingHelperClassloader)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

absolute	back to summary
pack-priv final boolean absolute

error	back to summary
pack-priv final Throwable error

loaded	back to summary
pack-priv final boolean loaded

name	back to summary
pack-priv final String name

usingHelperClassloader	back to summary
pack-priv final boolean usingHelperClassloader

Constructor Detail

LoadResult	back to summary
private LoadResult(String name, boolean absolute, boolean loaded, boolean usingHelperClassloader, Throwable error)

Method Detail

log	back to summary
pack-priv void log()

newFailureResult	back to summary
private static NativeLibraryLoader.LoadResult newFailureResult(String name, boolean absolute, boolean usingHelperClassloader, Throwable error)

newSuccessResult	back to summary
private static NativeLibraryLoader.LoadResult newSuccessResult(String name, boolean absolute, boolean usingHelperClassloader)

pack-priv final Class NativeLibraryLoader

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv final Class NativeLibraryLoader.LoadResult

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail