net.bytebuddy.asm

Class Advice.Dispatcher.Active.CodeTranslationVisitor

java.lang.Object

org.objectweb.asm.MethodVisitor

net.bytebuddy.asm.Advice.Dispatcher.Active.CodeTranslationVisitor

Direct Known Subclasses:

Advice.Dispatcher.Active.CodeTranslationVisitor.ForMethodEnter, Advice.Dispatcher.Active.CodeTranslationVisitor.ForMethodExit

Enclosing class:

Advice.Dispatcher.Active

protected abstract static class Advice.Dispatcher.Active.CodeTranslationVisitor
extends MethodVisitor

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.Active.CodeTranslationVisitor.ForMethodEnter A code translation visitor that retains the return value of the represented advice method.
protected static class	Advice.Dispatcher.Active.CodeTranslationVisitor.ForMethodExit A code translation visitor that discards the return value of the represented advice method.
protected static interface	Advice.Dispatcher.Active.CodeTranslationVisitor.SuppressionHandler A suppression handler for optionally suppressing exceptions.

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 MethodDescription.InDefinedShape	instrumentedMethod The instrumented method.
protected Advice.MetaDataHandler.ForAdvice	metaDataHandler A handler for translating meta data found in the byte code.

Fields inherited from class org.objectweb.asm.MethodVisitor

api, mv

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CodeTranslationVisitor(MethodVisitor methodVisitor, Advice.MetaDataHandler.ForAdvice metaDataHandler, MethodDescription.InDefinedShape instrumentedMethod, MethodDescription.InDefinedShape adviceMethod, Map<Integer,Advice.Dispatcher.Active.Resolved.OffsetMapping.Target> offsetMappings, TypeDescription throwableType) 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.
void	makeDefault(MethodVisitor methodVisitor) Sets a default return value for an adviced method.
AnnotationVisitor	visitAnnotation(String descriptor, boolean visible)
AnnotationVisitor	visitAnnotationDefault()
void	visitAttribute(Attribute attribute)
void	visitCode()
void	visitEnd()
void	visitFrame(int frameType, int localVariableLength, Object[] localVariable, int stackSize, Object[] stack)
void	visitIincInsn(int offset, int increment)
abstract void	visitInsn(int opcode)
void	visitLineNumber(int line, Label start)
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, 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

Field Detail

metaDataHandler

protected final Advice.MetaDataHandler.ForAdvice metaDataHandler

A handler for translating meta data found in the byte code.

instrumentedMethod

protected final MethodDescription.InDefinedShape 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,
                                 Advice.MetaDataHandler.ForAdvice metaDataHandler,
                                 MethodDescription.InDefinedShape instrumentedMethod,
                                 MethodDescription.InDefinedShape adviceMethod,
                                 Map<Integer,Advice.Dispatcher.Active.Resolved.OffsetMapping.Target> offsetMappings,
                                 TypeDescription throwableType)

Creates a new code translation visitor.

Parameters:

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

metaDataHandler - A handler for translating meta data found in the byte code.

instrumentedMethod - The instrumented method.

adviceMethod - The advice method.

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

throwableType - A throwable type to be suppressed or NoSuppression if no suppression should be applied.

Method Detail

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 frameType,
                       int localVariableLength,
                       Object[] localVariable,
                       int stackSize,
                       Object[] stack)

Overrides:

visitFrame in class MethodVisitor

visitLineNumber

public void visitLineNumber(int line,
                            Label start)

Overrides:

visitLineNumber 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 increment)

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

makeDefault

public void makeDefault(MethodVisitor methodVisitor)

Sets a default return value for an adviced method.

Parameters:

methodVisitor - The instrumented method's method visitor.