org.objectweb.asm.commons
Class AdviceAdapter

java.lang.Object
  extended byorg.objectweb.asm.MethodAdapter
      extended byorg.objectweb.asm.commons.LocalVariablesSorter
          extended byorg.objectweb.asm.commons.GeneratorAdapter
              extended byorg.objectweb.asm.commons.AdviceAdapter
All Implemented Interfaces:
MethodVisitor, Opcodes

public abstract class AdviceAdapter
extends GeneratorAdapter
implements Opcodes

A MethodAdapter to dispatch method body instruction

The behavior is like this:

  1. as long as the INVOKESPECIAL for the object initialization has not been reached, every bytecode instruction is dispatched in the ctor code visitor
  2. when this one is reached, it is only added in the ctor code visitor and a JP invoke is added
  3. after that, only the other code visitor receives the instructions

Author:
Eugene Kuleshov, Eric Bruneton

Field Summary
protected  int methodAccess
           
protected  String methodDesc
           
 
Fields inherited from class org.objectweb.asm.commons.GeneratorAdapter
ADD, AND, DIV, EQ, GE, GT, LE, LT, MUL, NE, NEG, OR, REM, SHL, SHR, SUB, USHR, XOR
 
Fields inherited from class org.objectweb.asm.commons.LocalVariablesSorter
firstLocal
 
Fields inherited from class org.objectweb.asm.MethodAdapter
mv
 
Fields inherited from interface org.objectweb.asm.Opcodes
AALOAD, AASTORE, ACC_ABSTRACT, ACC_ANNOTATION, ACC_BRIDGE, ACC_DEPRECATED, ACC_ENUM, ACC_FINAL, ACC_INTERFACE, ACC_NATIVE, ACC_PRIVATE, ACC_PROTECTED, ACC_PUBLIC, ACC_STATIC, ACC_STRICT, ACC_SUPER, ACC_SYNCHRONIZED, ACC_SYNTHETIC, ACC_TRANSIENT, ACC_VARARGS, ACC_VOLATILE, ACONST_NULL, ALOAD, ANEWARRAY, ARETURN, ARRAYLENGTH, ASTORE, ATHROW, BALOAD, BASTORE, BIPUSH, CALOAD, CASTORE, CHECKCAST, D2F, D2I, D2L, DADD, DALOAD, DASTORE, DCMPG, DCMPL, DCONST_0, DCONST_1, DDIV, DLOAD, DMUL, DNEG, DREM, DRETURN, DSTORE, DSUB, DUP, DUP_X1, DUP_X2, DUP2, DUP2_X1, DUP2_X2, F2D, F2I, F2L, FADD, FALOAD, FASTORE, FCMPG, FCMPL, FCONST_0, FCONST_1, FCONST_2, FDIV, FLOAD, FMUL, FNEG, FREM, FRETURN, FSTORE, FSUB, GETFIELD, GETSTATIC, GOTO, I2B, I2C, I2D, I2F, I2L, I2S, IADD, IALOAD, IAND, IASTORE, ICONST_0, ICONST_1, ICONST_2, ICONST_3, ICONST_4, ICONST_5, ICONST_M1, IDIV, IF_ACMPEQ, IF_ACMPNE, IF_ICMPEQ, IF_ICMPGE, IF_ICMPGT, IF_ICMPLE, IF_ICMPLT, IF_ICMPNE, IFEQ, IFGE, IFGT, IFLE, IFLT, IFNE, IFNONNULL, IFNULL, IINC, ILOAD, IMUL, INEG, INSTANCEOF, INVOKEINTERFACE, INVOKESPECIAL, INVOKESTATIC, INVOKEVIRTUAL, IOR, IREM, IRETURN, ISHL, ISHR, ISTORE, ISUB, IUSHR, IXOR, JSR, L2D, L2F, L2I, LADD, LALOAD, LAND, LASTORE, LCMP, LCONST_0, LCONST_1, LDC, LDIV, LLOAD, LMUL, LNEG, LOOKUPSWITCH, LOR, LREM, LRETURN, LSHL, LSHR, LSTORE, LSUB, LUSHR, LXOR, MONITORENTER, MONITOREXIT, MULTIANEWARRAY, NEW, NEWARRAY, NOP, POP, POP2, PUTFIELD, PUTSTATIC, RET, RETURN, SALOAD, SASTORE, SIPUSH, SWAP, T_BOOLEAN, T_BYTE, T_CHAR, T_DOUBLE, T_FLOAT, T_INT, T_LONG, T_SHORT, TABLESWITCH, V1_1, V1_2, V1_3, V1_4, V1_5, V1_6
 
Constructor Summary
AdviceAdapter(MethodVisitor mv, int access, String name, String desc)
          Creates a new AdviceAdapter.
 
Method Summary
protected abstract  void onMethodEnter()
          Called at the beginning of the method or after super class class call in the constructor.
protected abstract  void onMethodExit(int opcode)
          Called before explicit exit from the method using either return or throw.
 void visitFieldInsn(int opcode, String owner, String name, String desc)
          Visits a field instruction.
 void visitInsn(int opcode)
          Visits a zero operand instruction.
 void visitIntInsn(int opcode, int operand)
          Visits an instruction with a single int operand.
 void visitJumpInsn(int opcode, Label label)
          Visits a jump instruction.
 void visitLabel(Label label)
          Visits a label.
 void visitLdcInsn(Object cst)
          Visits a LDC instruction.
 void visitLookupSwitchInsn(Label dflt, int[] keys, Label[] labels)
          Visits a LOOKUPSWITCH instruction.
 void visitMethodInsn(int opcode, String owner, String name, String desc)
          Visits a method instruction.
 void visitMultiANewArrayInsn(String desc, int dims)
          Visits a MULTIANEWARRAY instruction.
 void visitTableSwitchInsn(int min, int max, Label dflt, Label[] labels)
          Visits a TABLESWITCH instruction.
 void visitTypeInsn(int opcode, String name)
          Visits a type instruction.
 void visitVarInsn(int opcode, int var)
          Visits a local variable instruction.
 
Methods inherited from class org.objectweb.asm.commons.GeneratorAdapter
arrayLength, arrayLoad, arrayStore, box, cast, catchException, checkCast, dup, dup2, dup2X1, dup2X2, dupX1, dupX2, endMethod, getField, getLocalType, getStatic, goTo, ifCmp, ifICmp, ifNonNull, ifNull, ifZCmp, iinc, instanceOf, invokeConstructor, invokeInterface, invokeStatic, invokeVirtual, loadArg, loadArgArray, loadArgs, loadArgs, loadLocal, loadLocal, loadThis, mark, mark, math, monitorEnter, monitorExit, newArray, newInstance, newLabel, newLocal, not, pop, pop2, push, push, push, push, push, push, push, putField, putStatic, ret, returnValue, storeArg, storeLocal, storeLocal, swap, swap, tableSwitch, tableSwitch, throwException, throwException, unbox
 
Methods inherited from class org.objectweb.asm.commons.LocalVariablesSorter
newLocal, visitIincInsn, visitLocalVariable, visitMaxs
 
Methods inherited from class org.objectweb.asm.MethodAdapter
visitAnnotation, visitAnnotationDefault, visitAttribute, visitCode, visitEnd, visitLineNumber, visitParameterAnnotation, visitTryCatchBlock
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

methodAccess

protected int methodAccess

methodDesc

protected String methodDesc
Constructor Detail

AdviceAdapter

public AdviceAdapter(MethodVisitor mv,
                     int access,
                     String name,
                     String desc)
Creates a new AdviceAdapter.

Parameters:
mv - the method visitor to which this adapter delegates calls.
access - the method's access flags (see Opcodes).
name - the method's name.
desc - the method's descriptor (see Type).
Method Detail

visitLabel

public void visitLabel(Label label)
Description copied from interface: MethodVisitor
Visits a label. A label designates the instruction that will be visited just after it.

Specified by:
visitLabel in interface MethodVisitor
Overrides:
visitLabel in class MethodAdapter

visitInsn

public void visitInsn(int opcode)
Description copied from interface: MethodVisitor
Visits a zero operand instruction.

Specified by:
visitInsn in interface MethodVisitor
Overrides:
visitInsn in class MethodAdapter

visitVarInsn

public void visitVarInsn(int opcode,
                         int var)
Description copied from interface: MethodVisitor
Visits a local variable instruction. A local variable instruction is an instruction that loads or stores the value of a local variable.

Specified by:
visitVarInsn in interface MethodVisitor
Overrides:
visitVarInsn in class LocalVariablesSorter

visitFieldInsn

public void visitFieldInsn(int opcode,
                           String owner,
                           String name,
                           String desc)
Description copied from interface: MethodVisitor
Visits a field instruction. A field instruction is an instruction that loads or stores the value of a field of an object.

Specified by:
visitFieldInsn in interface MethodVisitor
Overrides:
visitFieldInsn in class MethodAdapter

visitIntInsn

public void visitIntInsn(int opcode,
                         int operand)
Description copied from interface: MethodVisitor
Visits an instruction with a single int operand.

Specified by:
visitIntInsn in interface MethodVisitor
Overrides:
visitIntInsn in class MethodAdapter

visitLdcInsn

public void visitLdcInsn(Object cst)
Description copied from interface: MethodVisitor
Visits a LDC instruction.

Specified by:
visitLdcInsn in interface MethodVisitor
Overrides:
visitLdcInsn in class MethodAdapter

visitMultiANewArrayInsn

public void visitMultiANewArrayInsn(String desc,
                                    int dims)
Description copied from interface: MethodVisitor
Visits a MULTIANEWARRAY instruction.

Specified by:
visitMultiANewArrayInsn in interface MethodVisitor
Overrides:
visitMultiANewArrayInsn in class MethodAdapter

visitTypeInsn

public void visitTypeInsn(int opcode,
                          String name)
Description copied from interface: MethodVisitor
Visits a type instruction. A type instruction is an instruction that takes a type descriptor as parameter.

Specified by:
visitTypeInsn in interface MethodVisitor
Overrides:
visitTypeInsn in class MethodAdapter

visitMethodInsn

public void visitMethodInsn(int opcode,
                            String owner,
                            String name,
                            String desc)
Description copied from interface: MethodVisitor
Visits a method instruction. A method instruction is an instruction that invokes a method.

Specified by:
visitMethodInsn in interface MethodVisitor
Overrides:
visitMethodInsn in class MethodAdapter

visitJumpInsn

public void visitJumpInsn(int opcode,
                          Label label)
Description copied from interface: MethodVisitor
Visits a jump instruction. A jump instruction is an instruction that may jump to another instruction.

Specified by:
visitJumpInsn in interface MethodVisitor
Overrides:
visitJumpInsn in class MethodAdapter

visitLookupSwitchInsn

public void visitLookupSwitchInsn(Label dflt,
                                  int[] keys,
                                  Label[] labels)
Description copied from interface: MethodVisitor
Visits a LOOKUPSWITCH instruction.

Specified by:
visitLookupSwitchInsn in interface MethodVisitor
Overrides:
visitLookupSwitchInsn in class MethodAdapter

visitTableSwitchInsn

public void visitTableSwitchInsn(int min,
                                 int max,
                                 Label dflt,
                                 Label[] labels)
Description copied from interface: MethodVisitor
Visits a TABLESWITCH instruction.

Specified by:
visitTableSwitchInsn in interface MethodVisitor
Overrides:
visitTableSwitchInsn in class MethodAdapter

onMethodEnter

protected abstract void onMethodEnter()
Called at the beginning of the method or after super class class call in the constructor.

Custom code can use or change all the local variables, but should not change state of the stack.


onMethodExit

protected abstract void onMethodExit(int opcode)
Called before explicit exit from the method using either return or throw. Top element on the stack contains the return value or exception instance. For example:
   public void onMethodExit(int opcode) {
     if(opcode==RETURN) {
         visitInsn(ACONST_NULL);
     } else if(opcode==ARETURN || opcode==ATHROW) {
         dup();
     } else {
         if(opcode==LRETURN || opcode==DRETURN) {
             dup2();
         } else {
             dup();
         }
         box(Type.getReturnType(this.methodDesc));
     }
     visitIntInsn(SIPUSH, opcode);
     visitMethodInsn(INVOKESTATIC, owner, "onExit", "(Ljava/lang/Object;I)V");
   }

   // an actual call back method
   public static void onExit(int opcode, Object param) {
     ...
 


Custom code can use or change all the local variables, but should not change state of the stack.

Parameters:
opcode - one of the RETURN, IRETURN, FRETURN, ARETURN, LRETURN, DRETURN or ATHROW