net.bytebuddy.asm

Interface Advice.DynamicValue<T extends Annotation>

Type Parameters:

T - The type of the annotation this dynamic value requires to provide a mapping.

All Known Implementing Classes:

Advice.DynamicValue.ForAnnotationProperty, Advice.DynamicValue.ForFixedValue

Enclosing class:

Advice

public static interface Advice.DynamicValue<T extends Annotation>

A dynamic value allows to bind parameters of an Advice method to a custom, constant value.

The mapped value must be a constant value that can be embedded into a Java class file. This holds for all primitive types, instances of String and for Class instances as well as their unloaded TypeDescription representations.

See Also:

Advice.WithCustomMapping

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	Advice.DynamicValue.ForAnnotationProperty<T extends Annotation> A dynamic value for an annotation type's property.
static class	Advice.DynamicValue.ForFixedValue A Advice.DynamicValue implementation that always binds a fixed value.

Method Summary

Modifier and Type	Method and Description
Object	resolve(TypeDescription instrumentedType, MethodDescription instrumentedMethod, ParameterDescription.InDefinedShape target, AnnotationDescription.Loadable<T> annotation, boolean initialized) Resolves a constant value that is mapped to a parameter that is annotated with a custom bound annotation: A primitive wrapper value allow binding of the primitive which is optionally boxed but never unboxed.

Method Detail

resolve

Object resolve(TypeDescription instrumentedType,
               MethodDescription instrumentedMethod,
               ParameterDescription.InDefinedShape target,
               AnnotationDescription.Loadable<T> annotation,
               boolean initialized)

Resolves a constant value that is mapped to a parameter that is annotated with a custom bound annotation:

• A primitive wrapper value allow binding of the primitive which is optionally boxed but never unboxed.
• A Class or TypeDescription indicate the binding of a type constant.
• A FieldDescription indicates binding the field value. The field must be visible and be declared by a super type or be static. A field value is optionally boxed but never unboxed,
• A ParameterDescription indicates binding the assigned argument value. The parameter must be declared by the instrumented method. The parameter value is optionally boxed but never unboxed,
• A Serializable value is serialized and stored Base64 encoded in the constant pool.

Parameters:

instrumentedType - The instrumented type.

instrumentedMethod - The instrumented method onto which this advice is applied.

target - The target parameter that is bound.

annotation - The annotation that triggered this binding.

initialized - true if the method is initialized when the value is bound, i.e. that the value is not supplied to a constructor before the super constructor was invoked.

Returns:

A constant value, a serializable value or a field or parameter description to bind to the supplied parameter or null to assign this value.