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 and 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 and Description
void	onBatch(int index, List<Class<?>> batch, List<Class<?>> types) Invoked before applying a batch.
void	onComplete(int amount, List<Class<?>> types, Map<List<Class<?>>,Throwable> failures) Invoked upon completion of all batches.
Iterable<? extends List<Class<?>>>	onError(int index, List<Class<?>> batch, Throwable throwable, List<Class<?>> types) Invoked upon an error during a batch.

Method Detail

onBatch

void onBatch(int index,
             List<Class<?>> batch,
             List<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

Iterable<? extends List<Class<?>>> onError(int index,
                                           List<Class<?>> batch,
                                           Throwable throwable,
                                           List<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,
                List<Class<?>> types,
                Map<List<Class<?>>,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.