Package net.bytebuddy.asm

Class Advice.Dispatcher.Delegating.Resolved.AdviceMethodWriter

java.lang.Object

net.bytebuddy.asm.Advice.Dispatcher.Delegating.Resolved.AdviceMethodWriter

All Implemented Interfaces:

Advice.Dispatcher.Bound

Direct Known Subclasses:

Advice.Dispatcher.Delegating.Resolved.AdviceMethodWriter.ForMethodEnter, Advice.Dispatcher.Delegating.Resolved.AdviceMethodWriter.ForMethodExit

Enclosing class:

Advice.Dispatcher.Delegating.Resolved

protected abstract static class Advice.Dispatcher.Delegating.Resolved.AdviceMethodWriter
extends java.lang.Object
implements Advice.Dispatcher.Bound

A bound advice method that copies the code by first extracting the exception table and later appending the code of the method without copying any meta data.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	Advice.Dispatcher.Delegating.Resolved.AdviceMethodWriter.ForMethodEnter	An advice method writer for a method enter.
protected static class	Advice.Dispatcher.Delegating.Resolved.AdviceMethodWriter.ForMethodExit	An advice method writer for a method exit.

Field Summary

Fields

Modifier and Type	Field	Description
protected MethodDescription.InDefinedShape	adviceMethod	The advice method.
protected Advice.ArgumentHandler.ForAdvice	argumentHandler	A handler for accessing values on the local variable array.
private static int	EMPTY	Indicates an empty local variable array which is not required for calling a method.
protected Implementation.Context	implementationContext	The implementation context to use.
protected Advice.MethodSizeHandler.ForAdvice	methodSizeHandler	A handler for computing the method size requirements.
protected org.objectweb.asm.MethodVisitor	methodVisitor	The method visitor for writing the instrumented method.
private java.util.List<Advice.OffsetMapping.Target>	offsetMappings	The offset mappings available to this advice.
private Advice.Dispatcher.RelocationHandler.Bound	relocationHandler	A bound relocation handler that is responsible for considering a non-standard control flow.
protected Advice.StackMapFrameHandler.ForAdvice	stackMapFrameHandler	A handler for translating and injecting stack map frames.
private Advice.Dispatcher.SuppressionHandler.Bound	suppressionHandler	A bound suppression handler that is used for suppressing exceptions of this advice method.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AdviceMethodWriter(MethodDescription.InDefinedShape adviceMethod, java.util.List<Advice.OffsetMapping.Target> offsetMappings, org.objectweb.asm.MethodVisitor methodVisitor, Implementation.Context implementationContext, Advice.ArgumentHandler.ForAdvice argumentHandler, Advice.MethodSizeHandler.ForAdvice methodSizeHandler, Advice.StackMapFrameHandler.ForAdvice stackMapFrameHandler, Advice.Dispatcher.SuppressionHandler.Bound suppressionHandler, Advice.Dispatcher.RelocationHandler.Bound relocationHandler)	Creates a new advice method writer.

Method Summary

Modifier and Type	Method	Description
void	apply()	Applies this dispatcher.
protected abstract int	getReturnValueOffset()	Resolves the offset of the advice method's local variable.
void	prepare()	Prepares the advice method's exception handlers.

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.bytebuddy.asm.Advice.Dispatcher.Bound

initialize

Field Detail

EMPTY

private static final int EMPTY

Indicates an empty local variable array which is not required for calling a method.

See Also:

Constant Field Values

adviceMethod

protected final MethodDescription.InDefinedShape adviceMethod

The advice method.

offsetMappings

private final java.util.List<Advice.OffsetMapping.Target> offsetMappings

The offset mappings available to this advice.

methodVisitor

protected final org.objectweb.asm.MethodVisitor methodVisitor

The method visitor for writing the instrumented method.

implementationContext

protected final Implementation.Context implementationContext

The implementation context to use.

argumentHandler

protected final Advice.ArgumentHandler.ForAdvice argumentHandler

A handler for accessing values on the local variable array.

methodSizeHandler

protected final Advice.MethodSizeHandler.ForAdvice methodSizeHandler

A handler for computing the method size requirements.

stackMapFrameHandler

protected final Advice.StackMapFrameHandler.ForAdvice stackMapFrameHandler

A handler for translating and injecting stack map frames.

suppressionHandler

private final Advice.Dispatcher.SuppressionHandler.Bound suppressionHandler

A bound suppression handler that is used for suppressing exceptions of this advice method.

relocationHandler

private final Advice.Dispatcher.RelocationHandler.Bound relocationHandler

A bound relocation handler that is responsible for considering a non-standard control flow.

Constructor Detail

AdviceMethodWriter

protected AdviceMethodWriter(MethodDescription.InDefinedShape adviceMethod,
                             java.util.List<Advice.OffsetMapping.Target> offsetMappings,
                             org.objectweb.asm.MethodVisitor methodVisitor,
                             Implementation.Context implementationContext,
                             Advice.ArgumentHandler.ForAdvice argumentHandler,
                             Advice.MethodSizeHandler.ForAdvice methodSizeHandler,
                             Advice.StackMapFrameHandler.ForAdvice stackMapFrameHandler,
                             Advice.Dispatcher.SuppressionHandler.Bound suppressionHandler,
                             Advice.Dispatcher.RelocationHandler.Bound relocationHandler)

Creates a new advice method writer.

Parameters:

adviceMethod - The advice method.

offsetMappings - The offset mappings available to this advice.

methodVisitor - The method visitor for writing the instrumented method.

implementationContext - The implementation context to use.

argumentHandler - A handler for accessing values on the local variable array.

methodSizeHandler - A handler for computing the method size requirements.

stackMapFrameHandler - A handler for translating and injecting stack map frames.

suppressionHandler - A bound suppression handler that is used for suppressing exceptions of this advice method.

relocationHandler - A bound relocation handler that is responsible for considering a non-standard control flow.

Method Detail

prepare

public void prepare()

Prepares the advice method's exception handlers.

Specified by:

prepare in interface Advice.Dispatcher.Bound

apply

public void apply()

Applies this dispatcher.

Specified by:

apply in interface Advice.Dispatcher.Bound

getReturnValueOffset

protected abstract int getReturnValueOffset()

Resolves the offset of the advice method's local variable. The returned value is only valid if this advice method does not return void.

Returns:

The offset of the represented advice method.