org.daisy.common.java

Class JarIsolatedClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

org.daisy.common.java.JarIsolatedClassLoader

All Implemented Interfaces:

Closeable, AutoCloseable

public abstract class JarIsolatedClassLoader
extends URLClassLoader

Child-first delegating class loader that loads from JAR files embedded within the current JAR. Note that, unlike URLClassLoader, JarIsolatedClassLoader takes into account the "Class-Path" defined in the MANIFEST.MF file of JAR files.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JarIsolatedClassLoader()

Method Summary

Modifier and Type	Method and Description
protected void	addCurrentJar() Add the current JAR file to the class path of this class loader.
protected void	addJarRecursively(String path) Add the JAR file at the specified path within the current JAR to the class path of this class loader.
Enumeration<URL>	getResources(String name)
protected Class<?>	loadClass(String name, boolean resolve)

Methods inherited from class java.net.URLClassLoader

addURL, close, definePackage, findClass, findResource, findResources, getPermissions, getResourceAsStream, getURLs, newInstance, newInstance

Methods inherited from class java.security.SecureClassLoader

defineClass, defineClass

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findLibrary, findLoadedClass, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getResource, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, registerAsParallelCapable, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Constructor Detail

JarIsolatedClassLoader

protected JarIsolatedClassLoader()

Method Detail

addCurrentJar

protected void addCurrentJar()

Add the current JAR file to the class path of this class loader. Or in other words, set up this class loader to load classes and resources located directly within the current JAR file. Calling this method is best to be avoided if possible, because it means that these classes and resources are also on the main class path, so it can not be guaranteed anymore that a class is not loaded by more than one class loader. (This is due to the fact that URLClassLoader uses parent-first delegation.)

addJarRecursively

protected void addJarRecursively(String path)

Add the JAR file at the specified path within the current JAR to the class path of this class loader. This is done in a recursive way: the MANIFEST.MF of the JAR file is read, and all the paths in "Class-Path" resolved relatively against path and then added to the class path with addJarRecursively(java.lang.String).

loadClass

protected Class<?> loadClass(String name,
                             boolean resolve)
                      throws ClassNotFoundException

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException

getResources

public Enumeration<URL> getResources(String name)
                              throws IOException

Overrides:

getResources in class ClassLoader

Throws:

IOException