net.bytebuddy.agent.builder

Enum AgentBuilder.BinaryLocator.ClassLoading

java.lang.Object

java.lang.Enum<AgentBuilder.BinaryLocator.ClassLoading>

net.bytebuddy.agent.builder.AgentBuilder.BinaryLocator.ClassLoading

All Implemented Interfaces:

Serializable, Comparable<AgentBuilder.BinaryLocator.ClassLoading>, AgentBuilder.BinaryLocator

Enclosing interface:

AgentBuilder.BinaryLocator

public static enum AgentBuilder.BinaryLocator.ClassLoading
extends Enum<AgentBuilder.BinaryLocator.ClassLoading>
implements AgentBuilder.BinaryLocator

A binary locator that loads referenced classes instead of describing unloaded versions.

Important: It is important to never query this binary locator for the currently instrumented type as this will yield a class loading circularity which aborts any instrumentation with an error.

Warning: Warning, this binary locator cannot be used for applying a redefinition as it works on loaded classes only and is agnostic of any way to locate a class file.

Nested Class Summary

Nested classes/interfaces inherited from interface net.bytebuddy.agent.builder.AgentBuilder.BinaryLocator

AgentBuilder.BinaryLocator.ClassLoading, AgentBuilder.BinaryLocator.Default

Enum Constant Summary

Enum Constants

Enum Constant and Description
INSTANCE The singleton instance.

Method Summary

Modifier and Type	Method and Description
ClassFileLocator	classFileLocator(ClassLoader classLoader) Creates a class file locator for the given class loader.
String	toString()
TypePool	typePool(ClassFileLocator classFileLocator, ClassLoader classLoader) Creates a type pool for a given class file locator.
static AgentBuilder.BinaryLocator.ClassLoading	valueOf(String name) Returns the enum constant of this type with the specified name.
static AgentBuilder.BinaryLocator.ClassLoading[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

INSTANCE

public static final AgentBuilder.BinaryLocator.ClassLoading INSTANCE

The singleton instance.

Method Detail

values

public static AgentBuilder.BinaryLocator.ClassLoading[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (AgentBuilder.BinaryLocator.ClassLoading c : AgentBuilder.BinaryLocator.ClassLoading.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static AgentBuilder.BinaryLocator.ClassLoading valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

classFileLocator

public ClassFileLocator classFileLocator(ClassLoader classLoader)

Description copied from interface: AgentBuilder.BinaryLocator

Creates a class file locator for the given class loader.

Specified by:

classFileLocator in interface AgentBuilder.BinaryLocator

Parameters:

classLoader - The class loader for which a class file locator should be created. Can be null to represent the bootstrap class loader.

Returns:

An appropriate class file locator.

typePool

public TypePool typePool(ClassFileLocator classFileLocator,
                         ClassLoader classLoader)

Description copied from interface: AgentBuilder.BinaryLocator

Creates a type pool for a given class file locator.

Specified by:

typePool in interface AgentBuilder.BinaryLocator

Parameters:

classFileLocator - The class file locator to use.

classLoader - The class loader for which the class file locator was created.

Returns:

A type pool for the supplied class file locator.

toString

public String toString()

Overrides:

toString in class Enum<AgentBuilder.BinaryLocator.ClassLoading>