net.bytebuddy.agent.builder

Class AgentBuilder.Default.Redefining

java.lang.Object

net.bytebuddy.agent.builder.AgentBuilder.Default

net.bytebuddy.agent.builder.AgentBuilder.Default.Redefining

All Implemented Interfaces:

AgentBuilder, AgentBuilder.RedefinitionListenable, AgentBuilder.RedefinitionListenable.WithoutBatchStrategy

Enclosing class:

AgentBuilder.Default

protected static class AgentBuilder.Default.Redefining
extends AgentBuilder.Default
implements AgentBuilder.RedefinitionListenable.WithoutBatchStrategy

An implementation of a default agent builder that allows for refinement of the redefinition strategy.

Nested Class Summary

Nested classes/interfaces inherited from class net.bytebuddy.agent.builder.AgentBuilder.Default

AgentBuilder.Default.BootstrapInjectionStrategy, AgentBuilder.Default.Delegator<T extends AgentBuilder.Matchable<T>>, AgentBuilder.Default.ExecutingTransformer, AgentBuilder.Default.Ignoring, AgentBuilder.Default.NativeMethodStrategy, AgentBuilder.Default.Redefining, AgentBuilder.Default.Transformation, AgentBuilder.Default.Transforming

Nested classes/interfaces inherited from interface net.bytebuddy.agent.builder.AgentBuilder.RedefinitionListenable

AgentBuilder.RedefinitionListenable.WithoutBatchStrategy

Nested classes/interfaces inherited from interface net.bytebuddy.agent.builder.AgentBuilder

AgentBuilder.CircularityLock, AgentBuilder.Default, AgentBuilder.DescriptionStrategy, AgentBuilder.FallbackStrategy, AgentBuilder.Identified, AgentBuilder.Ignored, AgentBuilder.InitializationStrategy, AgentBuilder.InstallationStrategy, AgentBuilder.LambdaInstrumentationStrategy, AgentBuilder.Listener, AgentBuilder.LocationStrategy, AgentBuilder.Matchable<T extends AgentBuilder.Matchable<T>>, AgentBuilder.PoolStrategy, AgentBuilder.RawMatcher, AgentBuilder.RedefinitionListenable, AgentBuilder.RedefinitionStrategy, AgentBuilder.Transformer, AgentBuilder.TypeStrategy

Field Summary

Fields inherited from class net.bytebuddy.agent.builder.AgentBuilder.Default

bootstrapInjectionStrategy, byteBuddy, circularityLock, descriptionStrategy, fallbackStrategy, ignoredTypeMatcher, initializationStrategy, installationStrategy, lambdaInstrumentationStrategy, listener, locationStrategy, nativeMethodStrategy, poolStrategy, redefinitionBatchAllocator, redefinitionListener, redefinitionStrategy, transformation, typeStrategy

Constructor Summary

Constructors

Modifier

Constructor and Description

protected

Redefining(ByteBuddy byteBuddy, AgentBuilder.Listener listener, AgentBuilder.CircularityLock circularityLock, AgentBuilder.PoolStrategy poolStrategy, AgentBuilder.TypeStrategy typeStrategy, AgentBuilder.LocationStrategy locationStrategy, AgentBuilder.Default.NativeMethodStrategy nativeMethodStrategy, AgentBuilder.InitializationStrategy initializationStrategy, AgentBuilder.RedefinitionStrategy redefinitionStrategy, AgentBuilder.RedefinitionStrategy.BatchAllocator redefinitionBatchAllocator, AgentBuilder.RedefinitionStrategy.Listener redefinitionListener, AgentBuilder.Default.BootstrapInjectionStrategy bootstrapInjectionStrategy, AgentBuilder.LambdaInstrumentationStrategy lambdaInstrumentationStrategy, AgentBuilder.DescriptionStrategy descriptionStrategy, AgentBuilder.InstallationStrategy installationStrategy, AgentBuilder.FallbackStrategy fallbackStrategy, AgentBuilder.RawMatcher ignoredTypeMatcher, AgentBuilder.Default.Transformation transformation) Creates a new default agent builder that allows for refinement of the redefinition strategy.

Method Summary

Modifier and Type	Method and Description
AgentBuilder.RedefinitionListenable	with(AgentBuilder.RedefinitionStrategy.BatchAllocator redefinitionBatchAllocator) A batch allocator is responsible for diving a redefining of existing types into several chunks.
AgentBuilder.RedefinitionListenable	with(AgentBuilder.RedefinitionStrategy.Listener redefinitionListener) A redefinition listener is invoked before each batch of type redefinitions and on every error as well as after the redefinition was completed.

Methods inherited from class net.bytebuddy.agent.builder.AgentBuilder.Default

assureReadEdgeFromAndTo, assureReadEdgeFromAndTo, assureReadEdgeFromAndTo, assureReadEdgeTo, assureReadEdgeTo, assureReadEdgeTo, disableBootstrapInjection, disableClassFormatChanges, disableNativeMethodPrefix, enableBootstrapInjection, enableNativeMethodPrefix, enableUnsafeBootstrapInjection, ignore, ignore, ignore, ignore, installOn, installOnByteBuddyAgent, makeRaw, of, of, of, of, type, type, type, type, with, with, with, with, with, with, with, with, with, with, with, with

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.bytebuddy.agent.builder.AgentBuilder

assureReadEdgeFromAndTo, assureReadEdgeFromAndTo, assureReadEdgeFromAndTo, assureReadEdgeTo, assureReadEdgeTo, assureReadEdgeTo, disableBootstrapInjection, disableClassFormatChanges, disableNativeMethodPrefix, enableBootstrapInjection, enableNativeMethodPrefix, enableUnsafeBootstrapInjection, ignore, ignore, ignore, ignore, installOn, installOnByteBuddyAgent, makeRaw, type, type, type, type, with, with, with, with, with, with, with, with, with, with, with, with

Constructor Detail

Redefining

protected Redefining(ByteBuddy byteBuddy,
                     AgentBuilder.Listener listener,
                     AgentBuilder.CircularityLock circularityLock,
                     AgentBuilder.PoolStrategy poolStrategy,
                     AgentBuilder.TypeStrategy typeStrategy,
                     AgentBuilder.LocationStrategy locationStrategy,
                     AgentBuilder.Default.NativeMethodStrategy nativeMethodStrategy,
                     AgentBuilder.InitializationStrategy initializationStrategy,
                     AgentBuilder.RedefinitionStrategy redefinitionStrategy,
                     AgentBuilder.RedefinitionStrategy.BatchAllocator redefinitionBatchAllocator,
                     AgentBuilder.RedefinitionStrategy.Listener redefinitionListener,
                     AgentBuilder.Default.BootstrapInjectionStrategy bootstrapInjectionStrategy,
                     AgentBuilder.LambdaInstrumentationStrategy lambdaInstrumentationStrategy,
                     AgentBuilder.DescriptionStrategy descriptionStrategy,
                     AgentBuilder.InstallationStrategy installationStrategy,
                     AgentBuilder.FallbackStrategy fallbackStrategy,
                     AgentBuilder.RawMatcher ignoredTypeMatcher,
                     AgentBuilder.Default.Transformation transformation)

Creates a new default agent builder that allows for refinement of the redefinition strategy.

Parameters:

byteBuddy - The Byte Buddy instance to be used.

listener - The listener to notify on transformations.

circularityLock - The circularity lock to use.

poolStrategy - The type locator to use.

typeStrategy - The definition handler to use.

locationStrategy - The location strategy to use.

nativeMethodStrategy - The native method strategy to apply.

initializationStrategy - The initialization strategy to use for transformed types.

redefinitionStrategy - The redefinition strategy to apply.

redefinitionBatchAllocator - The batch allocator for the redefinition strategy to apply.

redefinitionListener - The redefinition listener for the redefinition strategy to apply.

bootstrapInjectionStrategy - The injection strategy for injecting classes into the bootstrap class loader.

lambdaInstrumentationStrategy - A strategy to determine of the LambdaMetafactory should be instrumented to allow for the instrumentation of classes that represent lambda expressions.

descriptionStrategy - The description strategy for resolving type descriptions for types.

installationStrategy - The installation strategy to use.

fallbackStrategy - The fallback strategy to apply.

ignoredTypeMatcher - Identifies types that should not be instrumented.

transformation - The transformation object for handling type transformations.

Method Detail

with

public AgentBuilder.RedefinitionListenable with(AgentBuilder.RedefinitionStrategy.BatchAllocator redefinitionBatchAllocator)

Description copied from interface: AgentBuilder.RedefinitionListenable.WithoutBatchStrategy

A batch allocator is responsible for diving a redefining of existing types into several chunks. This allows to narrow down errors for the redefining of specific types or to apply a AgentBuilder.RedefinitionStrategy.Listener action between chunks.

Specified by:

with in interface AgentBuilder.RedefinitionListenable.WithoutBatchStrategy

Parameters:

redefinitionBatchAllocator - The batch allocator to use.

Returns:

A new instance of this agent builder which makes use of the specified batch allocator.

with

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

Description copied from interface: AgentBuilder.RedefinitionListenable

A redefinition listener is invoked before each batch of type redefinitions and on every error as well as after the redefinition was completed. A redefinition listener can be used for debugging or logging purposes and to apply actions between each batch, e.g. to pause or wait in order to avoid rendering the current VM non-responsive if a lot of classes are redefined.

Adding several listeners does not replace previous listeners but applies them in the registration order.

Specified by:

with in interface AgentBuilder.RedefinitionListenable

Parameters:

redefinitionListener - The listener to register.

Returns:

A new instance of this agent builder which notifies the specified listener upon type redefinitions.