net.bytebuddy.asm

Annotation Type Advice.This

@Documented
 @Retention(value=RUNTIME)
 @Target(value=PARAMETER)
public static @interface Advice.This

Indicates that the annotated parameter should be mapped to the this reference of the instrumented method.

Important: Parameters with this option must not be used when from a constructor in combination with Advice.OnMethodEnter where the this reference is not available.

Important: Don't confuse this annotation with This or MemberSubstitution.This. This annotation should be used only in combination with Advice.

See Also:

Advice, Advice.OnMethodEnter, Advice.OnMethodExit

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
boolean	optional Determines if the parameter should be assigned null if the instrumented method is static or a constructor within an enter advice.
boolean	readOnly Indicates if it is possible to write to this parameter.
Assigner.Typing	typing The typing that should be applied when assigning the this value.

Element Detail

readOnly

public abstract boolean readOnly

Indicates if it is possible to write to this parameter. If this property is set to false, the annotated type must be equal to the type declaring the instrumented method if the typing is not also set to Assigner.Typing#DYNAMIC. If this property is set to true, the annotated parameter can be any super type of the instrumented method's declaring type.

Important: This property must be set to true if the advice method is not inlined.

Returns:

true if this parameter is read-only.

Default:

true

typing

public abstract Assigner.Typing typing

The typing that should be applied when assigning the this value.

Returns:

The typing to apply upon assignment.

Default:

net.bytebuddy.implementation.bytecode.assign.Assigner.Typing.STATIC

optional

public abstract boolean optional

Determines if the parameter should be assigned null if the instrumented method is static or a constructor within an enter advice.

Returns:

true if the value assignment is optional.

Default:

false