net.bytebuddy.asm

Class Advice.StackMapFrameHandler.Default.ForAdvice

java.lang.Object

net.bytebuddy.asm.Advice.StackMapFrameHandler.Default.ForAdvice

All Implemented Interfaces:

Advice.StackMapFrameHandler, Advice.StackMapFrameHandler.ForAdvice, Advice.StackMapFrameHandler.ForPostProcessor

Enclosing class:

Advice.StackMapFrameHandler.Default

protected class Advice.StackMapFrameHandler.Default.ForAdvice
extends Object
implements Advice.StackMapFrameHandler.ForAdvice

A stack map frame handler for an advice method.

Nested Class Summary

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

Advice.StackMapFrameHandler.Default, Advice.StackMapFrameHandler.ForAdvice, Advice.StackMapFrameHandler.ForInstrumentedMethod, Advice.StackMapFrameHandler.ForPostProcessor, Advice.StackMapFrameHandler.NoOp

Field Summary

Fields

Modifier and Type	Field and Description
protected MethodDescription.InDefinedShape	adviceMethod The method description for which frames are translated.
protected List<? extends TypeDescription>	endTypes The types provided after execution of the advice code.
protected List<? extends TypeDescription>	startTypes The types provided before execution of the advice code.
protected Advice.StackMapFrameHandler.Default.TranslationMode	translationMode The translation mode to apply for this advice method.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ForAdvice(MethodDescription.InDefinedShape adviceMethod, List<? extends TypeDescription> startTypes, List<? extends TypeDescription> intermediateTypes, List<? extends TypeDescription> endTypes, Advice.StackMapFrameHandler.Default.TranslationMode translationMode, Advice.StackMapFrameHandler.Default.Initialization initialization) Creates a new meta data handler for an advice method.

Method Summary

Modifier and Type	Method and Description
void	injectCompletionFrame(MethodVisitor methodVisitor) Injects a frame indicating the completion of the currently handled method, i.e.
void	injectExceptionFrame(MethodVisitor methodVisitor) Injects a frame indicating the beginning of an exception handler for the currently handled method.
void	injectIntermediateFrame(MethodVisitor methodVisitor, List<? extends TypeDescription> stack) Injects a frame that represents the current state.
void	injectReturnFrame(MethodVisitor methodVisitor) Injects a frame indicating the beginning of a return value handler for the currently handled method.
void	translateFrame(MethodVisitor methodVisitor, int type, int localVariableLength, Object[] localVariable, int stackSize, Object[] stack) Translates a frame.

Methods inherited from class java.lang.Object

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

Field Detail

adviceMethod

protected final MethodDescription.InDefinedShape adviceMethod

The method description for which frames are translated.

startTypes

protected final List<? extends TypeDescription> startTypes

The types provided before execution of the advice code.

endTypes

protected final List<? extends TypeDescription> endTypes

The types provided after execution of the advice code.

translationMode

protected final Advice.StackMapFrameHandler.Default.TranslationMode translationMode

The translation mode to apply for this advice method. Should be either Advice.StackMapFrameHandler.Default.TranslationMode.ENTER or Advice.StackMapFrameHandler.Default.TranslationMode.EXIT.

Constructor Detail

ForAdvice

protected ForAdvice(MethodDescription.InDefinedShape adviceMethod,
                    List<? extends TypeDescription> startTypes,
                    List<? extends TypeDescription> intermediateTypes,
                    List<? extends TypeDescription> endTypes,
                    Advice.StackMapFrameHandler.Default.TranslationMode translationMode,
                    Advice.StackMapFrameHandler.Default.Initialization initialization)

Creates a new meta data handler for an advice method.

Parameters:

adviceMethod - The method description for which frames are translated.

startTypes - The types provided before execution of the advice code.

intermediateTypes - The types that are given post execution of the advice.

endTypes - The types provided after execution of the advice code.

translationMode - The translation mode to apply for this advice method. Should be either Advice.StackMapFrameHandler.Default.TranslationMode.ENTER or Advice.StackMapFrameHandler.Default.TranslationMode.EXIT.

initialization - The initialization to apply when resolving a reference to the instance on which a non-static method is invoked.

Method Detail

translateFrame

public void translateFrame(MethodVisitor methodVisitor,
                           int type,
                           int localVariableLength,
                           @MaybeNull
                           Object[] localVariable,
                           int stackSize,
                           @MaybeNull
                           Object[] stack)

Translates a frame.

Specified by:

translateFrame in interface Advice.StackMapFrameHandler

Parameters:

methodVisitor - The method visitor to write the frame to.

type - The frame's type.

localVariableLength - The local variable length.

localVariable - An array containing the types of the current local variables.

stackSize - The size of the operand stack.

stack - An array containing the types of the current operand stack.

injectReturnFrame

public void injectReturnFrame(MethodVisitor methodVisitor)

Injects a frame indicating the beginning of a return value handler for the currently handled method.

Specified by:

injectReturnFrame in interface Advice.StackMapFrameHandler

Parameters:

methodVisitor - The method visitor onto which to apply the stack map frame.

injectExceptionFrame

public void injectExceptionFrame(MethodVisitor methodVisitor)

Injects a frame indicating the beginning of an exception handler for the currently handled method.

Specified by:

injectExceptionFrame in interface Advice.StackMapFrameHandler

Parameters:

methodVisitor - The method visitor onto which to apply the stack map frame.

injectCompletionFrame

public void injectCompletionFrame(MethodVisitor methodVisitor)

Injects a frame indicating the completion of the currently handled method, i.e. all yielded types were added.

Specified by:

injectCompletionFrame in interface Advice.StackMapFrameHandler

Parameters:

methodVisitor - The method visitor onto which to apply the stack map frame.

injectIntermediateFrame

public void injectIntermediateFrame(MethodVisitor methodVisitor,
                                    List<? extends TypeDescription> stack)

Injects a frame that represents the current state.

Specified by:

injectIntermediateFrame in interface Advice.StackMapFrameHandler.ForPostProcessor

Parameters:

methodVisitor - The method visitor onto which to apply the stack map frame.

stack - A list of types that are currently on the stack.