net.bytebuddy.agent.builder

Class AgentBuilder.Default.InitializationStrategy.SelfInjection

java.lang.Object

net.bytebuddy.agent.builder.AgentBuilder.Default.InitializationStrategy.SelfInjection

All Implemented Interfaces:

AgentBuilder.Default.InitializationStrategy, Instrumentation, ByteCodeAppender

Enclosing interface:

AgentBuilder.Default.InitializationStrategy

public static class AgentBuilder.Default.InitializationStrategy.SelfInjection
extends Object
implements AgentBuilder.Default.InitializationStrategy, Instrumentation, ByteCodeAppender

An initialization strategy that adds a code block to an instrumented type's type initializer which then calls a specific class that is responsible for the explicit initialization.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AgentBuilder.Default.InitializationStrategy.SelfInjection.Nexus This nexus is a global dispatcher for initializing classes with LoadedTypeInitializers.

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

AgentBuilder.Default.InitializationStrategy.NoOp, AgentBuilder.Default.InitializationStrategy.SelfInjection

Nested classes/interfaces inherited from interface net.bytebuddy.instrumentation.Instrumentation

Instrumentation.Compound, Instrumentation.Context, Instrumentation.ForAbstractMethod, Instrumentation.Simple, Instrumentation.SpecialMethodInvocation, Instrumentation.Target

Nested classes/interfaces inherited from interface net.bytebuddy.instrumentation.method.bytecode.ByteCodeAppender

ByteCodeAppender.Compound, ByteCodeAppender.Simple, ByteCodeAppender.Size

Constructor Summary

Constructors

Constructor and Description
SelfInjection() Creates a new self injection strategy.

Method Summary

Modifier and Type	Method and Description
ByteCodeAppender	appender(Instrumentation.Target instrumentationTarget) Creates a byte code appender that determines the implementation of the instrumented type's methods.
boolean	appendsCode() Determines if this byte code appender offers an (possibly empty) implementation of a method.
DynamicType.Builder<?>	apply(DynamicType.Builder<?> builder) Transforms the instrumented type to implement an appropriate initialization strategy.
ByteCodeAppender.Size	apply(org.objectweb.asm.MethodVisitor methodVisitor, Instrumentation.Context instrumentationContext, MethodDescription instrumentedMethod) Applies this byte code appender to a type creation process.
boolean	equals(Object other)
int	hashCode()
void	initialize(Class<?> type, LoadedTypeInitializer loadedTypeInitializer) Determines if and how a loaded type initializer is to be applied to a loaded type.
InstrumentedType	prepare(InstrumentedType instrumentedType) During the preparation phase of an instrumentation, implementations are eligible to adding fields or methods to the currently instrumented type.
void	register(String name, ClassLoader classLoader, LoadedTypeInitializer loadedTypeInitializer) Registers a loaded type initializer for a type name and class loader pair.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

SelfInjection

public SelfInjection()

Creates a new self injection strategy.

Method Detail

apply

public DynamicType.Builder<?> apply(DynamicType.Builder<?> builder)

Description copied from interface: AgentBuilder.Default.InitializationStrategy

Transforms the instrumented type to implement an appropriate initialization strategy.

Specified by:

apply in interface AgentBuilder.Default.InitializationStrategy

Parameters:

builder - The builder which should implement the initialization strategy.

Returns:

The given builder with the initialization strategy applied.

initialize

public void initialize(Class<?> type,
                       LoadedTypeInitializer loadedTypeInitializer)

Description copied from interface: AgentBuilder.Default.InitializationStrategy

Determines if and how a loaded type initializer is to be applied to a loaded type.

Specified by:

initialize in interface AgentBuilder.Default.InitializationStrategy

Parameters:

type - The loaded type.

loadedTypeInitializer - The type's loaded type initializer.

prepare

public InstrumentedType prepare(InstrumentedType instrumentedType)

Description copied from interface: Instrumentation

During the preparation phase of an instrumentation, implementations are eligible to adding fields or methods to the currently instrumented type. All methods that are added by this instrumentation are required to be implemented by the ByteCodeAppender that is emitted on the call to Instrumentation.appender(net.bytebuddy.instrumentation.Instrumentation.Target) call. On this method call, loaded type initializers can also be added to the instrumented type.

Specified by:

prepare in interface Instrumentation

Parameters:

instrumentedType - The instrumented type that is the basis of the ongoing instrumentation.

Returns:

The instrumented type with any applied changes, if any.

appender

public ByteCodeAppender appender(Instrumentation.Target instrumentationTarget)

Description copied from interface: Instrumentation

Creates a byte code appender that determines the implementation of the instrumented type's methods.

Specified by:

appender in interface Instrumentation

Parameters:

instrumentationTarget - The target of the current instrumentation.

Returns:

A byte code appender for implementing methods delegated to this instrumentation. This byte code appender is also responsible for handling methods that were added by this instrumentation on the call to Instrumentation.prepare(net.bytebuddy.instrumentation.type.InstrumentedType).

appendsCode

public boolean appendsCode()

Description copied from interface: ByteCodeAppender

Determines if this byte code appender offers an (possibly empty) implementation of a method.

Specified by:

appendsCode in interface ByteCodeAppender

Returns:

true if this byte code appender requires this method to be implemented or false if this appender describes an abstract method.

apply

public ByteCodeAppender.Size apply(org.objectweb.asm.MethodVisitor methodVisitor,
                                   Instrumentation.Context instrumentationContext,
                                   MethodDescription instrumentedMethod)

Description copied from interface: ByteCodeAppender

Applies this byte code appender to a type creation process.

Specified by:

apply in interface ByteCodeAppender

Parameters:

methodVisitor - The method visitor to which the byte code appender writes its code to.

instrumentationContext - The instrumentation context of the current type creation process.

instrumentedMethod - The method that is the target of the instrumentation.

Returns:

The required size for the applied byte code to run.

register

public void register(String name,
                     ClassLoader classLoader,
                     LoadedTypeInitializer loadedTypeInitializer)

Description copied from interface: AgentBuilder.Default.InitializationStrategy

Registers a loaded type initializer for a type name and class loader pair.

Specified by:

register in interface AgentBuilder.Default.InitializationStrategy

Parameters:

name - The name of the type for which the loaded type initializer is to be registered.

classLoader - The class loader of the instrumented type. Might be null if this class loader represents the bootstrap class loader.

loadedTypeInitializer - The loaded type initializer that is being registered.

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