Class CachingWebAppClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

org.eclipse.jetty.ee.webapp.WebAppClassLoader

org.eclipse.jetty.ee.webapp.CachingWebAppClassLoader

All Implemented Interfaces:

Closeable, AutoCloseable, org.eclipse.jetty.util.ClassVisibilityChecker

@ManagedObject
public class CachingWebAppClassLoader
extends WebAppClassLoader

A WebAppClassLoader that caches found and not-found getResource(String) results.

Specifically this ClassLoader caches not-found classes and resources, and found resources (found classes are already cached by URLClassLoader), which can greatly increase performance for applications that search for resources.

Nested Class Summary

Nested classes/interfaces inherited from class WebAppClassLoader

WebAppClassLoader.Context

Constructor Summary

Constructors

Constructor	Description
CachingWebAppClassLoader(ClassLoader parent, WebAppClassLoader.Context context)
CachingWebAppClassLoader(ClassLoader parent, WebAppClassLoader.Context context, int maxEntries)
CachingWebAppClassLoader(WebAppClassLoader.Context context)

Method Summary

Modifier and Type	Method	Description
void	clearCache()
void	close()
URL	getResource(String name)	Get a resource from the classloader
Enumeration<URL>	getResources(String name)
protected Class<?>	loadClass(String name, boolean resolve)
String	toString()

Methods inherited from class WebAppClassLoader

addClassPath, addClassPath, addJars, addTransformer, findClass, foundClass, getContext, getName, getPermissions, isHiddenClass, isProtectedClass, loadAsResource, removeTransformer, runWithHiddenClassAccess, setName

Methods inherited from class URLClassLoader

addURL, definePackage, findResource, findResources, getResourceAsStream, getURLs, newInstance, newInstance

Methods inherited from class SecureClassLoader

defineClass, defineClass

Methods inherited from class ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLibrary, findLoadedClass, findResource, findSystemClass, getClassLoadingLock, getDefinedPackage, getDefinedPackages, getPackage, getPackages, getParent, getPlatformClassLoader, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, getUnnamedModule, isRegisteredAsParallelCapable, loadClass, registerAsParallelCapable, resolveClass, resources, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class Object

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

Methods inherited from interface org.eclipse.jetty.util.ClassVisibilityChecker

isServerClass, isSystemClass

Constructor Details

CachingWebAppClassLoader

public CachingWebAppClassLoader(WebAppClassLoader.Context context)
                         throws IOException

Throws:

IOException

CachingWebAppClassLoader

public CachingWebAppClassLoader(ClassLoader parent,
 WebAppClassLoader.Context context)
                         throws IOException

Throws:

IOException

CachingWebAppClassLoader

public CachingWebAppClassLoader(ClassLoader parent,
 WebAppClassLoader.Context context,
 int maxEntries)
                         throws IOException

Throws:

IOException

Method Details

getResources

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

Overrides:

getResources in class WebAppClassLoader

Throws:

IOException

getResource

public URL getResource(String name)

Description copied from class: WebAppClassLoader

Get a resource from the classloader

NOTE: this method provides a convenience of hacking off a leading / should one be present. This is non-standard and it is recommended to not rely on this behavior

Overrides:

getResource in class WebAppClassLoader

loadClass

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

Overrides:

loadClass in class WebAppClassLoader

Throws:

ClassNotFoundException

clearCache

@ManagedOperation
public void clearCache()

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Overrides:

close in class WebAppClassLoader

Throws:

IOException

toString

public String toString()

Overrides:

toString in class WebAppClassLoader