org.diet4j.tomcat

Class TomcatWebAppClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

org.apache.catalina.loader.WebappClassLoader

org.diet4j.tomcat.TomcatWebAppClassLoader

All Implemented Interfaces:

Closeable, AutoCloseable, org.apache.catalina.Lifecycle, org.apache.tomcat.InstrumentableClassLoader

public class TomcatWebAppClassLoader
extends org.apache.catalina.loader.WebappClassLoader

The ClassLoader for the root Module. This is different from ModuleClassLoader as Tomcat requires it to be a subclass of WebappClassLoader.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.catalina.loader.WebappClassLoader

org.apache.catalina.loader.WebappClassLoader.PrivilegedFindResourceByName, org.apache.catalina.loader.WebappClassLoader.PrivilegedGetClassLoader

Field Summary

Fields

Modifier and Type	Field and Description
protected ModuleClassLoader[]	theDependencyClassLoaders The set of ModuleClassLoaders from the dependent Modules.

Fields inherited from class org.apache.catalina.loader.WebappClassLoader

allPermission, delegate, loaderPC, needConvert, packageTriggersDeny, packageTriggersPermit, parent, permissionList, resourceEntries, resources, securityManager, sm, started

Fields inherited from interface org.apache.catalina.Lifecycle

AFTER_DESTROY_EVENT, AFTER_INIT_EVENT, AFTER_START_EVENT, AFTER_STOP_EVENT, BEFORE_DESTROY_EVENT, BEFORE_INIT_EVENT, BEFORE_START_EVENT, BEFORE_STOP_EVENT, CONFIGURE_START_EVENT, CONFIGURE_STOP_EVENT, PERIODIC_EVENT, START_EVENT, STOP_EVENT

Constructor Summary

Constructors

Constructor and Description
TomcatWebAppClassLoader(ClassLoader parent)

Method Summary

Modifier and Type	Method and Description
URL	findResource(String name) Find a URL.
URL	getResource(String name) Find a resource through this ClassLoader.
InputStream	getResourceAsStream(String name) Find the resource with the given name, and return an input stream that can be used for reading it.
Enumeration<URL>	getResources(String name) Obtain an Enumeration of Resources.
URL[]	getURLs() Obtain the JAR URLs for this ClassLoader.
void	initialize(Module[] dependencies) Initialize with the parameters given.
Class	loadClass(String name, boolean resolve) Load a Class.
String	toString() For debugging.

Methods inherited from class org.apache.catalina.loader.WebappClassLoader

addLifecycleListener, addTransformer, addURL, clearReferences, copyWithoutTransformers, destroy, doDefineClass, filter, findClass, findClassInternal, findLifecycleListeners, findLoadedClass0, findLoadedResource, findResourceInternal, findResources, getClearReferencesHttpClientKeepAliveThread, getClearReferencesLogFactoryRelease, getClearReferencesStatic, getClearReferencesStopThreads, getClearReferencesStopTimerThreads, getContextName, getDelegate, getJavaseClassLoader, getPermissions, getResources, getState, getStateName, init, isPackageSealed, isStarted, loadClass, modified, refreshPolicy, removeLifecycleListener, removeTransformer, setClearReferencesHttpClientKeepAliveThread, setClearReferencesLogFactoryRelease, setClearReferencesStatic, setClearReferencesStopThreads, setClearReferencesStopTimerThreads, setDelegate, setJavaseClassLoader, setResources, start, stop, validate

Methods inherited from class java.net.URLClassLoader

close, definePackage, 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, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, registerAsParallelCapable, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Field Detail

theDependencyClassLoaders

protected ModuleClassLoader[] theDependencyClassLoaders

The set of ModuleClassLoaders from the dependent Modules. Allocated as needed.

Constructor Detail

TomcatWebAppClassLoader

public TomcatWebAppClassLoader(ClassLoader parent)

Method Detail

initialize

public void initialize(Module[] dependencies)
                throws MalformedURLException

Initialize with the parameters given.

Parameters:

dependencies - the list of Module dependencies for this web app

Throws:

MalformedURLException - thrown if one of the URLs identifying the Module's JAR files is malformed

getURLs

public URL[] getURLs()

Obtain the JAR URLs for this ClassLoader. This is overriden so Tomcat can pass the right classpaths on to Jasper and javac.

Overrides:

getURLs in class org.apache.catalina.loader.WebappClassLoader

Returns:

the JAR URLs

getResource

public URL getResource(String name)

Find a resource through this ClassLoader. First look for our local resources, then in our dependencyClassLoaders.

Overrides:

getResource in class org.apache.catalina.loader.WebappClassLoader

Parameters:

name - name of the resource to find

Returns:

URL to the resource

getResources

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

Obtain an Enumeration of Resources.

Overrides:

getResources in class ClassLoader

Parameters:

name - the name of the Resource

Returns:

the Enumeration

Throws:

IOException - thrown if an I/O error occurred

getResourceAsStream

public InputStream getResourceAsStream(String name)

Find the resource with the given name, and return an input stream that can be used for reading it.

Overrides:

getResourceAsStream in class org.apache.catalina.loader.WebappClassLoader

Parameters:

name - Name of the resource to return an input stream for

Returns:

the InputStream, or null

loadClass

public Class loadClass(String name,
                       boolean resolve)
                throws ClassNotFoundException

Load a Class. First we examine the local cache, then we use the default algorithm, and finally we ask our dependency ClassLoaders.

Overrides:

loadClass in class org.apache.catalina.loader.WebappClassLoader

Parameters:

name - name of the to-be-loaded class

resolve - do we also resolve the class

Returns:

the loaded class

Throws:

ClassNotFoundException - loading the class failed, it could not be found

findResource

public URL findResource(String name)

Find a URL.

Overrides:

findResource in class org.apache.catalina.loader.WebappClassLoader

Parameters:

name - the name of the resource

Returns:

the URL of the resource, if found

toString

public String toString()

For debugging.

Overrides:

toString in class org.apache.catalina.loader.WebappClassLoader

Returns:

String representation.