net.bytebuddy.asm

Class Advice.FrameTranslator

java.lang.Object

net.bytebuddy.asm.Advice.FrameTranslator

Enclosing class:

Advice

protected static class Advice.FrameTranslator
extends Object

A translator for frame found in parsed code.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	Advice.FrameTranslator.Bound A frame translator that is bound to an advice method.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	FrameTranslator(MethodDescription.InDefinedShape instrumentedMethod, TypeList intermediateTypes) Creates a new frame translator.

Method Summary

Modifier and Type	Method and Description
protected Advice.FrameTranslator.Bound	bindEntry(MethodDescription.InDefinedShape methodDescription) Binds this frame translator to an advice method.
protected Advice.FrameTranslator.Bound	bindExit(MethodDescription.InDefinedShape methodDescription, TypeDescription enterType) Binds this frame translator to an advice method.
protected int	compoundLocalVariableSize(int localVariableLength) Computes the compound local variable length of the instrumented method.
protected int	compoundStackSize(int stackSize) Computes the compound stack size of the instrumented method.
protected void	injectCompletionFrame(MethodVisitor methodVisitor) Injects a frame that describes the method after completion.
protected void	injectHandlerFrame(MethodVisitor methodVisitor) Injects a frame that describes the method when entering its surrounding exception handler.
String	toString()
protected void	translateFrame(MethodVisitor methodVisitor, int type, int localVariableLength, Object[] localVariable, int stackSize, Object[] stack) Translates an existing frame.

Methods inherited from class java.lang.Object

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

Constructor Detail

FrameTranslator

protected FrameTranslator(MethodDescription.InDefinedShape instrumentedMethod,
                          TypeList intermediateTypes)

Creates a new frame translator.

Parameters:

instrumentedMethod - The instrumented method.

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

Method Detail

bindEntry

protected Advice.FrameTranslator.Bound bindEntry(MethodDescription.InDefinedShape methodDescription)

Binds this frame translator to an advice method.

Parameters:

methodDescription - The advice method.

Returns:

A bound version of this frame translator.

bindExit

protected Advice.FrameTranslator.Bound bindExit(MethodDescription.InDefinedShape methodDescription,
                                                TypeDescription enterType)

Binds this frame translator to an advice method.

Parameters:

methodDescription - The advice method.

enterType - The type that is returned by the enter method, if any.

Returns:

A bound version of this frame translator.

compoundStackSize

protected int compoundStackSize(int stackSize)

Computes the compound stack size of the instrumented method.

Parameters:

stackSize - The stack size of the instrumented method without instrumentation.

Returns:

The stack size including the instrumented advice.

compoundLocalVariableSize

protected int compoundLocalVariableSize(int localVariableLength)

Computes the compound local variable length of the instrumented method.

Parameters:

localVariableLength - The local variable length of the instrumented method without instrumentation.

Returns:

The stack size including the instrumented advice.

injectHandlerFrame

protected void injectHandlerFrame(MethodVisitor methodVisitor)

Injects a frame that describes the method when entering its surrounding exception handler.

Parameters:

methodVisitor - The method visitor to write the frame to.

injectCompletionFrame

protected void injectCompletionFrame(MethodVisitor methodVisitor)

Injects a frame that describes the method after completion.

Parameters:

methodVisitor - The method visitor to write the frame to.

translateFrame

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

Translates an existing frame.

Parameters:

methodVisitor - The method visitor to append the frame to.

type - The type of method frame.

localVariableLength - The number of local variables of the original frame.

localVariable - An array containing the local variable types.

stackSize - The size of the current operand stack.

stack - An array containing the types on the operand stack.

toString

public String toString()

Overrides:

toString in class Object