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

Class loader 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 class loader implements the following classloading delegation strategy:

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

In addition, this class loader 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)

Method Summary

Modifier and Type	Method	Description
MethodHandles.Lookup	getLookup()	Provides a Lookup within this class loader.
URL	getResource(String resourceName)
Enumeration<URL>	getResources(String resourceName)
boolean	hasModuleInstalled(io.opentelemetry.javaagent.extension.instrumentation.InstrumentationModule module)
void	installModule(io.opentelemetry.javaagent.extension.instrumentation.InstrumentationModule module)
Class<?>	loadClass(String name)
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, 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)

Method Details

getLookup

public MethodHandles.Lookup getLookup()

Provides a Lookup within this class loader. See LookupExposer for the details.

Returns:

a lookup capable of accessing public types in this class loader

installModule

public void installModule(io.opentelemetry.javaagent.extension.instrumentation.InstrumentationModule module)

hasModuleInstalled

public boolean hasModuleInstalled(io.opentelemetry.javaagent.extension.instrumentation.InstrumentationModule module)

loadClass

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

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException

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