net.bytebuddy.asm

Class Advice.Dispatcher.Inlining.CodeTranslationVisitor

java.lang.Object

org.objectweb.asm.MethodVisitor

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

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 org.objectweb.asm.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.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 Advice.ArgumentHandler.ForAdvice	argumentHandler A handler for accessing values on the local variable array.
protected org.objectweb.asm.Label	endOfMethod A label indicating the end of the advice byte code.
protected Implementation.Context	implementationContext The implementation context to use.
protected Advice.MethodSizeHandler.ForAdvice	methodSizeHandler A handler for computing the method size requirements.
protected org.objectweb.asm.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(org.objectweb.asm.MethodVisitor methodVisitor, Implementation.Context implementationContext, Advice.ArgumentHandler.ForAdvice argumentHandler, Advice.MethodSizeHandler.ForAdvice methodSizeHandler, Advice.StackMapFrameHandler.ForAdvice stackMapFrameHandler, MethodDescription instrumentedMethod, MethodDescription.InDefinedShape adviceMethod, Map<Integer,Advice.OffsetMapping.Target> offsetMappings, Advice.Dispatcher.SuppressionHandler.Bound suppressionHandler, Advice.Dispatcher.RelocationHandler.Bound relocationHandler) Creates a new code translation visitor.

Method Summary

Modifier and Type	Method and Description
protected abstract int	getReturnValueOffset() Resolves the offset of the advice method's local variable.
protected void	propagateHandler(org.objectweb.asm.Label label) Propagates a label for an exception handler that is typically suppressed by the overlaying Advice.Dispatcher.Inlining.Resolved.AdviceMethodInliner.ExceptionTableSubstitutor.
void	visitAnnotableParameterCount(int count, boolean visible)
org.objectweb.asm.AnnotationVisitor	visitAnnotation(String descriptor, boolean visible)
org.objectweb.asm.AnnotationVisitor	visitAnnotationDefault()
void	visitAttribute(org.objectweb.asm.Attribute attribute)
void	visitCode()
void	visitEnd()
void	visitFrame(int type, int localVariableLength, Object[] localVariable, int stackSize, Object[] stack)
void	visitIincInsn(int offset, int value)
void	visitInsn(int opcode)
void	visitMaxs(int stackSize, int localVariableLength)
void	visitParameter(String name, int modifiers)
org.objectweb.asm.AnnotationVisitor	visitParameterAnnotation(int index, String descriptor, boolean visible)
org.objectweb.asm.AnnotationVisitor	visitTypeAnnotation(int typeReference, org.objectweb.asm.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

Field Detail

methodVisitor

protected final org.objectweb.asm.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.

argumentHandler

protected final Advice.ArgumentHandler.ForAdvice argumentHandler

A handler for accessing values on the local variable array.

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.

adviceMethod

protected final MethodDescription.InDefinedShape adviceMethod

The advice method.

endOfMethod

protected final org.objectweb.asm.Label endOfMethod

A label indicating the end of the advice byte code.

Constructor Detail

CodeTranslationVisitor

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

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.

argumentHandler - A handler for accessing values on the local variable array.

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 - A bound suppression handler that is used for suppressing exceptions of this advice method.

relocationHandler - A bound relocation handler that is responsible for considering a non-standard control flow.

Method Detail

propagateHandler

protected void propagateHandler(org.objectweb.asm.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 org.objectweb.asm.MethodVisitor

visitAnnotableParameterCount

public void visitAnnotableParameterCount(int count,
                                         boolean visible)

Overrides:

visitAnnotableParameterCount in class org.objectweb.asm.MethodVisitor

visitAnnotationDefault

public org.objectweb.asm.AnnotationVisitor visitAnnotationDefault()

Overrides:

visitAnnotationDefault in class org.objectweb.asm.MethodVisitor

visitAnnotation

public org.objectweb.asm.AnnotationVisitor visitAnnotation(String descriptor,
                                                           boolean visible)

Overrides:

visitAnnotation in class org.objectweb.asm.MethodVisitor

visitTypeAnnotation

public org.objectweb.asm.AnnotationVisitor visitTypeAnnotation(int typeReference,
                                                               org.objectweb.asm.TypePath typePath,
                                                               String descriptor,
                                                               boolean visible)

Overrides:

visitTypeAnnotation in class org.objectweb.asm.MethodVisitor

visitParameterAnnotation

public org.objectweb.asm.AnnotationVisitor visitParameterAnnotation(int index,
                                                                    String descriptor,
                                                                    boolean visible)

Overrides:

visitParameterAnnotation in class org.objectweb.asm.MethodVisitor

visitAttribute

public void visitAttribute(org.objectweb.asm.Attribute attribute)

Overrides:

visitAttribute in class org.objectweb.asm.MethodVisitor

visitCode

public void visitCode()

Overrides:

visitCode in class org.objectweb.asm.MethodVisitor

visitFrame

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

Overrides:

visitFrame in class org.objectweb.asm.MethodVisitor

visitVarInsn

public void visitVarInsn(int opcode,
                         int offset)

Overrides:

visitVarInsn in class org.objectweb.asm.MethodVisitor

visitIincInsn

public void visitIincInsn(int offset,
                          int value)

Overrides:

visitIincInsn in class org.objectweb.asm.MethodVisitor

visitInsn

public void visitInsn(int opcode)

Overrides:

visitInsn in class org.objectweb.asm.MethodVisitor

visitEnd

public void visitEnd()

Overrides:

visitEnd in class org.objectweb.asm.MethodVisitor

visitMaxs

public void visitMaxs(int stackSize,
                      int localVariableLength)

Overrides:

visitMaxs in class org.objectweb.asm.MethodVisitor

getReturnValueOffset

protected abstract int getReturnValueOffset()

Resolves the offset of the advice method's local variable. The returned value is only valid if this advice method does not return void.

Returns:

The offset of the represented advice method.