jenkins

Class ClassLoaderReflectionToolkit

java.lang.Object

jenkins.ClassLoaderReflectionToolkit

public class ClassLoaderReflectionToolkit
extends Object

Reflective access to various ClassLoader methods which are otherwise protected.

Initially tries to access methods using known classloaders in use that expose the methods to prevent illegal reflective access errors on Java 11+ Then falls back to accessing the ClassLoader methods.

All reflection method initialisation is delayed until first use so that we don't access the methods if we don't need to.

Note: Currently there is no known production use-case for the fallback case of accessing these methods via reflection: the JenkinsRule tests use a different classloader, but once that is made consistent with production Jenkins we can re-evaluate the fallback code.

Constructor Summary

Constructors

Constructor and Description
ClassLoaderReflectionToolkit() Deprecated. unsafe

Method Summary

Modifier and Type	Method and Description
static Class<?>	_findClass(ClassLoader cl, String name) Calls ClassLoader.findClass(java.lang.String) while holding ClassLoader.getClassLoadingLock(java.lang.String).
static Class<?>	_findLoadedClass(ClassLoader cl, String name) Calls ClassLoader.findLoadedClass(java.lang.String) while holding ClassLoader.getClassLoadingLock(java.lang.String).
static URL	_findResource(ClassLoader cl, String name) Calls ClassLoader.findResource(java.lang.String).
static Enumeration<URL>	_findResources(ClassLoader cl, String name) Calls ClassLoader.findResources(java.lang.String).
Class	findClass(ClassLoader cl, String name) Deprecated. unsafe
Class	findLoadedClass(ClassLoader cl, String name) Deprecated. unsafe
URL	findResource(ClassLoader cl, String name) Deprecated. unsafe
Enumeration<URL>	findResources(ClassLoader cl, String name) Deprecated. unsafe

Methods inherited from class java.lang.Object

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

Constructor Detail

ClassLoaderReflectionToolkit

@Deprecated
public ClassLoaderReflectionToolkit()

Deprecated. unsafe

Method Detail

_findLoadedClass

@CheckForNull
public static Class<?> _findLoadedClass(ClassLoader cl,
                                                      String name)

Calls ClassLoader.findLoadedClass(java.lang.String) while holding ClassLoader.getClassLoadingLock(java.lang.String).

Since:

1.553

_findClass

@NonNull
public static Class<?> _findClass(ClassLoader cl,
                                           String name)
                                    throws ClassNotFoundException

Calls ClassLoader.findClass(java.lang.String) while holding ClassLoader.getClassLoadingLock(java.lang.String).

Throws:

ClassNotFoundException

Since:

1.553

_findResource

@CheckForNull
public static URL _findResource(ClassLoader cl,
                                              String name)

Calls ClassLoader.findResource(java.lang.String).

Since:

1.553

_findResources

@NonNull
public static Enumeration<URL> _findResources(ClassLoader cl,
                                                       String name)
                                                throws IOException

Calls ClassLoader.findResources(java.lang.String).

Throws:

IOException

Since:

1.553

findLoadedClass

@Deprecated
public Class findLoadedClass(ClassLoader cl,
                                         String name)
                                  throws InvocationTargetException

Deprecated. unsafe

Throws:

InvocationTargetException

findClass

@Deprecated
public Class findClass(ClassLoader cl,
                                   String name)
                            throws InvocationTargetException

Deprecated. unsafe

Throws:

InvocationTargetException

findResource

@Deprecated
public URL findResource(ClassLoader cl,
                                    String name)
                             throws InvocationTargetException

Deprecated. unsafe

Throws:

InvocationTargetException

findResources

@Deprecated
public Enumeration<URL> findResources(ClassLoader cl,
                                                  String name)
                                           throws InvocationTargetException

Deprecated. unsafe

Throws:

InvocationTargetException