net.bytebuddy.agent.builder

Class AgentBuilder.Listener.Resubmitting

java.lang.Object

net.bytebuddy.agent.builder.AgentBuilder.Listener.Adapter

net.bytebuddy.agent.builder.AgentBuilder.Listener.Resubmitting

All Implemented Interfaces:

Runnable, AgentBuilder.Listener

Enclosing interface:

AgentBuilder.Listener

public static class AgentBuilder.Listener.Resubmitting
extends AgentBuilder.Listener.Adapter
implements Runnable

A resubmitting instrumentation listener which attempts to load types after their instrumentation and submits them for retransformation or redefinition.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	AgentBuilder.Listener.Resubmitting.LookupKey A key for a class loader that can only be used for looking up a preexisting value but avoids reference management.
protected static class	AgentBuilder.Listener.Resubmitting.StorageKey A key for a class loader that only weakly references the class loader.

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.Resubmitting, AgentBuilder.Listener.StreamWriting

Constructor Summary

Constructors

Modifier	Constructor and Description
	Resubmitting(Instrumentation instrumentation) Creates a new resubmission listener that is using a AgentBuilder.RedefinitionStrategy.RETRANSFORMATION.
	Resubmitting(Instrumentation instrumentation, AgentBuilder.Listener listener, AgentBuilder.LocationStrategy locationStrategy, AgentBuilder.RedefinitionStrategy.BatchAllocator redefinitionBatchAllocator) Creates a new resubmission listener that is using a AgentBuilder.RedefinitionStrategy.REDEFINITION.
protected	Resubmitting(Instrumentation instrumentation, AgentBuilder.Listener listener, AgentBuilder.LocationStrategy locationStrategy, AgentBuilder.RedefinitionStrategy redefinitionStrategy, AgentBuilder.RedefinitionStrategy.BatchAllocator redefinitionBatchAllocator, AgentBuilder.RedefinitionStrategy.Listener redefinitionListener, ElementMatcher.Junction<? super Throwable> matcher) Creates a new resubmission listener.
	Resubmitting(Instrumentation instrumentation, AgentBuilder.RedefinitionStrategy.BatchAllocator redefinitionBatchAllocator) Creates a new resubmission listener that is using a AgentBuilder.RedefinitionStrategy.RETRANSFORMATION.

Method Summary

Modifier and Type	Method and Description
AgentBuilder.Listener.Resubmitting	filter(ElementMatcher<? super Throwable> matcher) Narrows this type matcher to only be applied onto certain exceptions caused by the instrumentation process.
void	onError(String typeName, ClassLoader classLoader, JavaModule module, boolean loaded, Throwable throwable) Invoked when an error has occurred during transformation.
void	run()
AgentBuilder.Listener	scheduled(ScheduledExecutorService executorService, long time, TimeUnit timeUnit) Schedules this resubmitter at the specified rate.
AgentBuilder.Listener.Resubmitting	with(AgentBuilder.RedefinitionStrategy.Listener redefinitionListener) Applies the supplied redefinition listener additionally to any previously registered listeners.

Methods inherited from class net.bytebuddy.agent.builder.AgentBuilder.Listener.Adapter

onComplete, onIgnored, onTransformation

Methods inherited from class java.lang.Object

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

Constructor Detail

Resubmitting

public Resubmitting(Instrumentation instrumentation)

Creates a new resubmission listener that is using a AgentBuilder.RedefinitionStrategy.RETRANSFORMATION. During the retransformation, all types are submitted in a single batch and no listener is notified.

Parameters:

instrumentation - The instrumentation instance to use.

Resubmitting

public Resubmitting(Instrumentation instrumentation,
                    AgentBuilder.RedefinitionStrategy.BatchAllocator redefinitionBatchAllocator)

Creates a new resubmission listener that is using a AgentBuilder.RedefinitionStrategy.RETRANSFORMATION.

Parameters:

instrumentation - The instrumentation instance to use.

redefinitionBatchAllocator - The redefinition batch allocator.

Resubmitting

public Resubmitting(Instrumentation instrumentation,
                    AgentBuilder.Listener listener,
                    AgentBuilder.LocationStrategy locationStrategy,
                    AgentBuilder.RedefinitionStrategy.BatchAllocator redefinitionBatchAllocator)

Creates a new resubmission listener that is using a AgentBuilder.RedefinitionStrategy.REDEFINITION.

Parameters:

instrumentation - The instrumentation instance to use.

listener - The listener to notify when a location strategy fails for a type.

locationStrategy - The location strategy to use.

redefinitionBatchAllocator - The redefinition batch allocator.

Resubmitting

protected Resubmitting(Instrumentation instrumentation,
                       AgentBuilder.Listener listener,
                       AgentBuilder.LocationStrategy locationStrategy,
                       AgentBuilder.RedefinitionStrategy redefinitionStrategy,
                       AgentBuilder.RedefinitionStrategy.BatchAllocator redefinitionBatchAllocator,
                       AgentBuilder.RedefinitionStrategy.Listener redefinitionListener,
                       ElementMatcher.Junction<? super Throwable> matcher)

Creates a new resubmission listener.

Parameters:

instrumentation - The instrumentation instance to use.

listener - The listener to notify when a location strategy fails for a type.

locationStrategy - The location strategy to use.

redefinitionStrategy - The redefinition strategy to use.

redefinitionBatchAllocator - The redefinition batch allocator.

redefinitionListener - The redefinition listener.

matcher - The matcher to apply onto occured exceptions.

Method Detail

onError

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

Description copied from interface: AgentBuilder.Listener

Invoked when an error has occurred during transformation.

Specified by:

onError in interface AgentBuilder.Listener

Overrides:

onError in class AgentBuilder.Listener.Adapter

Parameters:

typeName - The type name of the instrumented type.

classLoader - The class loader which is loading this type.

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.

with

public AgentBuilder.Listener.Resubmitting with(AgentBuilder.RedefinitionStrategy.Listener redefinitionListener)

Applies the supplied redefinition listener additionally to any previously registered listeners.

Parameters:

redefinitionListener - The redefinition listener to apply.

Returns:

A new resubmitting listener that notifies the specified listener upon a redefinition.

filter

public AgentBuilder.Listener.Resubmitting filter(ElementMatcher<? super Throwable> matcher)

Narrows this type matcher to only be applied onto certain exceptions caused by the instrumentation process.

Parameters:

matcher - The matcher that filters any throwables of the instrumentation process.

Returns:

A new resubmitting listener that ignores unmatched throwables.

run

public void run()

Specified by:

run in interface Runnable

scheduled

public AgentBuilder.Listener scheduled(ScheduledExecutorService executorService,
                                       long time,
                                       TimeUnit timeUnit)

Schedules this resubmitter at the specified rate.

Parameters:

executorService - The executor service to which the task is scheduled.

time - The time between two resubmissions.

timeUnit - The time unit of the specified time.

Returns:

This listener to be registered with an agent builder.