net.bytebuddy.agent.builder

Class AgentBuilder.RedefinitionStrategy.Delegate<T>

java.lang.Object

net.bytebuddy.agent.builder.AgentBuilder.RedefinitionStrategy.Delegate<T>

Type Parameters:

T - The type of element that is supplied to the instrumentation API.

Direct Known Subclasses:

AgentBuilder.RedefinitionStrategy.Delegate.ForRedefinition, AgentBuilder.RedefinitionStrategy.Delegate.ForRetransformation

Enclosing class:

AgentBuilder.RedefinitionStrategy

protected abstract static class AgentBuilder.RedefinitionStrategy.Delegate<T>
extends Object

A collector is responsible for collecting classes that are to be considered for modification.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	AgentBuilder.RedefinitionStrategy.Delegate.ForRedefinition A delegate that applies a redefinition of already loaded classes.
protected static class	AgentBuilder.RedefinitionStrategy.Delegate.ForRetransformation A delegate that applies a retransformation of already loaded classes.

Field Summary

Fields

Modifier and Type	Field and Description
protected AgentBuilder.Default.Transformation	transformation The transformation of the built agent.
protected List<Class<?>>	types A list of already collected redefinitions.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Delegate(AgentBuilder.Default.Transformation transformation) Creates a new delegate.

Method Summary

Modifier and Type	Method and Description
protected void	apply(Instrumentation instrumentation, AgentBuilder.LocationStrategy locationStrategy, AgentBuilder.Listener listener, AgentBuilder.RedefinitionStrategy.BatchAllocator redefinitionBatchAllocator, AgentBuilder.RedefinitionStrategy.Listener redefinitionListener, AgentBuilder.RedefinitionStrategy.FailureHandler redefinitionFailureHandler) Applies the current retransformation process.
protected void	consider(AgentBuilder.RawMatcher ignoredTypeMatcher, AgentBuilder.Listener listener, TypeDescription typeDescription, Class<?> type, Class<?> classBeingRedefined, JavaModule module) Considers the supplied type for redefinition.
protected void	consider(AgentBuilder.RawMatcher ignoredTypeMatcher, AgentBuilder.Listener listener, TypeDescription typeDescription, Class<?> type, Class<?> classBeingRedefined, JavaModule module, boolean unmodifiable) Considers the supplied type for redefinition.
protected abstract void	doApply(List<T> transformations, Instrumentation instrumentation) Applies a type redefinition.
String	toString()
protected abstract T	transform(Class<?> type, AgentBuilder.LocationStrategy locationStrategy) Turns a type into a transformation-ready primitive of the current redefinition process.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

transformation

protected final AgentBuilder.Default.Transformation transformation

The transformation of the built agent.

types

protected final List<Class<?>> types

A list of already collected redefinitions.

Constructor Detail

Delegate

protected Delegate(AgentBuilder.Default.Transformation transformation)

Creates a new delegate.

Parameters:

transformation - The transformation of the built agent.

Method Detail

consider

protected void consider(AgentBuilder.RawMatcher ignoredTypeMatcher,
                        AgentBuilder.Listener listener,
                        TypeDescription typeDescription,
                        Class<?> type,
                        Class<?> classBeingRedefined,
                        JavaModule module)

Considers the supplied type for redefinition.

Parameters:

ignoredTypeMatcher - The ignored type matcher.

listener - The listener to notify.

typeDescription - The type's description.

type - The type being redefined.

classBeingRedefined - The type being redefined or null if it should be considered unavailable.

module - The redefined type's module or null if the current VM does not support the module system.

consider

protected void consider(AgentBuilder.RawMatcher ignoredTypeMatcher,
                        AgentBuilder.Listener listener,
                        TypeDescription typeDescription,
                        Class<?> type,
                        Class<?> classBeingRedefined,
                        JavaModule module,
                        boolean unmodifiable)

Considers the supplied type for redefinition.

Parameters:

ignoredTypeMatcher - The ignored type matcher.

listener - The listener to notify.

typeDescription - The type's description.

type - The type being redefined.

classBeingRedefined - The type being redefined or null if it should be considered unavailable.

module - The redefined type's module or null if the current VM does not support the module system.

unmodifiable - true if the type should be seen as unmodifiable.

apply

protected void apply(Instrumentation instrumentation,
                     AgentBuilder.LocationStrategy locationStrategy,
                     AgentBuilder.Listener listener,
                     AgentBuilder.RedefinitionStrategy.BatchAllocator redefinitionBatchAllocator,
                     AgentBuilder.RedefinitionStrategy.Listener redefinitionListener,
                     AgentBuilder.RedefinitionStrategy.FailureHandler redefinitionFailureHandler)

Applies the current retransformation process.

Parameters:

instrumentation - The instrumentation instance to apply the redefinition upon.

locationStrategy - The location strategy to use.

listener - The listener to notify.

redefinitionBatchAllocator - The redefinition batch allocator to use.

redefinitionListener - The redefinition listener to use.

redefinitionFailureHandler - The redefinition failure handler to use.

transform

protected abstract T transform(Class<?> type,
                               AgentBuilder.LocationStrategy locationStrategy)
                        throws IOException

Turns a type into a transformation-ready primitive of the current redefinition process.

Parameters:

type - The type to transform.

locationStrategy - The location strategy to use.

Returns:

A primitive of the current redefinition process.

Throws:

IOException - If an I/O error occured.

doApply

protected abstract void doApply(List<T> transformations,
                                Instrumentation instrumentation)
                         throws UnmodifiableClassException,
                                ClassNotFoundException

Applies a type redefinition.

Parameters:

transformations - The transformations to apply.

instrumentation - The instrumentation instance to apply the redefinition on.

Throws:

UnmodifiableClassException - If a class was not modifiable.

ClassNotFoundException - If a class was not found.

toString

public String toString()

Overrides:

toString in class Object