org.springframework.core

Class DecoratingClassLoader

java.lang.Object

java.lang.ClassLoader

org.springframework.core.DecoratingClassLoader

Direct Known Subclasses:

ContextTypeMatchClassLoader, OverridingClassLoader, ShadowingClassLoader

@UsesJava7
public abstract class DecoratingClassLoader
extends java.lang.ClassLoader

Base class for decorating ClassLoaders such as OverridingClassLoader and ShadowingClassLoader, providing common handling of excluded packages and classes.

Since:

2.5.2

Author:

Juergen Hoeller, Rod Johnson

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Set<java.lang.String>	excludedClasses
private java.util.Set<java.lang.String>	excludedPackages
private java.lang.Object	exclusionMonitor
protected static boolean	parallelCapableClassLoaderAvailable Java 7+ ClassLoader.registerAsParallelCapable() available?

Constructor Summary

Constructors

Constructor and Description
DecoratingClassLoader() Create a new DecoratingClassLoader with no parent ClassLoader.
DecoratingClassLoader(java.lang.ClassLoader parent) Create a new DecoratingClassLoader using the given parent ClassLoader for delegation.

Method Summary

Modifier and Type	Method and Description
void	excludeClass(java.lang.String className) Add a class name to exclude from decoration (e.g.
void	excludePackage(java.lang.String packageName) Add a package name to exclude from decoration (e.g.
protected boolean	isExcluded(java.lang.String className) Determine whether the specified class is excluded from decoration by this class loader.

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLibrary, findLoadedClass, findResource, findResources, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getResource, getResourceAsStream, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, 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

Field Detail

parallelCapableClassLoaderAvailable

protected static final boolean parallelCapableClassLoaderAvailable

Java 7+ ClassLoader.registerAsParallelCapable() available?

Since:

4.1.2

excludedPackages

private final java.util.Set<java.lang.String> excludedPackages

excludedClasses

private final java.util.Set<java.lang.String> excludedClasses

exclusionMonitor

private final java.lang.Object exclusionMonitor

Constructor Detail

DecoratingClassLoader

public DecoratingClassLoader()

Create a new DecoratingClassLoader with no parent ClassLoader.

DecoratingClassLoader

public DecoratingClassLoader(java.lang.ClassLoader parent)

Create a new DecoratingClassLoader using the given parent ClassLoader for delegation.

Method Detail

excludePackage

public void excludePackage(java.lang.String packageName)

Add a package name to exclude from decoration (e.g. overriding).

Any class whose fully-qualified name starts with the name registered here will be handled by the parent ClassLoader in the usual fashion.

Parameters:

packageName - the package name to exclude

excludeClass

public void excludeClass(java.lang.String className)

Add a class name to exclude from decoration (e.g. overriding).

Any class name registered here will be handled by the parent ClassLoader in the usual fashion.

Parameters:

className - the class name to exclude

isExcluded

protected boolean isExcluded(java.lang.String className)

Determine whether the specified class is excluded from decoration by this class loader.

The default implementation checks against excluded packages and classes.

Parameters:

className - the class name to check

Returns:

whether the specified class is eligible

See Also:

excludePackage(java.lang.String), excludeClass(java.lang.String)