net.bytebuddy.instrumentation

Class FixedValue.ForPoolValue

java.lang.Object

net.bytebuddy.instrumentation.FixedValue

net.bytebuddy.instrumentation.FixedValue.ForPoolValue

All Implemented Interfaces:

FixedValue.AssignerConfigurable, Instrumentation, ByteCodeAppender

Enclosing class:

FixedValue

protected static class FixedValue.ForPoolValue
extends FixedValue
implements FixedValue.AssignerConfigurable, ByteCodeAppender

A fixed value instrumentation that represents its fixed value as a value that is written to the instrumented class's constant pool.

Nested Class Summary

Nested classes/interfaces inherited from class net.bytebuddy.instrumentation.FixedValue

FixedValue.AssignerConfigurable, FixedValue.ForPoolValue, FixedValue.ForStaticField

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

Instrumentation.Compound, Instrumentation.Context, Instrumentation.ForAbstractMethod

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

ByteCodeAppender.Compound, ByteCodeAppender.Size

Field Summary

Fields inherited from class net.bytebuddy.instrumentation.FixedValue

assigner, considerRuntimeType

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ForPoolValue(StackManipulation valueLoadInstruction, Class<?> loadedType, Assigner assigner, boolean considerRuntimeType) Creates a new constant pool fixed value instrumentation.

Method Summary

Modifier and Type	Method and Description
ByteCodeAppender	appender(TypeDescription instrumentedType) 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.
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()
InstrumentedType	prepare(InstrumentedType instrumentedType) During the preparation phase of an instrumentation, implementations are eligible to adding fields or methods to the currently instrumented type.
String	toString()
Instrumentation	withAssigner(Assigner assigner, boolean considerRuntimeType) Defines an explicit assigner to this fixed value instrumentation.

Methods inherited from class net.bytebuddy.instrumentation.FixedValue

apply, reference, reference, value

Methods inherited from class java.lang.Object

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

Constructor Detail

ForPoolValue

protected ForPoolValue(StackManipulation valueLoadInstruction,
                       Class<?> loadedType,
                       Assigner assigner,
                       boolean considerRuntimeType)

Creates a new constant pool fixed value instrumentation.

Parameters:

valueLoadInstruction - The instruction that is responsible for loading the constant pool value onto the operand stack.

loadedType - A type description representing the loaded type.

assigner - The assigner to use for assigning the fixed value to the return type of the instrumented value.

considerRuntimeType - If true, the runtime type of the given value will be considered for assigning the return type.

Method Detail

withAssigner

public Instrumentation withAssigner(Assigner assigner,
                                    boolean considerRuntimeType)

Description copied from interface: FixedValue.AssignerConfigurable

Defines an explicit assigner to this fixed value instrumentation.

Specified by:

withAssigner in interface FixedValue.AssignerConfigurable

Parameters:

assigner - The assigner to use for assigning the fixed value to the return type of the instrumented value.

considerRuntimeType - If true, the runtime type of the given value will be considered for assigning the return type.

Returns:

A fixed value instrumentation that makes use of the given assigner.

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.type.TypeDescription) call. On this method call, 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(TypeDescription instrumentedType)

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:

instrumentedType - The instrumented type that is to be created.

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.

equals

public boolean equals(Object other)

Overrides:

equals in class FixedValue

hashCode

public int hashCode()

Overrides:

hashCode in class FixedValue

toString

public String toString()

Overrides:

toString in class Object