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 enum	AgentBuilder.RedefinitionStrategy.Listener.ErrorEscalating	A listener that halts a retransformation process upon an exception.
static enum	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 enum	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, 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 Details

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.