Package io.opentelemetry.javaagent.tooling.instrumentation.indy

Class InstrumentationModuleClassLoader

java.lang.Object

java.lang.ClassLoader

io.opentelemetry.javaagent.tooling.instrumentation.indy.InstrumentationModuleClassLoader

public class InstrumentationModuleClassLoader
extends ClassLoader

Classloader used to load the helper classes from InstrumentationModules, so that those classes have access to both the agent/extension classes and the instrumented application classes.

This classloader implements the following classloading delegation strategy:

• First, injected classes are considered (usually the helper classes from the InstrumentationModule)
• Next, the classloader looks in the agent or extension classloader, depending on where the InstrumentationModule comes from
• Finally, the instrumented application classloader is checked for the class

In addition, this classloader ensures that the lookup of corresponding .class resources follow the same delegation strategy, so that bytecode inspection tools work correctly.

Field Summary

Fields

Modifier and Type	Field	Description
static final Map<String,byte[]>	bytecodeOverride

Constructor Summary

Constructors

Constructor	Description
InstrumentationModuleClassLoader(ClassLoader instrumentedCl, ClassLoader agentOrExtensionCl, Map<String,io.opentelemetry.javaagent.tooling.BytecodeWithUrl> injectedClasses)

Method Summary

Modifier and Type	Method	Description
MethodHandles.Lookup	getLookup()	Provides a Lookup within this classloader.
URL	getResource(String resourceName)
Enumeration<URL>	getResources(String resourceName)
protected Class<?>	loadClass(String name, boolean resolve)

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, getResourceAsStream, 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

Field Details

bytecodeOverride

public static final Map<String,byte[]> bytecodeOverride

Constructor Details

InstrumentationModuleClassLoader

public InstrumentationModuleClassLoader(ClassLoader instrumentedCl,
 ClassLoader agentOrExtensionCl,
 Map<String,io.opentelemetry.javaagent.tooling.BytecodeWithUrl> injectedClasses)

Method Details

getLookup

public MethodHandles.Lookup getLookup()

Provides a Lookup within this classloader. See LookupExposer for the details.

Returns:

a lookup capable of accessing public types in this classloader

loadClass

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

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException

getResource

public URL getResource(String resourceName)

Overrides:

getResource in class ClassLoader

getResources

public Enumeration<URL> getResources(String resourceName)
                              throws IOException

Overrides:

getResources in class ClassLoader

Throws:

IOException