Package hudson.util

Class CachingClassLoader

java.lang.Object

java.lang.ClassLoader

hudson.util.DelegatingClassLoader

hudson.util.CachingClassLoader

Direct Known Subclasses:

PluginManager.UberClassLoader

@Restricted(org.kohsuke.accmod.restrictions.NoExternalUse.class)
public class CachingClassLoader
extends DelegatingClassLoader

ClassLoader with internal caching of class loading results.

Caches both successful and failed class lookups to avoid redundant delegation and repeated class resolution attempts. Designed for performance optimization in systems that repeatedly query class presence (e.g., plugin environments, reflective loading, optional dependencies).

Useful for classloaders that have heavy-weight loadClass() implementations

Author:

Dmytro Ukhlov

Constructor Summary

Constructors

Constructor	Description
CachingClassLoader(String name, ClassLoader parent)

Method Summary

Modifier and Type	Method	Description
void	clearCacheMisses()
protected Class<?>	loadClass(String name, boolean resolve)	Parent-first delegation without synchronizing on ClassLoader.getClassLoadingLock(String).

Methods inherited from class java.lang.ClassLoader

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

Methods inherited from class java.lang.Object

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

Constructor Details

CachingClassLoader

public CachingClassLoader(String name,
 ClassLoader parent)

Method Details

loadClass

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

Description copied from class: DelegatingClassLoader

Parent-first delegation without synchronizing on ClassLoader.getClassLoadingLock(String). This prevents creation/retention of per-name lock objects in a loader that does not define classes. The defining loader downstream still serializes class definition as required.

Overrides:

loadClass in class DelegatingClassLoader

Parameters:

name - The binary name of the class

resolve - If true then resolve the class

Returns:

The resulting Class object

Throws:

ClassNotFoundException - If the class could not be found

clearCacheMisses

public void clearCacheMisses()