Package net.bytebuddy.agent.builder

Class ResettableClassFileTransformer.WithDelegation.Substitutable

java.lang.Object

net.bytebuddy.agent.builder.ResettableClassFileTransformer.AbstractBase

net.bytebuddy.agent.builder.ResettableClassFileTransformer.WithDelegation.Substitutable

All Implemented Interfaces:

java.lang.instrument.ClassFileTransformer, ResettableClassFileTransformer, ResettableClassFileTransformer.Substitutable

Enclosing class:

ResettableClassFileTransformer.WithDelegation

@Enhance
protected static class ResettableClassFileTransformer.WithDelegation.Substitutable
extends ResettableClassFileTransformer.AbstractBase
implements ResettableClassFileTransformer.Substitutable

A standard implementation of a substitutable ResettableClassFileTransformer.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static interface	ResettableClassFileTransformer.WithDelegation.Substitutable.Factory	A factory for creating a subclass of ResettableClassFileTransformer.WithDelegation.Substitutable that supports the module system, if available.

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

ResettableClassFileTransformer.AbstractBase, ResettableClassFileTransformer.Substitutable, ResettableClassFileTransformer.WithDelegation

Field Summary

Fields

Modifier and Type	Field	Description
protected ResettableClassFileTransformer	classFileTransformer	The class file transformer to delegate to.
private static ResettableClassFileTransformer.WithDelegation.Substitutable.Factory	DISPATCHER	A dispatcher for invoking the correct transformer method.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Substitutable(ResettableClassFileTransformer classFileTransformer)	Creates a new delegating resettable class file transformer.

Method Summary

Modifier and Type	Method	Description
java.util.Iterator<AgentBuilder.Transformer>	iterator(TypeDescription typeDescription, java.lang.ClassLoader classLoader, JavaModule module, java.lang.Class<?> classBeingRedefined, java.security.ProtectionDomain protectionDomain)	Creates an iterator over the transformers that are applied for a given type.
static ResettableClassFileTransformer.Substitutable	of(ResettableClassFileTransformer classFileTransformer)	Creates a new substitutable class file transformer of another class file transformer.
boolean	reset(java.lang.instrument.Instrumentation instrumentation, ResettableClassFileTransformer classFileTransformer, AgentBuilder.RedefinitionStrategy redefinitionStrategy, AgentBuilder.RedefinitionStrategy.DiscoveryStrategy redefinitionDiscoveryStrategy, AgentBuilder.RedefinitionStrategy.BatchAllocator redefinitionBatchAllocator, AgentBuilder.RedefinitionStrategy.Listener redefinitionListener)	Deregisters this class file transformer and redefines any transformed class to its state without this class file transformer applied, if the supplied redefinition strategy is enabled.
void	substitute(ResettableClassFileTransformer classFileTransformer)	Substitutes the current class file transformer.
byte[]	transform(java.lang.ClassLoader classLoader, java.lang.String internalName, java.lang.Class<?> classBeingRedefined, java.security.ProtectionDomain protectionDomain, byte[] binaryRepresentation)
ResettableClassFileTransformer	unwrap()	Returns the underlying non-substitutable class file transformer.

Methods inherited from class net.bytebuddy.agent.builder.ResettableClassFileTransformer.AbstractBase

reset, reset, reset, reset, reset, reset, reset

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.instrument.ClassFileTransformer

transform

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

reset, reset, reset, reset, reset, reset, reset

Field Detail

DISPATCHER

private static final ResettableClassFileTransformer.WithDelegation.Substitutable.Factory DISPATCHER

A dispatcher for invoking the correct transformer method.

classFileTransformer

protected volatile ResettableClassFileTransformer classFileTransformer

The class file transformer to delegate to.

Constructor Detail

Substitutable

protected Substitutable(ResettableClassFileTransformer classFileTransformer)

Creates a new delegating resettable class file transformer.

Parameters:

classFileTransformer - The class file transformer to delegate to.

Method Detail

of

public static ResettableClassFileTransformer.Substitutable of(ResettableClassFileTransformer classFileTransformer)

Creates a new substitutable class file transformer of another class file transformer.

Parameters:

classFileTransformer - The class file transformer to wrap.

Returns:

A substitutable version of the supplied class file transformer.

substitute

public void substitute(ResettableClassFileTransformer classFileTransformer)

Substitutes the current class file transformer.

Specified by:

substitute in interface ResettableClassFileTransformer.Substitutable

Parameters:

classFileTransformer - The class file transformer to use.

unwrap

public ResettableClassFileTransformer unwrap()

Returns the underlying non-substitutable class file transformer.

Specified by:

unwrap in interface ResettableClassFileTransformer.Substitutable

Returns:

The underlying non-substitutable class file transformer.

iterator

public java.util.Iterator<AgentBuilder.Transformer> iterator(TypeDescription typeDescription,
                                                             @MaybeNull
                                                             java.lang.ClassLoader classLoader,
                                                             @MaybeNull
                                                             JavaModule module,
                                                             @MaybeNull
                                                             java.lang.Class<?> classBeingRedefined,
                                                             @MaybeNull
                                                             java.security.ProtectionDomain protectionDomain)

Creates an iterator over the transformers that are applied for a given type.

Specified by:

iterator in interface ResettableClassFileTransformer

Parameters:

typeDescription - A description of a type.

classLoader - The type's class loader or null if the boot loader.

module - The type's module or null if the module system is not supported by the current VM.

classBeingRedefined - The class being redefined or null if the type is not yet loaded.

protectionDomain - The type's protection domain or null if not available.

Returns:

An iterator over the transformers that are applied by this class file transformer if the given type is discovered.

reset

public boolean reset(java.lang.instrument.Instrumentation instrumentation,
                     ResettableClassFileTransformer classFileTransformer,
                     AgentBuilder.RedefinitionStrategy redefinitionStrategy,
                     AgentBuilder.RedefinitionStrategy.DiscoveryStrategy redefinitionDiscoveryStrategy,
                     AgentBuilder.RedefinitionStrategy.BatchAllocator redefinitionBatchAllocator,
                     AgentBuilder.RedefinitionStrategy.Listener redefinitionListener)

Deregisters this class file transformer and redefines any transformed class to its state without this class file transformer applied, if the supplied redefinition strategy is enabled. If it is not enabled, only the AgentBuilder.InstallationListener is informed about the resetting without undoing any code changes.

Note: A reset class file transformer should not be reinstalled. Instead, the AgentBuilder which built the transformer should be asked to install a new transformer.

Important: Most JVMs do not support changes of a class's structure after a class was already loaded. Therefore, it is typically required that this class file transformer was built while enabling AgentBuilder.disableClassFormatChanges().

Specified by:

reset in interface ResettableClassFileTransformer

Parameters:

instrumentation - The instrumentation instance from which to deregister the transformer.

classFileTransformer - The actual class file transformer to deregister which might be this instance or any wrapper.

redefinitionStrategy - The redefinition to apply.

redefinitionDiscoveryStrategy - The discovery strategy for the types to reset.

redefinitionBatchAllocator - The batch allocator to use.

redefinitionListener - The redefinition listener to apply.

Returns:

true if a reset was applied and this transformer was not previously removed.

transform

public byte[] transform(@MaybeNull
                        java.lang.ClassLoader classLoader,
                        @MaybeNull
                        java.lang.String internalName,
                        @MaybeNull
                        java.lang.Class<?> classBeingRedefined,
                        @MaybeNull
                        java.security.ProtectionDomain protectionDomain,
                        byte[] binaryRepresentation)
                 throws java.lang.instrument.IllegalClassFormatException

Specified by:

transform in interface java.lang.instrument.ClassFileTransformer

Throws:

java.lang.instrument.IllegalClassFormatException