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 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 enum	Advice.OffsetMapping.ForThisReference.Factory	A factory for creating a Advice.OffsetMapping.ForThisReference offset mapping.

Nested classes/interfaces inherited from interface Advice.OffsetMapping

Advice.OffsetMapping.ForAllArguments, Advice.OffsetMapping.ForArgument, Advice.OffsetMapping.ForDynamicConstant, Advice.OffsetMapping.ForEnterValue, Advice.OffsetMapping.ForExitValue, Advice.OffsetMapping.ForField, Advice.OffsetMapping.ForFieldHandle, Advice.OffsetMapping.ForHandle, Advice.OffsetMapping.ForInstrumentedMethod, Advice.OffsetMapping.ForInstrumentedType, Advice.OffsetMapping.ForLocalValue, Advice.OffsetMapping.ForOrigin, Advice.OffsetMapping.ForReturnValue, Advice.OffsetMapping.ForSelfCallHandle, 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 final boolean	optional	true if the parameter should be bound to null if the instrumented method is static.
private final boolean	readOnly	Determines if the parameter is to be treated as read-only.
private final TypeDescription.Generic	target	The type that the advice method expects for the this reference.
private final 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, AnnotationDescription.Loadable<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 Object

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

Field Details

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 Details

ForThisReference

protected ForThisReference(TypeDescription.Generic target,
 AnnotationDescription.Loadable<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 Details

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.