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

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.NoOp

Field Summary

Fields

Modifier and Type	Field and Description
protected MethodDescription.InDefinedShape	adviceMethod The method description for which frames are translated.
protected TypeList	requiredTypes A list of intermediate types to be considered as part of the instrumented method's steady signature.
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, TypeList requiredTypes, TypeList yieldedTypes, Advice.StackMapFrameHandler.Default.TranslationMode translationMode) Creates a new meta data handler for an advice method.

Method Summary

Modifier and Type	Method and Description
void	injectCompletionFrame(MethodVisitor methodVisitor, boolean secondary) Injects a frame indicating the completion of the currently handled method, i.e. all yielded types were added.
void	injectExceptionFrame(MethodVisitor methodVisitor) Injects a frame indicating the beginning of an exception handler for the currently handled method.
void	injectReturnFrame(MethodVisitor methodVisitor) Injects a frame indicating the beginning of a return value handler for the currently handled method.
String	toString()
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, wait, wait, wait

Field Detail

adviceMethod

protected final MethodDescription.InDefinedShape adviceMethod

The method description for which frames are translated.

requiredTypes

protected final TypeList requiredTypes

A list of intermediate types to be considered as part of the instrumented method's steady signature.

translationMode

protected final Advice.StackMapFrameHandler.Default.TranslationMode translationMode

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

Constructor Detail

ForAdvice

protected ForAdvice(MethodDescription.InDefinedShape adviceMethod,
                    TypeList requiredTypes,
                    TypeList yieldedTypes,
                    Advice.StackMapFrameHandler.Default.TranslationMode translationMode)

Creates a new meta data handler for an advice method.

Parameters:

adviceMethod - The method description for which frames are translated.

requiredTypes - A list of expected types to be considered as part of the instrumented method's steady signature.

yieldedTypes - The types that this method yields as a result.

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

Method Detail

translateFrame

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

Description copied from interface: Advice.StackMapFrameHandler

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)

Description copied from interface: Advice.StackMapFrameHandler

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)

Description copied from interface: Advice.StackMapFrameHandler

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,
                                  boolean secondary)

Description copied from interface: Advice.StackMapFrameHandler

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.

secondary - true if another completion frame for this method was written previously.

toString

public String toString()

Overrides:

toString in class Object