Package net.bytebuddy.asm

Class Advice.OffsetMapping.ForThisReference

java.lang.Object

net.bytebuddy.asm.Advice.OffsetMapping.ForThisReference

All Implemented Interfaces:

Advice.OffsetMapping

Enclosing interface:

Advice.OffsetMapping

@Enhance
public static class Advice.OffsetMapping.ForThisReference
extends java.lang.Object
implements Advice.OffsetMapping

An offset mapping that provides access to the this reference of the instrumented method.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	Advice.OffsetMapping.ForThisReference.Factory	A factory for creating a Advice.OffsetMapping.ForThisReference offset mapping.

Nested classes/interfaces inherited from interface net.bytebuddy.asm.Advice.OffsetMapping

Advice.OffsetMapping.ForAllArguments, Advice.OffsetMapping.ForArgument, Advice.OffsetMapping.ForEnterValue, Advice.OffsetMapping.ForExitValue, Advice.OffsetMapping.ForField, Advice.OffsetMapping.ForInstrumentedMethod, Advice.OffsetMapping.ForInstrumentedType, Advice.OffsetMapping.ForLocalValue, Advice.OffsetMapping.ForOrigin, Advice.OffsetMapping.ForReturnValue, Advice.OffsetMapping.ForSerializedValue, Advice.OffsetMapping.ForStackManipulation, Advice.OffsetMapping.ForStubValue, Advice.OffsetMapping.ForThisReference, Advice.OffsetMapping.ForThrowable, Advice.OffsetMapping.ForUnusedValue, Advice.OffsetMapping.Sort, Advice.OffsetMapping.Target

Field Summary

Fields

Modifier and Type	Field	Description
private boolean	optional	true if the parameter should be bound to null if the instrumented method is static.
private boolean	readOnly	Determines if the parameter is to be treated as read-only.
private TypeDescription.Generic	target	The type that the advice method expects for the this reference.
private Assigner.Typing	typing	The typing to apply.

Constructor Summary

Constructors

Modifier	Constructor	Description
	ForThisReference(TypeDescription.Generic target, boolean readOnly, Assigner.Typing typing, boolean optional)	Creates a new offset mapping for a this reference.
protected	ForThisReference(TypeDescription.Generic target, Advice.This annotation)	Creates a new offset mapping for a this reference.

Method Summary

Modifier and Type	Method	Description
Advice.OffsetMapping.Target	resolve(TypeDescription instrumentedType, MethodDescription instrumentedMethod, Assigner assigner, Advice.ArgumentHandler argumentHandler, Advice.OffsetMapping.Sort sort)	Resolves an offset mapping to a given target offset.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

target

private final TypeDescription.Generic target

The type that the advice method expects for the this reference.

readOnly

private final boolean readOnly

Determines if the parameter is to be treated as read-only.

typing

private final Assigner.Typing typing

The typing to apply.

optional

private final boolean optional

true if the parameter should be bound to null if the instrumented method is static.

Constructor Detail

ForThisReference

protected ForThisReference(TypeDescription.Generic target,
                           Advice.This annotation)

Creates a new offset mapping for a this reference.

Parameters:

target - The type that the advice method expects for the this reference.

annotation - The mapped annotation.

ForThisReference

public ForThisReference(TypeDescription.Generic target,
                        boolean readOnly,
                        Assigner.Typing typing,
                        boolean optional)

Creates a new offset mapping for a this reference.

Parameters:

target - The type that the advice method expects for the this reference.

readOnly - Determines if the parameter is to be treated as read-only.

typing - The typing to apply.

optional - true if the parameter should be bound to null if the instrumented method is static.

Method Detail

resolve

public Advice.OffsetMapping.Target resolve(TypeDescription instrumentedType,
                                           MethodDescription instrumentedMethod,
                                           Assigner assigner,
                                           Advice.ArgumentHandler argumentHandler,
                                           Advice.OffsetMapping.Sort sort)

Resolves an offset mapping to a given target offset.

Specified by:

resolve in interface Advice.OffsetMapping

Parameters:

instrumentedType - The instrumented type.

instrumentedMethod - The instrumented method for which the mapping is to be resolved.

assigner - The assigner to use.

argumentHandler - The argument handler to use for resolving offsets of the local variable array of the instrumented method.

sort - The sort of the advice method being resolved.

Returns:

A suitable target mapping.