net.bytebuddy.agent.builder

Enum AgentBuilder.RedefinitionStrategy

java.lang.Object

java.lang.Enum<AgentBuilder.RedefinitionStrategy>

net.bytebuddy.agent.builder.AgentBuilder.RedefinitionStrategy

All Implemented Interfaces:

Serializable, Comparable<AgentBuilder.RedefinitionStrategy>

Enclosing interface:

AgentBuilder

public static enum AgentBuilder.RedefinitionStrategy
extends Enum<AgentBuilder.RedefinitionStrategy>

A redefinition strategy regulates how already loaded classes are modified by a built agent.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static interface	AgentBuilder.RedefinitionStrategy.Collector A collector is responsible for collecting classes that are to be considered for modification.

Enum Constant Summary

Enum Constants

Enum Constant and Description
DISABLED Disables redefinition such that already loaded classes are not affected by the agent.
REDEFINITION Applies a redefinition to all classes that are already loaded and that would have been transformed if the built agent was registered before they were loaded.
RETRANSFORMATION Applies a retransformation to all classes that are already loaded and that would have been transformed if the built agent was registered before they were loaded.

Method Summary

Modifier and Type	Method and Description
protected boolean	isEnabled() Indicates that this redefinition strategy applies a modification of already loaded classes.
protected abstract boolean	isRetransforming(Instrumentation instrumentation) Indicates if this strategy requires a class file transformer to be registered with a hint to apply the transformer for retransformation.
protected abstract AgentBuilder.RedefinitionStrategy.Collector	makeCollector(AgentBuilder.Default.Transformation transformation) Creates a collector instance that is responsible for collecting loaded classes for potential retransformation.
String	toString()
static AgentBuilder.RedefinitionStrategy	valueOf(String name) Returns the enum constant of this type with the specified name.
static AgentBuilder.RedefinitionStrategy[]	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

DISABLED

public static final AgentBuilder.RedefinitionStrategy DISABLED

Disables redefinition such that already loaded classes are not affected by the agent.

REDEFINITION

public static final AgentBuilder.RedefinitionStrategy REDEFINITION

Applies a redefinition to all classes that are already loaded and that would have been transformed if the built agent was registered before they were loaded.

Important: If a redefined class was previously instrumented, this instrumentation information is lost during the instrumentation. The redefinition is applied upon the original byte code that is provided by a class loader and not upon the code in its currently transformed format. Use RETRANSFORMATION if this is a factual or potential limitation.

RETRANSFORMATION

public static final AgentBuilder.RedefinitionStrategy RETRANSFORMATION

Applies a retransformation to all classes that are already loaded and that would have been transformed if the built agent was registered before they were loaded.

Method Detail

values

public static AgentBuilder.RedefinitionStrategy[] 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.RedefinitionStrategy c : AgentBuilder.RedefinitionStrategy.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.RedefinitionStrategy 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

isRetransforming

protected abstract boolean isRetransforming(Instrumentation instrumentation)

Indicates if this strategy requires a class file transformer to be registered with a hint to apply the transformer for retransformation.

Parameters:

instrumentation - The instrumentation instance used.

Returns:

true if a class file transformer must be registered with a hint for retransformation.

isEnabled

protected boolean isEnabled()

Indicates that this redefinition strategy applies a modification of already loaded classes.

Returns:

true if this redefinition strategy applies a modification of already loaded classes.

makeCollector

protected abstract AgentBuilder.RedefinitionStrategy.Collector makeCollector(AgentBuilder.Default.Transformation transformation)

Creates a collector instance that is responsible for collecting loaded classes for potential retransformation.

Parameters:

transformation - The transformation that is registered for the agent.

Returns:

A new collector for collecting already loaded classes for transformation.

toString

public String toString()

Overrides:

toString in class Enum<AgentBuilder.RedefinitionStrategy>