Package net.bytebuddy.agent.builder
Class AgentBuilder.Listener.StreamWriting
- java.lang.Object
-
- net.bytebuddy.agent.builder.AgentBuilder.Listener.StreamWriting
-
- All Implemented Interfaces:
AgentBuilder.Listener
- Enclosing interface:
- AgentBuilder.Listener
@Enhance public static class AgentBuilder.Listener.StreamWriting extends java.lang.Object implements AgentBuilder.Listener
A listener that writes events to aPrintStream
. This listener prints a line per event, including the event type and the name of the type in question.
-
-
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 Modifier and Type Field Description protected static java.lang.String
PREFIX
The prefix that is appended to all written messages.private java.io.PrintStream
printStream
The print stream written to.-
Fields inherited from interface net.bytebuddy.agent.builder.AgentBuilder.Listener
LOADED
-
-
Constructor Summary
Constructors Constructor Description StreamWriting(java.io.PrintStream printStream)
Creates a new stream writing listener.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description void
onComplete(java.lang.String typeName, java.lang.ClassLoader classLoader, JavaModule module, boolean loaded)
Invoked after a class was attempted to be loaded, independently of its treatment.void
onDiscovery(java.lang.String typeName, java.lang.ClassLoader classLoader, JavaModule module, boolean loaded)
Invoked upon a type being supplied to a transformer.void
onError(java.lang.String typeName, java.lang.ClassLoader classLoader, JavaModule module, boolean loaded, java.lang.Throwable throwable)
Invoked when an error has occurred during transformation.void
onIgnored(TypeDescription typeDescription, java.lang.ClassLoader classLoader, JavaModule module, boolean loaded)
Invoked when a type is not transformed but ignored.void
onTransformation(TypeDescription typeDescription, java.lang.ClassLoader classLoader, JavaModule module, boolean loaded, DynamicType dynamicType)
Invoked prior to a successful transformation being applied.static AgentBuilder.Listener.StreamWriting
toSystemError()
Creates a new stream writing listener that writes toSystem.err
.static AgentBuilder.Listener.StreamWriting
toSystemOut()
Creates a new stream writing listener that writes toSystem.out
.AgentBuilder.Listener
withErrorsOnly()
Returns a version of this listener that only reports failed transformations.AgentBuilder.Listener
withTransformationsOnly()
Returns a version of this listener that only reports successfully transformed classes and failed transformations.
-
-
-
Field Detail
-
PREFIX
protected static final java.lang.String PREFIX
The prefix that is appended to all written messages.- See Also:
- Constant Field Values
-
printStream
private final java.io.PrintStream printStream
The print stream written to.
-
-
Method Detail
-
toSystemOut
public static AgentBuilder.Listener.StreamWriting toSystemOut()
Creates a new stream writing listener that writes toSystem.out
.- Returns:
- A listener writing events to the standard output stream.
-
toSystemError
public static AgentBuilder.Listener.StreamWriting toSystemError()
Creates a new stream writing listener that writes toSystem.err
.- Returns:
- A listener writing events to the standard error stream.
-
withTransformationsOnly
public AgentBuilder.Listener withTransformationsOnly()
Returns a version of this listener that only reports successfully transformed classes and failed transformations.- Returns:
- A version of this listener that only reports successfully transformed classes and failed transformations.
-
withErrorsOnly
public AgentBuilder.Listener withErrorsOnly()
Returns a version of this listener that only reports failed transformations.- Returns:
- A version of this listener that only reports failed transformations.
-
onDiscovery
public void onDiscovery(java.lang.String typeName, java.lang.ClassLoader classLoader, JavaModule module, boolean loaded)
Invoked upon a type being supplied to a transformer.- Specified by:
onDiscovery
in interfaceAgentBuilder.Listener
- Parameters:
typeName
- The binary name of the instrumented type.classLoader
- The class loader which is loading this type.module
- The instrumented type's module ornull
if the current VM does not support modules.loaded
-true
if the type is already loaded.
-
onTransformation
public void onTransformation(TypeDescription typeDescription, java.lang.ClassLoader classLoader, JavaModule module, boolean loaded, DynamicType dynamicType)
Invoked prior to a successful transformation being applied.- Specified by:
onTransformation
in interfaceAgentBuilder.Listener
- Parameters:
typeDescription
- The type that is being transformed.classLoader
- The class loader which is loading this type.module
- The transformed type's module ornull
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, java.lang.ClassLoader classLoader, JavaModule module, boolean loaded)
Invoked when a type is not transformed but ignored.- Specified by:
onIgnored
in interfaceAgentBuilder.Listener
- Parameters:
typeDescription
- The type being ignored for transformation.classLoader
- The class loader which is loading this type.module
- The ignored type's module ornull
if the current VM does not support modules.loaded
-true
if the type is already loaded.
-
onError
public void onError(java.lang.String typeName, java.lang.ClassLoader classLoader, JavaModule module, boolean loaded, java.lang.Throwable throwable)
Invoked when an error has occurred during transformation.- Specified by:
onError
in interfaceAgentBuilder.Listener
- Parameters:
typeName
- The binary name of the instrumented type.classLoader
- The class loader which is loading this type.module
- The instrumented type's module ornull
if the current VM does not support modules.loaded
-true
if the type is already loaded.throwable
- The occurred error.
-
onComplete
public void onComplete(java.lang.String typeName, java.lang.ClassLoader classLoader, JavaModule module, boolean loaded)
Invoked after a class was attempted to be loaded, independently of its treatment.- Specified by:
onComplete
in interfaceAgentBuilder.Listener
- Parameters:
typeName
- The binary name of the instrumented type.classLoader
- The class loader which is loading this type.module
- The instrumented type's module ornull
if the current VM does not support modules.loaded
-true
if the type is already loaded.
-
-