Package jenkins.util

Class URLClassLoader2

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

jenkins.util.URLClassLoader2

All Implemented Interfaces:

Closeable, AutoCloseable, JenkinsClassLoader

Direct Known Subclasses:

PluginFirstClassLoader2

@Restricted(org.kohsuke.accmod.restrictions.NoExternalUse.class)
public class URLClassLoader2
extends URLClassLoader
implements JenkinsClassLoader

URLClassLoader with loosened visibility for use with ClassLoaderReflectionToolkit.

Constructor Summary

Constructors

Constructor	Description
URLClassLoader2(String name, URL[] urls)	Create a new URLClassLoader2 with the given name and URLS and the ClassLoader.getSystemClassLoader() as its parent.
URLClassLoader2(String name, URL[] urls, ClassLoader parent)	Create a new URLClassLoader2 with the given name, URLS parent.
URLClassLoader2(URL[] urls)	Deprecated. use URLClassLoader2(String, URL[])
URLClassLoader2(URL[] urls, ClassLoader parent)	Deprecated. use URLClassLoader2(String, URL[], ClassLoader)

Method Summary

Modifier and Type	Method	Description
void	addURL(URL url)
Class<?>	findClass(String name)	Public version of ClassLoader.findClass(String)
Class<?>	findLoadedClass2(String name)	Public version of ClassLoader.findLoadedClass(String)
Object	getClassLoadingLock(String className)	Replace the JDK's per-name lock map with a GC-collectable lock object.

Methods inherited from class java.net.URLClassLoader

close, definePackage, findResource, findResources, getPermissions, getResourceAsStream, getURLs, newInstance, newInstance

Methods inherited from class java.security.SecureClassLoader

defineClass, defineClass

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLibrary, findLoadedClass, findResource, findSystemClass, getDefinedPackage, getDefinedPackages, getName, getPackage, getPackages, getParent, getPlatformClassLoader, getResource, 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, toString, wait, wait, wait

Methods inherited from interface jenkins.util.JenkinsClassLoader

findResource, findResources

Constructor Details

URLClassLoader2

@Deprecated(since="2.459")
public URLClassLoader2(URL[] urls)

Deprecated.

use URLClassLoader2(String, URL[])

URLClassLoader2

@Deprecated(since="2.459")
public URLClassLoader2(URL[] urls,
 ClassLoader parent)

Deprecated.

use URLClassLoader2(String, URL[], ClassLoader)

URLClassLoader2

public URLClassLoader2(String name,
 URL[] urls)

Create a new URLClassLoader2 with the given name and URLS and the ClassLoader.getSystemClassLoader() as its parent.

Parameters:

name - name of this classloader.

urls - the list of URLS to find classes in.

Since:

2.459

URLClassLoader2

public URLClassLoader2(String name,
 URL[] urls,
 ClassLoader parent)

Create a new URLClassLoader2 with the given name, URLS parent.

Parameters:

name - name of this classloader.

urls - the list of URLS to find classes in.

parent - the parent to search for classes before we look in the urls

Since:

2.459

Method Details

addURL

public void addURL(URL url)

Overrides:

addURL in class URLClassLoader

findClass

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

Description copied from interface: JenkinsClassLoader

Public version of ClassLoader.findClass(String)

Specified by:

findClass in interface JenkinsClassLoader

Overrides:

findClass in class URLClassLoader

Throws:

ClassNotFoundException

findLoadedClass2

public Class<?> findLoadedClass2(String name)

Description copied from interface: JenkinsClassLoader

Public version of ClassLoader.findLoadedClass(String)

Specified by:

findLoadedClass2 in interface JenkinsClassLoader

getClassLoadingLock

public Object getClassLoadingLock(String className)

Replace the JDK's per-name lock map with a GC-collectable lock object. This is a workaround for JDK-8005233. When JDK-8005233 is resolved, this should be deleted. See also the discussion in this OpenJDK thread.

Parallel-capable ClassLoader implementations keep a distinct lock object per class name indefinitely, which can retain huge maps when there are many misses. Returning an interned String keyed by this loader and the class name preserves mutual exclusion for a given (loader, name) pair but allows the JVM to reclaim the lock when no longer referenced. Interned Strings are heap objects and GC-eligible on modern JDKs (7+).

Specified by:

getClassLoadingLock in interface JenkinsClassLoader

Overrides:

getClassLoadingLock in class ClassLoader

Parameters:

className - the binary name of the class being loaded (must not be null)

Returns:

a lock object unique to this classloader/class pair