net.bytebuddy.agent.builder

Interface AgentBuilder.Listener

All Known Implementing Classes:

AgentBuilder.Listener.Adapter, AgentBuilder.Listener.Compound, AgentBuilder.Listener.ModuleReadEdgeCompleting, AgentBuilder.Listener.NoOp, AgentBuilder.Listener.StreamWriting

Enclosing interface:

AgentBuilder

public static interface AgentBuilder.Listener

A listener that is informed about events that occur during an instrumentation process.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	AgentBuilder.Listener.Adapter An adapter for a listener wher all methods are implemented as non-operational.
static class	AgentBuilder.Listener.Compound A compound listener that allows to group several listeners in one instance.
static class	AgentBuilder.Listener.ModuleReadEdgeCompleting A listener that adds read-edges to any module of an instrumented class upon its transformation.
static class	AgentBuilder.Listener.NoOp A no-op implementation of a AgentBuilder.Listener.
static class	AgentBuilder.Listener.StreamWriting A listener that writes events to a PrintStream.

Method Summary

Modifier and Type	Method and Description
void	onComplete(String typeName, ClassLoader classLoader, JavaModule module) Invoked after a class was attempted to be loaded, independently of its treatment.
void	onError(String typeName, ClassLoader classLoader, JavaModule module, Throwable throwable) Invoked when an error has occurred during transformation.
void	onIgnored(TypeDescription typeDescription, ClassLoader classLoader, JavaModule module) Invoked when a type is not transformed but ignored.
void	onTransformation(TypeDescription typeDescription, ClassLoader classLoader, JavaModule module, DynamicType dynamicType) Invoked right before a successful transformation is applied.

Method Detail

onTransformation

void onTransformation(TypeDescription typeDescription,
                      ClassLoader classLoader,
                      JavaModule module,
                      DynamicType dynamicType)

Invoked right before a successful transformation is applied.

Parameters:

typeDescription - The type that is being transformed.

classLoader - The class loader which is loading this type.

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

dynamicType - The dynamic type that was created.

onIgnored

void onIgnored(TypeDescription typeDescription,
               ClassLoader classLoader,
               JavaModule module)

Invoked when a type is not transformed but ignored.

Parameters:

typeDescription - The type being ignored for transformation.

classLoader - The class loader which is loading this type.

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

onError

void onError(String typeName,
             ClassLoader classLoader,
             JavaModule module,
             Throwable throwable)

Invoked when an error has occurred during transformation.

Parameters:

typeName - The type name of the instrumented type.

classLoader - The class loader which is loading this type.

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

throwable - The occurred error.

onComplete

void onComplete(String typeName,
                ClassLoader classLoader,
                JavaModule module)

Invoked after a class was attempted to be loaded, independently of its treatment.

Parameters:

typeName - The binary name of the instrumented type.

classLoader - The class loader which is loading this type.

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