net.bytebuddy.asm

Class Advice.MetaDataHandler.Default.ForAdvice

java.lang.Object

net.bytebuddy.asm.Advice.MetaDataHandler.Default.ForAdvice

All Implemented Interfaces:

Advice.MetaDataHandler, Advice.MetaDataHandler.ForAdvice

Direct Known Subclasses:

Advice.MetaDataHandler.Default.WithoutStackSizeComputation.ForAdvice, Advice.MetaDataHandler.Default.WithStackSizeComputation.ForAdvice

Enclosing class:

Advice.MetaDataHandler.Default

protected abstract class Advice.MetaDataHandler.Default.ForAdvice
extends Object
implements Advice.MetaDataHandler.ForAdvice

A meta data handler that is bound to an advice method.

Nested Class Summary

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

Advice.MetaDataHandler.Default, Advice.MetaDataHandler.ForAdvice, Advice.MetaDataHandler.ForInstrumentedMethod, Advice.MetaDataHandler.NoOp

Field Summary

Fields

Modifier and Type	Field and Description
protected MethodDescription.InDefinedShape	methodDescription 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.MetaDataHandler.Default.TranslationMode	translationMode The translation mode to apply for this advice method.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ForAdvice(MethodDescription.InDefinedShape methodDescription, TypeList requiredTypes, TypeList yieldedTypes, Advice.MetaDataHandler.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 after a method's completion.
void	injectHandlerFrame(MethodVisitor methodVisitor) Injects a frame for a method's exception handler.
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

Methods inherited from interface net.bytebuddy.asm.Advice.MetaDataHandler.ForAdvice

recordMaxima, recordPadding

Field Detail

methodDescription

protected final MethodDescription.InDefinedShape methodDescription

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.MetaDataHandler.Default.TranslationMode translationMode

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

Constructor Detail

ForAdvice

protected ForAdvice(MethodDescription.InDefinedShape methodDescription,
                    TypeList requiredTypes,
                    TypeList yieldedTypes,
                    Advice.MetaDataHandler.Default.TranslationMode translationMode)

Creates a new meta data handler for an advice method.

Parameters:

methodDescription - 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.MetaDataHandler.Default.TranslationMode.ENTRY or Advice.MetaDataHandler.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.MetaDataHandler

Translates a frame.

Specified by:

translateFrame in interface Advice.MetaDataHandler

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.

injectHandlerFrame

public void injectHandlerFrame(MethodVisitor methodVisitor)

Description copied from interface: Advice.MetaDataHandler

Injects a frame for a method's exception handler.

Specified by:

injectHandlerFrame in interface Advice.MetaDataHandler

Parameters:

methodVisitor - The method visitor to write the frame to.

injectCompletionFrame

public void injectCompletionFrame(MethodVisitor methodVisitor,
                                  boolean secondary)

Description copied from interface: Advice.MetaDataHandler

Injects a frame after a method's completion.

Specified by:

injectCompletionFrame in interface Advice.MetaDataHandler

Parameters:

methodVisitor - The method visitor to write the frame to.

secondary - true if the frame is written a second time.