net.bytebuddy.asm

Class Advice.Dispatcher.Inlining.CodeTranslationVisitor

java.lang.Object

org.objectweb.asm.MethodVisitor

net.bytebuddy.asm.Advice.Dispatcher.Inlining.CodeTranslationVisitor

All Implemented Interfaces:

Advice.Dispatcher.SuppressionHandler.ReturnValueProducer

Direct Known Subclasses:

Advice.Dispatcher.Inlining.CodeTranslationVisitor.ForMethodEnter, Advice.Dispatcher.Inlining.CodeTranslationVisitor.ForMethodExit

Enclosing class:

Advice.Dispatcher.Inlining

protected abstract static class Advice.Dispatcher.Inlining.CodeTranslationVisitor
extends MethodVisitor
implements Advice.Dispatcher.SuppressionHandler.ReturnValueProducer

A visitor for translating an advice method's byte code for inlining into the instrumented method.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	Advice.Dispatcher.Inlining.CodeTranslationVisitor.ForMethodEnter A code translation visitor that retains the return value of the represented advice method.
protected static class	Advice.Dispatcher.Inlining.CodeTranslationVisitor.ForMethodExit A code translation visitor that discards the return value of the represented advice method.

Field Summary

Fields

Modifier and Type	Field and Description
protected MethodDescription.InDefinedShape	adviceMethod The advice method.
protected Label	endOfMethod A label indicating the end of the advice byte code.
protected Implementation.Context	implementationContext The implementation context to use.
protected MethodDescription	instrumentedMethod The instrumented method.
protected Advice.MethodSizeHandler.ForAdvice	methodSizeHandler A handler for computing the method size requirements.
protected MethodVisitor	methodVisitor The original method visitor to which all instructions are eventually written to.
protected Advice.StackMapFrameHandler.ForAdvice	stackMapFrameHandler A handler for translating and injecting stack map frames.

Fields inherited from class org.objectweb.asm.MethodVisitor

api, mv

Constructor Summary

Constructors

Modifier

Constructor and Description

protected

CodeTranslationVisitor(MethodVisitor methodVisitor, Implementation.Context implementationContext, Advice.MethodSizeHandler.ForAdvice methodSizeHandler, Advice.StackMapFrameHandler.ForAdvice stackMapFrameHandler, MethodDescription instrumentedMethod, MethodDescription.InDefinedShape adviceMethod, Map<Integer,Advice.OffsetMapping.Target> offsetMappings, Advice.Dispatcher.SuppressionHandler.Bound suppressionHandler) Creates a new code translation visitor.

Method Summary

Modifier and Type	Method and Description
protected abstract int	adjust(int offset) Adjusts the offset of a variable instruction within the advice method such that no arguments to the instrumented method are overridden.
protected abstract void	onMethodReturn() Invoked after returning from the advice method.
protected void	propagateHandler(Label label) Propagates a label for an exception handler that is typically suppressed by the overlaying Advice.Dispatcher.Inlining.Resolved.AdviceMethodInliner.ExceptionTableSubstitutor.
AnnotationVisitor	visitAnnotation(String descriptor, boolean visible)
AnnotationVisitor	visitAnnotationDefault()
void	visitAttribute(Attribute attribute)
void	visitCode()
void	visitEnd()
void	visitFrame(int type, int localVariableLength, Object[] localVariable, int stackSize, Object[] stack)
void	visitIincInsn(int offset, int value)
abstract void	visitInsn(int opcode)
void	visitMaxs(int stackSize, int localVariableLength)
void	visitParameter(String name, int modifiers)
AnnotationVisitor	visitParameterAnnotation(int index, String descriptor, boolean visible)
AnnotationVisitor	visitTypeAnnotation(int typeReference, TypePath typePath, String descriptor, boolean visible)
void	visitVarInsn(int opcode, int offset)

Methods inherited from class org.objectweb.asm.MethodVisitor

visitFieldInsn, visitInsnAnnotation, visitIntInsn, visitInvokeDynamicInsn, visitJumpInsn, visitLabel, visitLdcInsn, visitLineNumber, visitLocalVariable, visitLocalVariableAnnotation, visitLookupSwitchInsn, visitMethodInsn, visitMethodInsn, visitMultiANewArrayInsn, visitTableSwitchInsn, visitTryCatchAnnotation, visitTryCatchBlock, visitTypeInsn

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.Dispatcher.SuppressionHandler.ReturnValueProducer

onDefaultValue

Field Detail

methodVisitor

protected final MethodVisitor methodVisitor

The original method visitor to which all instructions are eventually written to.

implementationContext

protected final Implementation.Context implementationContext

The implementation context to use.

methodSizeHandler

protected final Advice.MethodSizeHandler.ForAdvice methodSizeHandler

A handler for computing the method size requirements.

stackMapFrameHandler

protected final Advice.StackMapFrameHandler.ForAdvice stackMapFrameHandler

A handler for translating and injecting stack map frames.

instrumentedMethod

protected final MethodDescription instrumentedMethod

The instrumented method.

adviceMethod

protected final MethodDescription.InDefinedShape adviceMethod

The advice method.

endOfMethod

protected final Label endOfMethod

A label indicating the end of the advice byte code.

Constructor Detail

CodeTranslationVisitor

protected CodeTranslationVisitor(MethodVisitor methodVisitor,
                                 Implementation.Context implementationContext,
                                 Advice.MethodSizeHandler.ForAdvice methodSizeHandler,
                                 Advice.StackMapFrameHandler.ForAdvice stackMapFrameHandler,
                                 MethodDescription instrumentedMethod,
                                 MethodDescription.InDefinedShape adviceMethod,
                                 Map<Integer,Advice.OffsetMapping.Target> offsetMappings,
                                 Advice.Dispatcher.SuppressionHandler.Bound suppressionHandler)

Creates a new code translation visitor.

Parameters:

methodVisitor - A method visitor for writing the instrumented method's byte code.

implementationContext - The implementation context to use.

methodSizeHandler - A handler for computing the method size requirements.

stackMapFrameHandler - A handler for translating and injecting stack map frames.

instrumentedMethod - The instrumented method.

adviceMethod - The advice method.

offsetMappings - A mapping of offsets to resolved target offsets in the instrumented method.

suppressionHandler - The suppression handler to use.

Method Detail

propagateHandler

protected void propagateHandler(Label label)

Propagates a label for an exception handler that is typically suppressed by the overlaying Advice.Dispatcher.Inlining.Resolved.AdviceMethodInliner.ExceptionTableSubstitutor.

Parameters:

label - The label to register as a target for an exception handler.

visitParameter

public void visitParameter(String name,
                           int modifiers)

Overrides:

visitParameter in class MethodVisitor

visitAnnotationDefault

public AnnotationVisitor visitAnnotationDefault()

Overrides:

visitAnnotationDefault in class MethodVisitor

visitAnnotation

public AnnotationVisitor visitAnnotation(String descriptor,
                                         boolean visible)

Overrides:

visitAnnotation in class MethodVisitor

visitTypeAnnotation

public AnnotationVisitor visitTypeAnnotation(int typeReference,
                                             TypePath typePath,
                                             String descriptor,
                                             boolean visible)

Overrides:

visitTypeAnnotation in class MethodVisitor

visitParameterAnnotation

public AnnotationVisitor visitParameterAnnotation(int index,
                                                  String descriptor,
                                                  boolean visible)

Overrides:

visitParameterAnnotation in class MethodVisitor

visitAttribute

public void visitAttribute(Attribute attribute)

Overrides:

visitAttribute in class MethodVisitor

visitCode

public void visitCode()

Overrides:

visitCode in class MethodVisitor

visitFrame

public void visitFrame(int type,
                       int localVariableLength,
                       Object[] localVariable,
                       int stackSize,
                       Object[] stack)

Overrides:

visitFrame in class MethodVisitor

visitEnd

public void visitEnd()

Overrides:

visitEnd in class MethodVisitor

visitMaxs

public void visitMaxs(int stackSize,
                      int localVariableLength)

Overrides:

visitMaxs in class MethodVisitor

visitVarInsn

public void visitVarInsn(int opcode,
                         int offset)

Overrides:

visitVarInsn in class MethodVisitor

visitIincInsn

public void visitIincInsn(int offset,
                          int value)

Overrides:

visitIincInsn in class MethodVisitor

adjust

protected abstract int adjust(int offset)

Adjusts the offset of a variable instruction within the advice method such that no arguments to the instrumented method are overridden.

Parameters:

offset - The original offset.

Returns:

The adjusted offset.

visitInsn

public abstract void visitInsn(int opcode)

Overrides:

visitInsn in class MethodVisitor

onMethodReturn

protected abstract void onMethodReturn()

Invoked after returning from the advice method.