net.bytebuddy.agent.builder

Class AgentBuilder.Listener.Filtering

java.lang.Object

net.bytebuddy.agent.builder.AgentBuilder.Listener.Filtering

All Implemented Interfaces:

AgentBuilder.Listener

Enclosing interface:

AgentBuilder.Listener

@HashCodeAndEqualsPlugin.Enhance
public static class AgentBuilder.Listener.Filtering
extends Object
implements AgentBuilder.Listener

A listener that filters types with a given name from being logged.

Nested Class Summary

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

AgentBuilder.Listener.Adapter, AgentBuilder.Listener.Compound, AgentBuilder.Listener.Filtering, AgentBuilder.Listener.ModuleReadEdgeCompleting, AgentBuilder.Listener.NoOp, AgentBuilder.Listener.StreamWriting, AgentBuilder.Listener.WithErrorsOnly, AgentBuilder.Listener.WithTransformationsOnly

Field Summary

Fields inherited from interface net.bytebuddy.agent.builder.AgentBuilder.Listener

LOADED

Constructor Summary

Constructors

Constructor and Description
Filtering(ElementMatcher<? super String> matcher, AgentBuilder.Listener delegate) Creates a new filtering listener.

Method Summary

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

Methods inherited from class java.lang.Object

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

Constructor Detail

Filtering

public Filtering(ElementMatcher<? super String> matcher,
                 AgentBuilder.Listener delegate)

Creates a new filtering listener.

Parameters:

matcher - The matcher to decide upon a type should be logged.

delegate - The delegate listener.

Method Detail

onDiscovery

public void onDiscovery(String typeName,
                        @MaybeNull
                        ClassLoader classLoader,
                        @MaybeNull
                        JavaModule module,
                        boolean loaded)

Invoked upon a type being supplied to a transformer.

Specified by:

onDiscovery in interface AgentBuilder.Listener

Parameters:

typeName - The binary name of the instrumented type.

classLoader - The class loader which is loading this type or null if loaded by the boots loader.

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

loaded - true if the type is already loaded.

onTransformation

public void onTransformation(TypeDescription typeDescription,
                             @MaybeNull
                             ClassLoader classLoader,
                             @MaybeNull
                             JavaModule module,
                             boolean loaded,
                             DynamicType dynamicType)

Invoked prior to a successful transformation being applied.

Specified by:

onTransformation in interface AgentBuilder.Listener

Parameters:

typeDescription - The type that is being transformed.

classLoader - The class loader which is loading this type or null if loaded by the boots loader.

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

loaded - true if the type is already loaded.

dynamicType - The dynamic type that was created.

onIgnored

public void onIgnored(TypeDescription typeDescription,
                      @MaybeNull
                      ClassLoader classLoader,
                      @MaybeNull
                      JavaModule module,
                      boolean loaded)

Invoked when a type is not transformed but ignored.

Specified by:

onIgnored in interface AgentBuilder.Listener

Parameters:

typeDescription - The type being ignored for transformation.

classLoader - The class loader which is loading this type or null if loaded by the boots loader.

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

loaded - true if the type is already loaded.

onError

public void onError(String typeName,
                    @MaybeNull
                    ClassLoader classLoader,
                    @MaybeNull
                    JavaModule module,
                    boolean loaded,
                    Throwable throwable)

Invoked when an error has occurred during transformation.

Specified by:

onError in interface AgentBuilder.Listener

Parameters:

typeName - The binary name of the instrumented type.

classLoader - The class loader which is loading this type or null if loaded by the boots loader.

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

loaded - true if the type is already loaded.

throwable - The occurred error.

onComplete

public void onComplete(String typeName,
                       @MaybeNull
                       ClassLoader classLoader,
                       @MaybeNull
                       JavaModule module,
                       boolean loaded)

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

Specified by:

onComplete in interface AgentBuilder.Listener

Parameters:

typeName - The binary name of the instrumented type.

classLoader - The class loader which is loading this type or null if loaded by the boots loader.

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

loaded - true if the type is already loaded.