net.bytebuddy.asm

Class Advice.StackMapFrameHandler.Default

java.lang.Object

net.bytebuddy.asm.Advice.StackMapFrameHandler.Default

All Implemented Interfaces:

Advice.StackMapFrameHandler, Advice.StackMapFrameHandler.ForInstrumentedMethod

Direct Known Subclasses:

Advice.StackMapFrameHandler.Default.Trivial, Advice.StackMapFrameHandler.Default.WithPreservedArguments

Enclosing interface:

Advice.StackMapFrameHandler

public abstract static class Advice.StackMapFrameHandler.Default
extends Object
implements Advice.StackMapFrameHandler.ForInstrumentedMethod

A default implementation of a stack map frame handler for an instrumented method.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	Advice.StackMapFrameHandler.Default.ForAdvice A stack map frame handler for an advice method.
protected static class	Advice.StackMapFrameHandler.Default.Initialization Represents the initialization state of a stack value that can either be initialized or uninitialized.
protected static class	Advice.StackMapFrameHandler.Default.TranslationMode A translation mode that determines how the fixed frames of the instrumented method are written.
protected static class	Advice.StackMapFrameHandler.Default.Trivial A trivial stack map frame handler that applies a trivial translation for the instrumented method's stack map frames.
protected static class	Advice.StackMapFrameHandler.Default.WithPreservedArguments A stack map frame handler that requires the original arguments of the instrumented method to be preserved in their original form.

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

Advice.StackMapFrameHandler.Default, Advice.StackMapFrameHandler.ForInstrumentedMethod, Advice.StackMapFrameHandler.NoOp

Field Summary

Fields

Modifier and Type	Field and Description
protected int	currentFrameDivergence The current frame's size divergence from the original local variable array.
protected static Object[]	EMPTY An empty array indicating an empty frame.
protected boolean	expandFrames true if the meta data handler is expected to expand its frames.
protected List<? extends TypeDescription>	initialTypes A list of virtual method arguments that are explicitly added before any code execution.
protected MethodDescription	instrumentedMethod The instrumented method.
protected TypeDescription	instrumentedType The instrumented type.
protected List<? extends TypeDescription>	postMethodTypes A list of virtual method arguments that are available after the instrumented method has completed.
protected List<? extends TypeDescription>	preMethodTypes A list of virtual method arguments that are available before the instrumented method is executed.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Default(TypeDescription instrumentedType, MethodDescription instrumentedMethod, List<? extends TypeDescription> initialTypes, List<? extends TypeDescription> preMethodTypes, List<? extends TypeDescription> postMethodTypes, boolean expandFrames) Creates a new default stack map frame handler.

Method Summary

Modifier and Type	Method and Description
Advice.StackMapFrameHandler.ForAdvice	bindEnter(MethodDescription.InDefinedShape adviceMethod) Binds this meta data handler for the enter advice.
int	getReaderHint() Returns a hint to supply to a ClassReader when parsing an advice method.
protected void	injectFullFrame(MethodVisitor methodVisitor, Advice.StackMapFrameHandler.Default.Initialization initialization, List<? extends TypeDescription> typesInArray, List<? extends TypeDescription> typesOnStack) Injects a full stack map frame after the instrumented method has completed.
protected static Advice.StackMapFrameHandler.ForInstrumentedMethod	of(TypeDescription instrumentedType, MethodDescription instrumentedMethod, List<? extends TypeDescription> initialTypes, List<? extends TypeDescription> preMethodTypes, List<? extends TypeDescription> postMethodTypes, boolean exitAdvice, boolean copyArguments, ClassFileVersion classFileVersion, int writerFlags, int readerFlags) Creates an appropriate stack map frame handler for an instrumented method.
protected void	translateFrame(MethodVisitor methodVisitor, Advice.StackMapFrameHandler.Default.TranslationMode translationMode, MethodDescription methodDescription, List<? extends TypeDescription> additionalTypes, 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.StackMapFrameHandler.ForInstrumentedMethod

bindExit, injectInitializationFrame, injectPostCompletionFrame, injectStartFrame

Methods inherited from interface net.bytebuddy.asm.Advice.StackMapFrameHandler

injectCompletionFrame, injectExceptionFrame, injectReturnFrame, translateFrame

Field Detail

EMPTY

protected static final Object[] EMPTY

An empty array indicating an empty frame.

instrumentedType

protected final TypeDescription instrumentedType

The instrumented type.

instrumentedMethod

protected final MethodDescription instrumentedMethod

The instrumented method.

initialTypes

protected final List<? extends TypeDescription> initialTypes

A list of virtual method arguments that are explicitly added before any code execution.

preMethodTypes

protected final List<? extends TypeDescription> preMethodTypes

A list of virtual method arguments that are available before the instrumented method is executed.

postMethodTypes

protected final List<? extends TypeDescription> postMethodTypes

A list of virtual method arguments that are available after the instrumented method has completed.

expandFrames

protected final boolean expandFrames

true if the meta data handler is expected to expand its frames.

currentFrameDivergence

protected int currentFrameDivergence

The current frame's size divergence from the original local variable array.

Constructor Detail

Default

protected Default(TypeDescription instrumentedType,
                  MethodDescription instrumentedMethod,
                  List<? extends TypeDescription> initialTypes,
                  List<? extends TypeDescription> preMethodTypes,
                  List<? extends TypeDescription> postMethodTypes,
                  boolean expandFrames)

Creates a new default stack map frame handler.

Parameters:

instrumentedType - The instrumented type.

instrumentedMethod - The instrumented method.

initialTypes - A list of virtual method arguments that are explicitly added before any code execution.

preMethodTypes - A list of virtual method arguments that are available before the instrumented method is executed.

postMethodTypes - A list of virtual method arguments that are available after the instrumented method has completed.

expandFrames - true if the meta data handler is expected to expand its frames.

Method Detail

of

protected static Advice.StackMapFrameHandler.ForInstrumentedMethod of(TypeDescription instrumentedType,
                                                                      MethodDescription instrumentedMethod,
                                                                      List<? extends TypeDescription> initialTypes,
                                                                      List<? extends TypeDescription> preMethodTypes,
                                                                      List<? extends TypeDescription> postMethodTypes,
                                                                      boolean exitAdvice,
                                                                      boolean copyArguments,
                                                                      ClassFileVersion classFileVersion,
                                                                      int writerFlags,
                                                                      int readerFlags)

Creates an appropriate stack map frame handler for an instrumented method.

Parameters:

instrumentedType - The instrumented type.

instrumentedMethod - The instrumented method.

initialTypes - A list of virtual method arguments that are explicitly added before any code execution.

preMethodTypes - A list of virtual method arguments that are available before the instrumented method is executed.

postMethodTypes - A list of virtual method arguments that are available after the instrumented method has completed.

exitAdvice - true if the current advice implies exit advice.

copyArguments - true if the original arguments are copied before invoking the instrumented method.

classFileVersion - The instrumented type's class file version.

writerFlags - The flags supplied to the ASM writer.

readerFlags - The reader flags supplied to the ASM reader.

Returns:

An appropriate stack map frame handler for an instrumented method.

bindEnter

public Advice.StackMapFrameHandler.ForAdvice bindEnter(MethodDescription.InDefinedShape adviceMethod)

Binds this meta data handler for the enter advice.

Specified by:

bindEnter in interface Advice.StackMapFrameHandler.ForInstrumentedMethod

Parameters:

adviceMethod - The enter advice method.

Returns:

An appropriate meta data handler for the enter method.

getReaderHint

public int getReaderHint()

Returns a hint to supply to a ClassReader when parsing an advice method.

Specified by:

getReaderHint in interface Advice.StackMapFrameHandler.ForInstrumentedMethod

Returns:

The reader hint to supply to an ASM class reader.

translateFrame

protected void translateFrame(MethodVisitor methodVisitor,
                              Advice.StackMapFrameHandler.Default.TranslationMode translationMode,
                              MethodDescription methodDescription,
                              List<? extends TypeDescription> additionalTypes,
                              int type,
                              int localVariableLength,
                              Object[] localVariable,
                              int stackSize,
                              Object[] stack)

Translates a frame.

Parameters:

methodVisitor - The method visitor to write the frame to.

translationMode - The translation mode to apply.

methodDescription - The method description for which the frame is written.

additionalTypes - The additional types to consider part of the instrumented method's parameters.

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.

injectFullFrame

protected void injectFullFrame(MethodVisitor methodVisitor,
                               Advice.StackMapFrameHandler.Default.Initialization initialization,
                               List<? extends TypeDescription> typesInArray,
                               List<? extends TypeDescription> typesOnStack)

Injects a full stack map frame after the instrumented method has completed.

Parameters:

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

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

typesInArray - The types that were added to the local variable array additionally to the values of the instrumented method.

typesOnStack - The types currently on the operand stack.