Package org.glassfish.internal.api

Class DelegatingClassLoader

java.lang.Object

java.lang.ClassLoader

org.glassfish.internal.api.DelegatingClassLoader

public class DelegatingClassLoader
extends ClassLoader

This class loader has a list of class loaders called as delegates that it uses to find classes.

All those delegates must have the same parent as this class loader in order to have a consistent class space. By consistent class space, we mean a class space where no two loaded class have same name. An inconsistent class space can lead to ClassCastException.

This class loader does not define any class, classes are always loaded either by its parent or by one of the delegates.

Author:

Sanjeeb.Sahoo@Sun.COM

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	DelegatingClassLoader.ClassFinder	This interface is an optimization.

Constructor Summary

Constructors

Constructor	Description
DelegatingClassLoader(ClassLoader parent)
DelegatingClassLoader(ClassLoader parent, List<DelegatingClassLoader.ClassFinder> delegates)	Creates new delegating class loader.

Method Summary

Modifier and Type	Method	Description
boolean	addDelegate(DelegatingClassLoader.ClassFinder classFinder)	Adds a class finder to list of delegates.
Class<?>	findClass(String name)
protected URL	findResource(String name)
protected Enumeration<URL>	findResources(String name)
List<DelegatingClassLoader.ClassFinder>	getDelegates()
String	getName()
boolean	removeDelegate(DelegatingClassLoader.ClassFinder classFinder)	Removes a class finder from list of delegates.
void	setName(String name)
String	toString()

Methods inherited from class java.lang.ClassLoader

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

Methods inherited from class java.lang.Object

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

Constructor Details

DelegatingClassLoader

public DelegatingClassLoader(ClassLoader parent,
 List<DelegatingClassLoader.ClassFinder> delegates)

Creates new delegating class loader.

Throws:

IllegalArgumentException - when the delegate does not have same parent as this class loader

DelegatingClassLoader

public DelegatingClassLoader(ClassLoader parent)

Method Details

addDelegate

public boolean addDelegate(DelegatingClassLoader.ClassFinder classFinder)

Adds a class finder to list of delegates.

To have a consistent class space (by consistent class space, we mean a class space where there does not exist two class with same name), this method does not allow a delegate to be added that has a different parent.

Parameters:

classFinder - class finder to add to the list of delegates

Returns:

true if the delegate is added, false otherwise

Throws:

IllegalArgumentException - when the delegate does not have same parent as this class loader

removeDelegate

public boolean removeDelegate(DelegatingClassLoader.ClassFinder classFinder)

Removes a class finder from list of delegates.

Parameters:

classFinder - class finder to remove from the list of delegates

Returns:

true if the delegate was removed, false otherwise

findClass

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

Overrides:

findClass in class ClassLoader

Throws:

ClassNotFoundException

findResource

protected URL findResource(String name)

Overrides:

findResource in class ClassLoader

findResources

protected Enumeration<URL> findResources(String name)
                                  throws IOException

Overrides:

findResources in class ClassLoader

Throws:

IOException

getName

public String getName()

Overrides:

getName in class ClassLoader

setName

public void setName(String name)

getDelegates

public List<DelegatingClassLoader.ClassFinder> getDelegates()

toString

public String toString()

Overrides:

toString in class Object