Modifier and Type	Class and Description
public static enum	TempJarCache.LoadState

Modifier and Type	Field and Description
private static Map<Uri, TempJarCache.LoadState>	classFileJars
private static final boolean	DEBUG
private static volatile boolean	isInit
private static Map<Uri, TempJarCache.LoadState>	nativeLibJars
private static Map<String, String>	nativeLibMap
private static Map<Uri, TempJarCache.LoadState>	resourceFileJars
private static volatile boolean	staticInitError
private static TempFileCache	tmpFileCache

Access	Constructor and Description
public	TempJarCache()

Method Summary

Modifier and Type	Method and Description
public static final synchronized void	addAll(final Class<?> if class is certified, the JarFile entries needs to have the same certificate certClass, final Uri jarUri) Adds all types, native libraries, class files and other files (resources) if not yet added.
public static final synchronized void	addClasses(final Class<?> if class is certified, the JarFile entries needs to have the same certificate certClass, final Uri jarUri) Adds native classes, if not yet added.
public static final synchronized boolean	Returns: true if native libraries were added or previously loaded from given jarUri, otherwise false addNativeLibs(final Class<?> if class is certified, the JarFile entries needs to have the same certificate certClass, final Uri jarUri, final String if not null, only extracts native libraries within this path. nativeLibraryPath) Adds native libraries, if not yet added.
public static final synchronized void	addResources(final Class<?> certClass, final URI jarURI) Deprecated Use `addResources(Class, Uri)` See `addResources(Class, Uri)`
public static final synchronized void	addResources(final Class<?> if class is certified, the JarFile entries needs to have the same certificate certClass, final Uri jarUri) Adds native resources, if not yet added.
public static synchronized boolean	checkClasses(final Uri jarUri, final TempJarCache.LoadState exp)
pack-priv static void	checkInitialized()
public static synchronized boolean	checkNativeLibs(final Uri jarUri, final TempJarCache.LoadState exp)
public static synchronized boolean	checkResources(final Uri jarUri, final TempJarCache.LoadState exp)
public static final synchronized String	findLibrary(final String libName)
public static final synchronized String	findResource(final String name) Similar to `ClassLoader#getResource(String)`.
public static final synchronized URI	getResource(final String name) Deprecated Use `getResourceUri(String)` See `getResourceUri(String)`
public static final synchronized Uri	getResourceUri(final String name) Similar to `ClassLoader#getResource(String)`.
public static TempFileCache	getTempFileCache()
public static boolean	Returns: true is static initialization was successful initSingleton() Documented way to kick off static initialization.
public static boolean	Returns: true if this class has been properly initialized, ie. is in use, otherwise false. isInitialized()
private static boolean	isInitializedImpl() This is not recommended since the JNI libraries may still be in use by the ClassLoader they are loaded via `System#load(String)`.
private static boolean	testLoadState(final TempJarCache.LoadState has, final TempJarCache.LoadState exp)
private static void	validateCertificates(final Class<?> certClass, final JarFile jarFile)

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

Field Detail

classFileJars	back to summary
private static Map<Uri, TempJarCache.LoadState> classFileJars

DEBUG	back to summary
private static final boolean DEBUG

isInit	back to summary
private static volatile boolean isInit

nativeLibJars	back to summary
private static Map<Uri, TempJarCache.LoadState> nativeLibJars

nativeLibMap	back to summary
private static Map<String, String> nativeLibMap

resourceFileJars	back to summary
private static Map<Uri, TempJarCache.LoadState> resourceFileJars

staticInitError	back to summary
private static volatile boolean staticInitError

tmpFileCache	back to summary
private static TempFileCache tmpFileCache

Constructor Detail

TempJarCache	back to summary
public TempJarCache()

Method Detail

addAll back to summary

addAll	back to summary
public static final synchronized void addAll(final Class<?> certClass, final Uri jarUri) throws IOException, SecurityException, IllegalArgumentException, URISyntaxException Adds all types, native libraries, class files and other files (resources) if not yet added. TODO class access pending needs Classloader.defineClass(..) access, ie. own derivation - will do when needed .. Parameters certClass:Class<?> if class is certified, the JarFile entries needs to have the same certificate Exceptions IOException: if the `jarUri` could not be loaded or a previous load attempt failed

public static final synchronized void addAll(final Class<?> certClass, final Uri jarUri) throws IOException, SecurityException, IllegalArgumentException, URISyntaxException

Adds all types, native libraries, class files and other files (resources) if not yet added. TODO class access pending needs Classloader.defineClass(..) access, ie. own derivation - will do when needed ..

Parameters

certClass:Class<?>: if class is certified, the JarFile entries needs to have the same certificate

Exceptions

IOException:: if the jarUri could not be loaded or a previous load attempt failed

addClasses back to summary

addClasses	back to summary
public static final synchronized void addClasses(final Class<?> certClass, final Uri jarUri) throws IOException, SecurityException, IllegalArgumentException, URISyntaxException Adds native classes, if not yet added. TODO class access pending needs Classloader.defineClass(..) access, ie. own derivation - will do when needed .. Parameters certClass:Class<?> if class is certified, the JarFile entries needs to have the same certificate Exceptions IOException: if the `jarUri` could not be loaded or a previous load attempt failed

public static final synchronized void addClasses(final Class<?> certClass, final Uri jarUri) throws IOException, SecurityException, IllegalArgumentException, URISyntaxException

Adds native classes, if not yet added. TODO class access pending needs Classloader.defineClass(..) access, ie. own derivation - will do when needed ..

Parameters

certClass:Class<?>: if class is certified, the JarFile entries needs to have the same certificate

Exceptions

IOException:: if the jarUri could not be loaded or a previous load attempt failed

addNativeLibs back to summary

addNativeLibs	back to summary
public static final synchronized boolean addNativeLibs(final Class<?> certClass, final Uri jarUri, final String nativeLibraryPath) throws IOException, SecurityException, IllegalArgumentException, URISyntaxException Adds native libraries, if not yet added. Parameters certClass:Class<?> if class is certified, the JarFile entries needs to have the same certificate nativeLibraryPath:String if not null, only extracts native libraries within this path. Returns:boolean true if native libraries were added or previously loaded from given jarUri, otherwise false Exceptions IOException: if the `jarUri` could not be loaded or a previous load attempt failed

public static final synchronized boolean addNativeLibs(final Class<?> certClass, final Uri jarUri, final String nativeLibraryPath) throws IOException, SecurityException, IllegalArgumentException, URISyntaxException

Adds native libraries, if not yet added.

Parameters

certClass:Class<?>: if class is certified, the JarFile entries needs to have the same certificate
nativeLibraryPath:String: if not null, only extracts native libraries within this path.

Returns:boolean

true if native libraries were added or previously loaded from given jarUri, otherwise false

Exceptions

IOException:: if the jarUri could not be loaded or a previous load attempt failed

addResources	back to summary
public static final synchronized void addResources(final Class<?> certClass, final URI jarURI) throws IOException, SecurityException, IllegalArgumentException, URISyntaxException Deprecated Use `addResources(Class, Uri)` See `addResources(Class, Uri)`

addResources back to summary

addResources	back to summary
public static final synchronized void addResources(final Class<?> certClass, final Uri jarUri) throws IOException, SecurityException, IllegalArgumentException, URISyntaxException Adds native resources, if not yet added. Parameters certClass:Class<?> if class is certified, the JarFile entries needs to have the same certificate Exceptions IOException: if the `jarUri` could not be loaded or a previous load attempt failed

public static final synchronized void addResources(final Class<?> certClass, final Uri jarUri) throws IOException, SecurityException, IllegalArgumentException, URISyntaxException

Adds native resources, if not yet added.

Parameters

certClass:Class<?>: if class is certified, the JarFile entries needs to have the same certificate

Exceptions

IOException:: if the jarUri could not be loaded or a previous load attempt failed

checkClasses	back to summary
public static synchronized boolean checkClasses(final Uri jarUri, final TempJarCache.LoadState exp) throws IOException

checkInitialized	back to summary
pack-priv static void checkInitialized()

checkNativeLibs	back to summary
public static synchronized boolean checkNativeLibs(final Uri jarUri, final TempJarCache.LoadState exp) throws IOException

checkResources	back to summary
public static synchronized boolean checkResources(final Uri jarUri, final TempJarCache.LoadState exp) throws IOException

findLibrary	back to summary
public static final synchronized String findLibrary(final String libName)

findResource	back to summary
public static final synchronized String findResource(final String name) Similar to `ClassLoader#getResource(String)`.

getResource	back to summary
public static final synchronized URI getResource(final String name) throws URISyntaxException Deprecated Use `getResourceUri(String)` See `getResourceUri(String)`

getResourceUri	back to summary
public static final synchronized Uri getResourceUri(final String name) throws URISyntaxException Similar to `ClassLoader#getResource(String)`.

getTempFileCache	back to summary
public static TempFileCache getTempFileCache()

initSingleton	back to summary
public static boolean initSingleton() Documented way to kick off static initialization. Returns:boolean true is static initialization was successful

initSingleton

back to summary

public static boolean initSingleton()

Documented way to kick off static initialization.

Returns:boolean: true is static initialization was successful

isInitialized	back to summary
public static boolean isInitialized() Returns:boolean true if this class has been properly initialized, ie. is in use, otherwise false.

isInitializedImpl back to summary

isInitializedImpl	back to summary
private static boolean isInitializedImpl() This is not recommended since the JNI libraries may still be in use by the ClassLoader they are loaded via `System#load(String)`. In JogAmp, JNI native libraries loaded and registered by `JNILibLoaderBase` derivations, where the native JARs might be loaded via `JNILibLoaderBase#addNativeJarLibs(Class, String)`. The only valid use case to shutdown the TempJarCache is at bootstrapping, i.e. when no native library is guaranteed to be loaded. This could be useful if bootstrapping needs to find the proper native library type. public static void shutdown() { if (isInit) { // volatile: ok synchronized (TempJarCache.class) { if (isInit) { if(DEBUG) { System.err.println("TempJarCache.shutdown(): real "+(false==staticInitError)+", "+ tmpFileCache.getTempDir()); } isInit = false; if(!staticInitError) { nativeLibMap.clear(); nativeLibMap = null; nativeLibJars.clear(); nativeLibJars = null; classFileJars.clear(); classFileJars = null; resourceFileJars.clear(); resourceFileJars = null; tmpFileCache.destroy(); tmpFileCache = null; } } } } }

private static boolean isInitializedImpl()

This is not recommended since the JNI libraries may still be in use by the ClassLoader they are loaded via System#load(String).

In JogAmp, JNI native libraries loaded and registered by JNILibLoaderBase derivations, where the native JARs might be loaded via JNILibLoaderBase#addNativeJarLibs(Class, String).

The only valid use case to shutdown the TempJarCache is at bootstrapping, i.e. when no native library is guaranteed to be loaded. This could be useful if bootstrapping needs to find the proper native library type.

public static void shutdown() { if (isInit) { // volatile: ok synchronized (TempJarCache.class) { if (isInit) { if(DEBUG) { System.err.println("TempJarCache.shutdown(): real "+(false==staticInitError)+", "+ tmpFileCache.getTempDir()); } isInit = false; if(!staticInitError) { nativeLibMap.clear(); nativeLibMap = null; nativeLibJars.clear(); nativeLibJars = null; classFileJars.clear(); classFileJars = null; resourceFileJars.clear(); resourceFileJars = null; tmpFileCache.destroy(); tmpFileCache = null; } } } } }

testLoadState	back to summary
private static boolean testLoadState(final TempJarCache.LoadState has, final TempJarCache.LoadState exp)

validateCertificates	back to summary
private static void validateCertificates(final Class<?> certClass, final JarFile jarFile) throws IOException, SecurityException

com.jogamp.common.util.cache back to summary

public final Enum TempJarCache.LoadState

Class Inheritance

extends Enum<TempJarCache.LoadState>

java.lang.Object
java.lang.Enum
com.jogamp.common.util.cache.TempJarCache.LoadState

Field Summary

Modifier and Type	Field and Description
public static final TempJarCache.LoadState	LOADED
public static final TempJarCache.LoadState	LOOKED_UP

Constructor Summary

Access	Constructor and Description
private	LoadState()

Method Summary

Modifier and Type	Method and Description
public boolean	compliesWith(final TempJarCache.LoadState o2)
public static TempJarCache.LoadState	valueOf(String name)
public static TempJarCache.LoadState[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

LOADED	back to summary
public static final TempJarCache.LoadState LOADED

LOOKED_UP	back to summary
public static final TempJarCache.LoadState LOOKED_UP

Constructor Detail

LoadState	back to summary
private LoadState()

Method Detail

compliesWith	back to summary
public boolean compliesWith(final TempJarCache.LoadState o2)

valueOf	back to summary
public static TempJarCache.LoadState valueOf(String name)

values	back to summary
public static TempJarCache.LoadState[] values()

public Class TempJarCache

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public final Enum TempJarCache.LoadState

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail