net.bytebuddy.agent.builder

Class AgentBuilder.Default.ExecutingTransformer

java.lang.Object

net.bytebuddy.agent.builder.AgentBuilder.Default.ExecutingTransformer

All Implemented Interfaces:

ClassFileTransformer

Enclosing class:

AgentBuilder.Default

protected static class AgentBuilder.Default.ExecutingTransformer
extends Object
implements ClassFileTransformer

A ClassFileTransformer that implements the enclosing agent builder's configuration.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static interface	AgentBuilder.Default.ExecutingTransformer.Factory A factory for creating a ClassFileTransformer for the current VM.

Field Summary

Fields

Modifier and Type	Field and Description
protected static AgentBuilder.Default.ExecutingTransformer.Factory	FACTORY A factory for creating a ClassFileTransformer that supports the features of the current VM.

Constructor Summary

Constructors

Constructor and Description

ExecutingTransformer(ByteBuddy byteBuddy, AgentBuilder.TypeLocator typeLocator, AgentBuilder.TypeStrategy typeStrategy, AgentBuilder.Listener listener, AgentBuilder.Default.NativeMethodStrategy nativeMethodStrategy, AccessControlContext accessControlContext, AgentBuilder.InitializationStrategy initializationStrategy, AgentBuilder.Default.BootstrapInjectionStrategy bootstrapInjectionStrategy, AgentBuilder.RawMatcher ignoredTypeMatcher, AgentBuilder.Default.Transformation transformation) Creates a new class file transformer.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object other)
int	hashCode()
String	toString()
byte[]	transform(ClassLoader classLoader, String internalTypeName, Class<?> classBeingRedefined, ProtectionDomain protectionDomain, byte[] binaryRepresentation)
protected byte[]	transform(Object rawModule, String internalTypeName, Class<?> classBeingRedefined, ProtectionDomain protectionDomain, byte[] binaryRepresentation) Applies a transformation for a class that was captured by this ClassFileTransformer.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

FACTORY

protected static final AgentBuilder.Default.ExecutingTransformer.Factory FACTORY

A factory for creating a ClassFileTransformer that supports the features of the current VM.

Constructor Detail

ExecutingTransformer

public ExecutingTransformer(ByteBuddy byteBuddy,
                            AgentBuilder.TypeLocator typeLocator,
                            AgentBuilder.TypeStrategy typeStrategy,
                            AgentBuilder.Listener listener,
                            AgentBuilder.Default.NativeMethodStrategy nativeMethodStrategy,
                            AccessControlContext accessControlContext,
                            AgentBuilder.InitializationStrategy initializationStrategy,
                            AgentBuilder.Default.BootstrapInjectionStrategy bootstrapInjectionStrategy,
                            AgentBuilder.RawMatcher ignoredTypeMatcher,
                            AgentBuilder.Default.Transformation transformation)

Creates a new class file transformer.

Parameters:

byteBuddy - The Byte Buddy instance to be used.

typeLocator - The type locator to use.

typeStrategy - The definition handler to use.

listener - The listener to notify on transformations.

nativeMethodStrategy - The native method strategy to apply.

accessControlContext - The access control context to use for loading classes.

initializationStrategy - The initialization strategy to use for transformed types.

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

ignoredTypeMatcher - Identifies types that should not be instrumented.

transformation - The transformation object for handling type transformations.

Method Detail

transform

public byte[] transform(ClassLoader classLoader,
                        String internalTypeName,
                        Class<?> classBeingRedefined,
                        ProtectionDomain protectionDomain,
                        byte[] binaryRepresentation)

Specified by:

transform in interface ClassFileTransformer

transform

protected byte[] transform(Object rawModule,
                           String internalTypeName,
                           Class<?> classBeingRedefined,
                           ProtectionDomain protectionDomain,
                           byte[] binaryRepresentation)

Applies a transformation for a class that was captured by this ClassFileTransformer.

Parameters:

rawModule - The instrumented class's Java java.lang.reflect.Module.

internalTypeName - The internal name of the instrumented class.

classBeingRedefined - The loaded Class being redefined or null if no such class exists.

protectionDomain - The instrumented type's protection domain.

binaryRepresentation - The class file of the instrumented class in its current state.

Returns:

The transformed class file or an empty byte array if this transformer does not apply an instrumentation.

equals

public boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object