com.cisco.thunderhead.loader

Class JarClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

com.cisco.thunderhead.loader.JarClassLoader

public class JarClassLoader
extends SecureClassLoader

JarClassLoader loads class files from a 'fat' JAR file (if they are in the fat jar or in the embed jar files contained by the fat jar) and from the parent classloader (if they are not in the fat jar).

Method Summary

Modifier and Type	Method and Description
void	close() Method to safely close the JarClassLoader
static JarClassLoader	createBootstrapClassLoader(File fileForFatJar, List<String> listOfBridgeInterfaces, java.nio.file.Path tmpDir) Factory to create a JarClassLoader.
static JarClassLoader	createWithParent(File fileForFatJar, ClassLoader parentClassLoader, List<String> listOfBridgeInterfaces, java.nio.file.Path tmpDir) Factory to create a JarClassLoader.
static long	getNumberOfInstances() Number of existing instances of the class.
Class<?>	loadClass(String name)
void	unload()

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, getParent, getResource, getResourceAsStream, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus

Methods inherited from class java.lang.Object

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

Method Detail

createWithParent

public static JarClassLoader createWithParent(File fileForFatJar,
                                              ClassLoader parentClassLoader,
                                              List<String> listOfBridgeInterfaces,
                                              java.nio.file.Path tmpDir)
                                       throws MalformedURLException

Factory to create a JarClassLoader.

Parameters:

fileForFatJar - is the File object for the "fat" jar which we are loading classes from

parentClassLoader - is the classloader we will load from if classes aren't in the fat jar file

listOfBridgeInterfaces - is the name of classes which bridge the classloaders (e.g. com.cisco.thunderhead.plugin.example.ExamplePluginInterface)

tmpDir - Path to unload embedded jars into

Throws:

MalformedURLException - when URL is not formed correctly

createBootstrapClassLoader

public static JarClassLoader createBootstrapClassLoader(File fileForFatJar,
                                                        List<String> listOfBridgeInterfaces,
                                                        java.nio.file.Path tmpDir)
                                                 throws MalformedURLException

Factory to create a JarClassLoader.

Parameters:

fileForFatJar - is the File object for the "fat" jar which we are loading classes from

listOfBridgeInterfaces - is the name of classes which bridge the classloaders (e.g. com.cisco.thunderhead.plugin.example.ExamplePluginInterface)

tmpDir - Path to unload embedded jars into

Throws:

MalformedURLException - when URL is not formed correctly

getNumberOfInstances

public static long getNumberOfInstances()

Number of existing instances of the class.

close

public void close()
           throws IOException

Method to safely close the JarClassLoader

Throws:

IOException - when close operation fails

unload

public void unload()
            throws IOException

Throws:

IOException

loadClass

public Class<?> loadClass(String name)
                   throws ClassNotFoundException

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException

See Also:

ClassLoader.loadClass(String)