| java.lang.Object | |
| ↳ | org.eclipse.sisu.space.asm.MethodVisitor |
A visitor to visit a Java method. The methods of this class must be called in the following order: [ visitAnnotationDefault ] ( visitAnnotation | visitParameterAnnotation | visitAttribute )* [ visitCode ( visitFrame | visitXInsn | visitLabel | visitTryCatchBlock | visitLocalVariable | visitLineNumber )* visitMaxs ] visitEnd. In addition, the visitXInsn and visitLabel methods must be called in the sequential order of the bytecode instructions of the visited code, visitTryCatchBlock must be called before the labels passed as arguments have been visited, and the visitLocalVariable and visitLineNumber methods must be called after the labels passed as arguments have been visited.
| Fields | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| api | The ASM API version implemented by this visitor. | ||||||||||
| mv | The method visitor to which this visitor must delegate method calls. | ||||||||||
| Public Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Constructs a new
MethodVisitor. | |||||||||||
Constructs a new
MethodVisitor. | |||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Visits an annotation of this method.
| |||||||||||
Visits the default value of this annotation interface method.
| |||||||||||
Visits a non standard attribute of this method.
| |||||||||||
Starts the visit of the method's code, if any (i.e.
| |||||||||||
Visits the end of the method.
| |||||||||||
Visits a field instruction.
| |||||||||||
Visits the current state of the local variables and operand stack
elements.
| |||||||||||
Visits an IINC instruction.
| |||||||||||
Visits a zero operand instruction.
| |||||||||||
Visits an instruction with a single int operand.
| |||||||||||
Visits an invokedynamic instruction.
| |||||||||||
Visits a jump instruction.
| |||||||||||
Visits a label.
| |||||||||||
Visits a LDC instruction.
| |||||||||||
Visits a line number declaration.
| |||||||||||
Visits a local variable declaration.
| |||||||||||
Visits a LOOKUPSWITCH instruction.
| |||||||||||
Visits the maximum stack size and the maximum number of local variables
of the method.
| |||||||||||
Visits a method instruction.
| |||||||||||
Visits a MULTIANEWARRAY instruction.
| |||||||||||
Visits an annotation of a parameter this method.
| |||||||||||
Visits a TABLESWITCH instruction.
| |||||||||||
Visits a try catch block.
| |||||||||||
Visits a type instruction.
| |||||||||||
Visits a local variable instruction.
| |||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
The ASM API version implemented by this visitor. The value of this field
must be one of ASM4.
The method visitor to which this visitor must delegate method calls. May be null.
Constructs a new MethodVisitor.
| api | the ASM API version implemented by this visitor. Must be one
of ASM4.
|
|---|
Constructs a new MethodVisitor.
| api | the ASM API version implemented by this visitor. Must be one
of ASM4. |
|---|---|
| mv | the method visitor to which this visitor must delegate method calls. May be null. |
Visits an annotation of this method.
| desc | the class descriptor of the annotation class. |
|---|---|
| visible | true if the annotation is visible at runtime. |
Visits the default value of this annotation interface method.
Visits a non standard attribute of this method.
| attr | an attribute. |
|---|
Starts the visit of the method's code, if any (i.e. non abstract method).
Visits the end of the method. This method, which is the last one to be called, is used to inform the visitor that all the annotations and attributes of the method have been visited.
Visits a field instruction. A field instruction is an instruction that loads or stores the value of a field of an object.
| opcode | the opcode of the type instruction to be visited. This opcode is either GETSTATIC, PUTSTATIC, GETFIELD or PUTFIELD. |
|---|---|
| owner | the internal name of the field's owner class (see
getInternalName). |
| name | the field's name. |
| desc | the field's descriptor (see Type).
|
Visits the current state of the local variables and operand stack
elements. This method must(*) be called just before any
instruction i that follows an unconditional branch instruction
such as GOTO or THROW, that is the target of a jump instruction, or that
starts an exception handler block. The visited types must describe the
values of the local variables and of the operand stack elements just
before i is executed.
(*) this is mandatory only for classes whose version is greater than or
equal to V1_6.
The frames of a method must be given either in expanded form, or in
compressed form (all frames must use the same format, i.e. you must not
mix expanded and compressed frames within a single method):
F_SAME representing frame with exactly the same
locals as the previous frame and with the empty stack.F_SAME1 representing frame with exactly the same
locals as the previous frame and with single value on the stack (
nStack is 1 and stack[0] contains value for the
type of the stack item).F_APPEND representing frame with current locals are
the same as the locals in the previous frame, except that additional
locals are defined (nLocal is 1, 2 or 3 and
local elements contains values representing added types).F_CHOP representing frame with current locals are the
same as the locals in the previous frame, except that the last 1-3 locals
are absent and with the empty stack (nLocals is 1, 2 or 3).F_FULL representing complete frame data.| type | the type of this stack map frame. Must be
F_NEW for expanded frames, or
F_FULL, F_APPEND,
F_CHOP, F_SAME or
F_APPEND, F_SAME1 for
compressed frames. |
|---|---|
| nLocal | the number of local variables in the visited frame. |
| local | the local variable types in this frame. This array must not be
modified. Primitive types are represented by
TOP, INTEGER,
FLOAT, LONG,
DOUBLE,NULL or
UNINITIALIZED_THIS (long and double are
represented by a single element). Reference types are
represented by String objects (representing internal names),
and uninitialized types by Label objects (this label
designates the NEW instruction that created this uninitialized
value). |
| nStack | the number of operand stack elements in the visited frame. |
| stack | the operand stack types in this frame. This array must not be modified. Its content has the same format as the "local" array. |
| IllegalStateException | if a frame is visited just after another one, without any instruction between the two (unless this frame is a Opcodes#F_SAME frame, in which case it is silently ignored). |
|---|
Visits an IINC instruction.
| var | index of the local variable to be incremented. |
|---|---|
| increment | amount to increment the local variable by. |
Visits a zero operand instruction.
| opcode | the opcode of the instruction to be visited. This opcode is either NOP, ACONST_NULL, ICONST_M1, ICONST_0, ICONST_1, ICONST_2, ICONST_3, ICONST_4, ICONST_5, LCONST_0, LCONST_1, FCONST_0, FCONST_1, FCONST_2, DCONST_0, DCONST_1, IALOAD, LALOAD, FALOAD, DALOAD, AALOAD, BALOAD, CALOAD, SALOAD, IASTORE, LASTORE, FASTORE, DASTORE, AASTORE, BASTORE, CASTORE, SASTORE, POP, POP2, DUP, DUP_X1, DUP_X2, DUP2, DUP2_X1, DUP2_X2, SWAP, IADD, LADD, FADD, DADD, ISUB, LSUB, FSUB, DSUB, IMUL, LMUL, FMUL, DMUL, IDIV, LDIV, FDIV, DDIV, IREM, LREM, FREM, DREM, INEG, LNEG, FNEG, DNEG, ISHL, LSHL, ISHR, LSHR, IUSHR, LUSHR, IAND, LAND, IOR, LOR, IXOR, LXOR, I2L, I2F, I2D, L2I, L2F, L2D, F2I, F2L, F2D, D2I, D2L, D2F, I2B, I2C, I2S, LCMP, FCMPL, FCMPG, DCMPL, DCMPG, IRETURN, LRETURN, FRETURN, DRETURN, ARETURN, RETURN, ARRAYLENGTH, ATHROW, MONITORENTER, or MONITOREXIT. |
|---|
Visits an instruction with a single int operand.
| opcode | the opcode of the instruction to be visited. This opcode is either BIPUSH, SIPUSH or NEWARRAY. |
|---|---|
| operand | the operand of the instruction to be visited. When opcode is BIPUSH, operand value should be between Byte.MIN_VALUE and Byte.MAX_VALUE. When opcode is SIPUSH, operand value should be between Short.MIN_VALUE and Short.MAX_VALUE. When opcode is NEWARRAY, operand value should be one of T_BOOLEAN, T_CHAR,
T_FLOAT, T_DOUBLE,
T_BYTE, T_SHORT,
T_INT or T_LONG.
|
Visits an invokedynamic instruction.
| name | the method's name. |
|---|---|
| desc | the method's descriptor (see Type). |
| bsm | the bootstrap method. |
| bsmArgs | the bootstrap method constant arguments. Each argument must be
an Integer, Float, Long,
Double, String, Type or Handle
value. This method is allowed to modify the content of the
array so a caller should expect that this array may change.
|
Visits a jump instruction. A jump instruction is an instruction that may jump to another instruction.
| opcode | the opcode of the type instruction to be visited. This opcode is either IFEQ, IFNE, IFLT, IFGE, IFGT, IFLE, IF_ICMPEQ, IF_ICMPNE, IF_ICMPLT, IF_ICMPGE, IF_ICMPGT, IF_ICMPLE, IF_ACMPEQ, IF_ACMPNE, GOTO, JSR, IFNULL or IFNONNULL. |
|---|---|
| label | the operand of the instruction to be visited. This operand is a label that designates the instruction to which the jump instruction may jump. |
Visits a label. A label designates the instruction that will be visited just after it.
| label | a Label object.
|
|---|
Visits a LDC instruction. Note that new constant types may be added in future versions of the Java Virtual Machine. To easily detect new constant types, implementations of this method should check for unexpected constant types, like this:
if (cst instanceof Integer) {
// ...
} else if (cst instanceof Float) {
// ...
} else if (cst instanceof Long) {
// ...
} else if (cst instanceof Double) {
// ...
} else if (cst instanceof String) {
// ...
} else if (cst instanceof Type) {
int sort = ((Type) cst).getSort();
if (sort == Type.OBJECT) {
// ...
} else if (sort == Type.ARRAY) {
// ...
} else if (sort == Type.METHOD) {
// ...
} else {
// throw an exception
}
} else if (cst instanceof Handle) {
// ...
} else {
// throw an exception
}
| cst | the constant to be loaded on the stack. This parameter must be
a non null Integer, a Float, a Long, a
Double, a String, a Type of OBJECT or
ARRAY sort for .class constants, for classes whose
version is 49.0, a Type of METHOD sort or a
Handle for MethodType and MethodHandle constants, for
classes whose version is 51.0.
|
|---|
Visits a line number declaration.
| line | a line number. This number refers to the source file from which the class was compiled. |
|---|---|
| start | the first instruction corresponding to this line number. |
| IllegalArgumentException | if start has not already been visited by this
visitor (by the visitLabel method).
|
|---|
Visits a local variable declaration.
| name | the name of a local variable. |
|---|---|
| desc | the type descriptor of this local variable. |
| signature | the type signature of this local variable. May be null if the local variable type does not use generic types. |
| start | the first instruction corresponding to the scope of this local variable (inclusive). |
| end | the last instruction corresponding to the scope of this local variable (exclusive). |
| index | the local variable's index. |
| IllegalArgumentException | if one of the labels has not already been visited by this
visitor (by the visitLabel method).
|
|---|
Visits a LOOKUPSWITCH instruction.
| dflt | beginning of the default handler block. |
|---|---|
| keys | the values of the keys. |
| labels | beginnings of the handler blocks. labels[i] is the beginning of the handler block for the keys[i] key. |
Visits the maximum stack size and the maximum number of local variables of the method.
| maxStack | maximum stack size of the method. |
|---|---|
| maxLocals | maximum number of local variables for the method. |
Visits a method instruction. A method instruction is an instruction that invokes a method.
| opcode | the opcode of the type instruction to be visited. This opcode is either INVOKEVIRTUAL, INVOKESPECIAL, INVOKESTATIC or INVOKEINTERFACE. |
|---|---|
| owner | the internal name of the method's owner class (see
getInternalName). |
| name | the method's name. |
| desc | the method's descriptor (see Type).
|
Visits a MULTIANEWARRAY instruction.
| desc | an array type descriptor (see Type). |
|---|---|
| dims | number of dimensions of the array to allocate. |
Visits an annotation of a parameter this method.
| parameter | the parameter index. |
|---|---|
| desc | the class descriptor of the annotation class. |
| visible | true if the annotation is visible at runtime. |
Visits a TABLESWITCH instruction.
| min | the minimum key value. |
|---|---|
| max | the maximum key value. |
| dflt | beginning of the default handler block. |
| labels | beginnings of the handler blocks. labels[i] is the beginning of the handler block for the min + i key. |
Visits a try catch block.
| start | beginning of the exception handler's scope (inclusive). |
|---|---|
| end | end of the exception handler's scope (exclusive). |
| handler | beginning of the exception handler's code. |
| type | internal name of the type of exceptions handled by the handler, or null to catch any exceptions (for "finally" blocks). |
| IllegalArgumentException | if one of the labels has already been visited by this visitor
(by the visitLabel method).
|
|---|
Visits a type instruction. A type instruction is an instruction that takes the internal name of a class as parameter.
| opcode | the opcode of the type instruction to be visited. This opcode is either NEW, ANEWARRAY, CHECKCAST or INSTANCEOF. |
|---|---|
| type | the operand of the instruction to be visited. This operand
must be the internal name of an object or array class (see
getInternalName).
|
Visits a local variable instruction. A local variable instruction is an instruction that loads or stores the value of a local variable.
| opcode | the opcode of the local variable instruction to be visited. This opcode is either ILOAD, LLOAD, FLOAD, DLOAD, ALOAD, ISTORE, LSTORE, FSTORE, DSTORE, ASTORE or RET. |
|---|---|
| var | the operand of the instruction to be visited. This operand is the index of a local variable. |