Package net.bytebuddy.agent.builder

Interface AgentBuilder.RedefinitionStrategy.Listener

All Known Implementing Classes:

AgentBuilder.RedefinitionStrategy.Listener.Adapter, AgentBuilder.RedefinitionStrategy.Listener.BatchReallocator, AgentBuilder.RedefinitionStrategy.Listener.Compound, AgentBuilder.RedefinitionStrategy.Listener.ErrorEscalating, AgentBuilder.RedefinitionStrategy.Listener.NoOp, AgentBuilder.RedefinitionStrategy.Listener.Pausing, AgentBuilder.RedefinitionStrategy.Listener.StreamWriting, AgentBuilder.RedefinitionStrategy.Listener.Yielding

Enclosing class:

AgentBuilder.RedefinitionStrategy

public static interface AgentBuilder.RedefinitionStrategy.Listener

A listener to be applied during a redefinition.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	AgentBuilder.RedefinitionStrategy.Listener.Adapter	A listener adapter that offers non-operational implementations of all listener methods.
static class	AgentBuilder.RedefinitionStrategy.Listener.BatchReallocator	A batch reallocator allows to split up a failed retransformation into additional batches which are reenqueed to the current retransformation process.
static class	AgentBuilder.RedefinitionStrategy.Listener.Compound	A compound listener that delegates events to several listeners.
static class	AgentBuilder.RedefinitionStrategy.Listener.ErrorEscalating	A listener that halts a retransformation process upon an exception.
static class	AgentBuilder.RedefinitionStrategy.Listener.NoOp	A non-operational listener.
static class	AgentBuilder.RedefinitionStrategy.Listener.Pausing	A listener that invokes Thread.sleep(long) prior to every batch but the first batch.
static class	AgentBuilder.RedefinitionStrategy.Listener.StreamWriting	A listener that writes events to a PrintStream.
static class	AgentBuilder.RedefinitionStrategy.Listener.Yielding	A listener that invokes Thread.yield() prior to every batch but the first batch.

Method Summary

Modifier and Type	Method	Description
void	onBatch(int index, java.util.List<java.lang.Class<?>> batch, java.util.List<java.lang.Class<?>> types)	Invoked before applying a batch.
void	onComplete(int amount, java.util.List<java.lang.Class<?>> types, java.util.Map<java.util.List<java.lang.Class<?>>,java.lang.Throwable> failures)	Invoked upon completion of all batches.
java.lang.Iterable<? extends java.util.List<java.lang.Class<?>>>	onError(int index, java.util.List<java.lang.Class<?>> batch, java.lang.Throwable throwable, java.util.List<java.lang.Class<?>> types)	Invoked upon an error during a batch.

Method Detail

onBatch

void onBatch(int index,
             java.util.List<java.lang.Class<?>> batch,
             java.util.List<java.lang.Class<?>> types)

Invoked before applying a batch.

Parameters:

index - A running index of the batch starting at 0.

batch - The types included in this batch.

types - All types included in the redefinition.

onError

java.lang.Iterable<? extends java.util.List<java.lang.Class<?>>> onError(int index,
                                                                         java.util.List<java.lang.Class<?>> batch,
                                                                         java.lang.Throwable throwable,
                                                                         java.util.List<java.lang.Class<?>> types)

Invoked upon an error during a batch. This method is not invoked if the failure handler handled this error.

Parameters:

index - A running index of the batch starting at 0.

batch - The types included in this batch.

throwable - The throwable that caused this invocation.

types - All types included in the redefinition.

Returns:

A set of classes which should be attempted to be redefined. Typically, this should be a subset of the classes contained in batch but not all classes.

onComplete

void onComplete(int amount,
                java.util.List<java.lang.Class<?>> types,
                java.util.Map<java.util.List<java.lang.Class<?>>,java.lang.Throwable> failures)

Invoked upon completion of all batches.

Parameters:

amount - The total amount of batches that were executed.

types - All types included in the redefinition.

failures - A mapping of batch types to their unhandled failures.