net.bytebuddy.asm

Class Advice.AdviceVisitor

java.lang.Object

org.objectweb.asm.MethodVisitor

net.bytebuddy.asm.Advice.AdviceVisitor

Direct Known Subclasses:

Advice.AdviceVisitor.WithExitAdvice, Advice.AdviceVisitor.WithoutExitAdvice

Enclosing class:

Advice

protected abstract static class Advice.AdviceVisitor
extends MethodVisitor

A method visitor that weaves the advice methods' byte codes.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	Advice.AdviceVisitor.CodeCopier A visitor for copying an advice method's byte code.
protected static class	Advice.AdviceVisitor.WithExitAdvice An advice visitor that applies exit advice.
protected static class	Advice.AdviceVisitor.WithoutExitAdvice An advice visitor that does not apply exit advice.

Field Summary

Fields

Modifier and Type	Field and Description
protected MethodDescription.InDefinedShape	instrumentedMethod A description of the instrumented method.
protected Advice.MetaDataHandler.ForInstrumentedMethod	metaDataHandler A handler to use for translating meta embedded in the byte code.

Fields inherited from class org.objectweb.asm.MethodVisitor

api, mv

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AdviceVisitor(MethodVisitor methodVisitor, MethodDescription.InDefinedShape instrumentedMethod, Advice.Dispatcher.Resolved.ForMethodEnter methodEnter, List<? extends TypeDescription> yieldedTypes, byte[] binaryRepresentation, int writerFlags, int readerFlags) Creates a new advice visitor.

Method Summary

Modifier and Type	Method and Description
protected void	append(Advice.Dispatcher.Resolved dispatcher) Applies the supplied advice dispatcher onto the target method visitor.
protected abstract void	onUserEnd() Writes the advice for completing the instrumented method.
protected abstract void	onUserStart() Writes the advice for entering the instrumented method.
protected void	variable(int opcode) Access the first variable after the instrumented variables and return type are stored.
protected void	variable(int opcode, int offset) Access the first variable after the instrumented variables and return type are stored.
void	visitCode()
void	visitFrame(int frameType, int localVariableLength, Object[] localVariable, int stackSize, Object[] stack)
void	visitIincInsn(int offset, int increment)
void	visitMaxs(int stackSize, int localVariableLength)
void	visitVarInsn(int opcode, int offset)

Methods inherited from class org.objectweb.asm.MethodVisitor

visitAnnotation, visitAnnotationDefault, visitAttribute, visitEnd, visitFieldInsn, visitInsn, visitInsnAnnotation, visitIntInsn, visitInvokeDynamicInsn, visitJumpInsn, visitLabel, visitLdcInsn, visitLineNumber, visitLocalVariable, visitLocalVariableAnnotation, visitLookupSwitchInsn, visitMethodInsn, visitMethodInsn, visitMultiANewArrayInsn, visitParameter, visitParameterAnnotation, visitTableSwitchInsn, visitTryCatchAnnotation, visitTryCatchBlock, visitTypeAnnotation, visitTypeInsn

Methods inherited from class java.lang.Object

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

Field Detail

instrumentedMethod

protected final MethodDescription.InDefinedShape instrumentedMethod

A description of the instrumented method.

metaDataHandler

protected final Advice.MetaDataHandler.ForInstrumentedMethod metaDataHandler

A handler to use for translating meta embedded in the byte code.

Constructor Detail

AdviceVisitor

protected AdviceVisitor(MethodVisitor methodVisitor,
                        MethodDescription.InDefinedShape instrumentedMethod,
                        Advice.Dispatcher.Resolved.ForMethodEnter methodEnter,
                        List<? extends TypeDescription> yieldedTypes,
                        byte[] binaryRepresentation,
                        int writerFlags,
                        int readerFlags)

Creates a new advice visitor.

Parameters:

methodVisitor - The method visitor to which all instructions are written.

instrumentedMethod - The instrumented method.

methodEnter - The method enter advice.

yieldedTypes - The types that are expected to be added after the instrumented method returns.

binaryRepresentation - The binary representation of the advice class.

writerFlags - The ASM writer flags that were set.

readerFlags - The ASM reader flags that were set.

Method Detail

visitCode

public void visitCode()

Overrides:

visitCode in class MethodVisitor

onUserStart

protected abstract void onUserStart()

Writes the advice for entering the instrumented method.

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

variable

protected void variable(int opcode)

Access the first variable after the instrumented variables and return type are stored.

Parameters:

opcode - The opcode for accessing the variable.

variable

protected void variable(int opcode,
                        int offset)

Access the first variable after the instrumented variables and return type are stored.

Parameters:

opcode - The opcode for accessing the variable.

offset - The additional offset of the variable.

visitFrame

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

Overrides:

visitFrame in class MethodVisitor

visitMaxs

public void visitMaxs(int stackSize,
                      int localVariableLength)

Overrides:

visitMaxs in class MethodVisitor

onUserEnd

protected abstract void onUserEnd()

Writes the advice for completing the instrumented method.

append

protected void append(Advice.Dispatcher.Resolved dispatcher)

Applies the supplied advice dispatcher onto the target method visitor.

Parameters:

dispatcher - The dispatcher to apply.