Package io.opentelemetry.javaagent.bootstrap

Class AgentClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

io.opentelemetry.javaagent.bootstrap.AgentClassLoader

All Implemented Interfaces:

Closeable, AutoCloseable

public class AgentClassLoader
extends URLClassLoader

Classloader used to run the core agent.

It is built around the concept of a jar inside another jar. This class loader loads the files of the internal jar to load classes and resources.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	AgentClassLoader.BootstrapClassLoaderProxy	A stand-in for the bootstrap class loader.

Constructor Summary

Constructors

Constructor	Description
AgentClassLoader(File javaagentFile)
AgentClassLoader(File javaagentFile, String internalJarFileName, boolean isSecurityManagerSupportEnabled)	Construct a new AgentClassLoader.
AgentClassLoader(File javaagentFile, String internalJarFileName, boolean isSecurityManagerSupportEnabled, ClassLoader parentClassLoader)	Construct a new AgentClassLoader with a custom parent ClassLoader.

Method Summary

Modifier and Type	Method	Description
Class<?>	defineClass(String name, byte[] bytes)
URL	findResource(String name)
Enumeration<URL>	findResources(String name)
AgentClassLoader.BootstrapClassLoaderProxy	getBootstrapProxy()
protected String	getClassSuffix()
protected PermissionCollection	getPermissions(CodeSource codeSource)
URL	getResource(String resourceName)
Class<?>	loadClass(String name, boolean resolve)

Methods inherited from class java.net.URLClassLoader

addURL, close, definePackage, findClass, 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, getClassLoadingLock, getDefinedPackage, getDefinedPackages, getName, getPackage, getPackages, getParent, getPlatformClassLoader, 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

AgentClassLoader

public AgentClassLoader(File javaagentFile)

AgentClassLoader

public AgentClassLoader(File javaagentFile,
 String internalJarFileName,
 boolean isSecurityManagerSupportEnabled)

Construct a new AgentClassLoader.

Parameters:

javaagentFile - Used for resource lookups.

internalJarFileName - File name of the internal jar

isSecurityManagerSupportEnabled - Whether this class loader should define classes with all permissions

AgentClassLoader

public AgentClassLoader(File javaagentFile,
 String internalJarFileName,
 boolean isSecurityManagerSupportEnabled,
 @Nullable
 ClassLoader parentClassLoader)

Construct a new AgentClassLoader with a custom parent ClassLoader. This is used by some 3rd party command-line utilities in order to reuse classes that are bundled as classdata files under `inst/`.

Parameters:

javaagentFile - Used for resource lookups.

internalJarFileName - File name of the internal jar

isSecurityManagerSupportEnabled - Whether this class loader should define classes with all permissions

parentClassLoader - Custom parent ClassLoader to use. If null, the default parent will be used.

Method Details

loadClass

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

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException

defineClass

public Class<?> defineClass(String name,
 byte[] bytes)

getPermissions

protected PermissionCollection getPermissions(CodeSource codeSource)

Overrides:

getPermissions in class URLClassLoader

getClassSuffix

protected String getClassSuffix()

getResource

public URL getResource(String resourceName)

Overrides:

getResource in class ClassLoader

findResource

public URL findResource(String name)

Overrides:

findResource in class URLClassLoader

findResources

public Enumeration<URL> findResources(String name)
                               throws IOException

Overrides:

findResources in class URLClassLoader

Throws:

IOException

getBootstrapProxy

public AgentClassLoader.BootstrapClassLoaderProxy getBootstrapProxy()