Class InstructionAdapter
- java.lang.Object
-
- com.googlecode.aviator.asm.MethodVisitor
-
- com.googlecode.aviator.asm.commons.InstructionAdapter
-
public class InstructionAdapter extends MethodVisitor
AMethodVisitor
providing a more detailed API to generate and transform instructions.
-
-
Field Summary
Fields Modifier and Type Field Description static Type
OBJECT_TYPE
-
Fields inherited from class com.googlecode.aviator.asm.MethodVisitor
api, mv
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
InstructionAdapter(int api, MethodVisitor mv)
Creates a newInstructionAdapter
.InstructionAdapter(MethodVisitor mv)
Creates a newInstructionAdapter
.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
aconst(java.lang.Object cst)
void
add(Type type)
void
aload(Type type)
void
and(Type type)
void
anew(Type type)
void
areturn(Type t)
void
arraylength()
void
astore(Type type)
void
athrow()
void
cast(Type from, Type to)
void
checkcast(Type type)
void
cmpg(Type type)
void
cmpl(Type type)
void
dconst(double cst)
void
div(Type type)
void
dup()
void
dup2()
void
dup2X1()
void
dup2X2()
void
dupX1()
void
dupX2()
void
fconst(float cst)
void
getfield(java.lang.String owner, java.lang.String name, java.lang.String desc)
void
getstatic(java.lang.String owner, java.lang.String name, java.lang.String desc)
void
goTo(Label label)
void
hconst(Handle handle)
void
iconst(int cst)
void
ifacmpeq(Label label)
void
ifacmpne(Label label)
void
ifeq(Label label)
void
ifge(Label label)
void
ifgt(Label label)
void
ificmpeq(Label label)
void
ificmpge(Label label)
void
ificmpgt(Label label)
void
ificmple(Label label)
void
ificmplt(Label label)
void
ificmpne(Label label)
void
ifle(Label label)
void
iflt(Label label)
void
ifne(Label label)
void
ifnonnull(Label label)
void
ifnull(Label label)
void
iinc(int var, int increment)
void
instanceOf(Type type)
void
invokedynamic(java.lang.String name, java.lang.String desc, Handle bsm, java.lang.Object[] bsmArgs)
void
invokeinterface(java.lang.String owner, java.lang.String name, java.lang.String desc)
void
invokespecial(java.lang.String owner, java.lang.String name, java.lang.String desc)
void
invokestatic(java.lang.String owner, java.lang.String name, java.lang.String desc)
void
invokevirtual(java.lang.String owner, java.lang.String name, java.lang.String desc)
void
jsr(Label label)
void
lcmp()
void
lconst(long cst)
void
load(int var, Type type)
void
lookupswitch(Label dflt, int[] keys, Label[] labels)
void
mark(Label label)
void
monitorenter()
void
monitorexit()
void
mul(Type type)
void
multianewarray(java.lang.String desc, int dims)
void
neg(Type type)
void
newarray(Type type)
void
nop()
void
or(Type type)
void
pop()
void
pop2()
void
putfield(java.lang.String owner, java.lang.String name, java.lang.String desc)
void
putstatic(java.lang.String owner, java.lang.String name, java.lang.String desc)
void
rem(Type type)
void
ret(int var)
void
shl(Type type)
void
shr(Type type)
void
store(int var, Type type)
void
sub(Type type)
void
swap()
void
tableswitch(int min, int max, Label dflt, Label... labels)
void
tconst(Type type)
void
ushr(Type type)
void
visitFieldInsn(int opcode, java.lang.String owner, java.lang.String name, java.lang.String desc)
Visits a field instruction.void
visitIincInsn(int var, int increment)
Visits an IINC 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
visitInvokeDynamicInsn(java.lang.String name, java.lang.String desc, Handle bsm, java.lang.Object... bsmArgs)
Visits an invokedynamic instruction.void
visitJumpInsn(int opcode, Label label)
Visits a jump instruction.void
visitLabel(Label label)
Visits a label.void
visitLdcInsn(java.lang.Object cst)
Visits a LDC instruction.void
visitLookupSwitchInsn(Label dflt, int[] keys, Label[] labels)
Visits a LOOKUPSWITCH instruction.void
visitMethodInsn(int opcode, java.lang.String owner, java.lang.String name, java.lang.String desc)
Visits a method instruction.void
visitMultiANewArrayInsn(java.lang.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, java.lang.String type)
Visits a type instruction.void
visitVarInsn(int opcode, int var)
Visits a local variable instruction.void
xor(Type type)
-
Methods inherited from class com.googlecode.aviator.asm.MethodVisitor
visitAnnotation, visitAnnotationDefault, visitAttribute, visitCode, visitEnd, visitFrame, visitLineNumber, visitLocalVariable, visitMaxs, visitParameterAnnotation, visitTryCatchBlock
-
-
-
-
Field Detail
-
OBJECT_TYPE
public static final Type OBJECT_TYPE
-
-
Constructor Detail
-
InstructionAdapter
public InstructionAdapter(MethodVisitor mv)
Creates a newInstructionAdapter
. Subclasses must not use this constructor. Instead, they must use theInstructionAdapter(int, MethodVisitor)
version.- Parameters:
mv
- the method visitor to which this adapter delegates calls.
-
InstructionAdapter
protected InstructionAdapter(int api, MethodVisitor mv)
Creates a newInstructionAdapter
.- Parameters:
api
- the ASM API version implemented by this visitor. Must be one ofOpcodes.ASM4
.mv
- the method visitor to which this adapter delegates calls.
-
-
Method Detail
-
visitInsn
public void visitInsn(int opcode)
Description copied from class:MethodVisitor
Visits a zero operand instruction.- Overrides:
visitInsn
in classMethodVisitor
- Parameters:
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.
-
visitIntInsn
public void visitIntInsn(int opcode, int operand)
Description copied from class:MethodVisitor
Visits an instruction with a single int operand.- Overrides:
visitIntInsn
in classMethodVisitor
- Parameters:
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 ofOpcodes.T_BOOLEAN
,Opcodes.T_CHAR
,Opcodes.T_FLOAT
,Opcodes.T_DOUBLE
,Opcodes.T_BYTE
,Opcodes.T_SHORT
,Opcodes.T_INT
orOpcodes.T_LONG
.
-
visitVarInsn
public void visitVarInsn(int opcode, int var)
Description copied from class:MethodVisitor
Visits a local variable instruction. A local variable instruction is an instruction that loads or stores the value of a local variable.- Overrides:
visitVarInsn
in classMethodVisitor
- Parameters:
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.
-
visitTypeInsn
public void visitTypeInsn(int opcode, java.lang.String type)
Description copied from class:MethodVisitor
Visits a type instruction. A type instruction is an instruction that takes the internal name of a class as parameter.- Overrides:
visitTypeInsn
in classMethodVisitor
- Parameters:
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 (seegetInternalName
).
-
visitFieldInsn
public void visitFieldInsn(int opcode, java.lang.String owner, java.lang.String name, java.lang.String desc)
Description copied from class:MethodVisitor
Visits a field instruction. A field instruction is an instruction that loads or stores the value of a field of an object.- Overrides:
visitFieldInsn
in classMethodVisitor
- Parameters:
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 (seegetInternalName
).name
- the field's name.desc
- the field's descriptor (seeType
).
-
visitMethodInsn
public void visitMethodInsn(int opcode, java.lang.String owner, java.lang.String name, java.lang.String desc)
Description copied from class:MethodVisitor
Visits a method instruction. A method instruction is an instruction that invokes a method.- Overrides:
visitMethodInsn
in classMethodVisitor
- Parameters:
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 (seegetInternalName
).name
- the method's name.desc
- the method's descriptor (seeType
).
-
visitInvokeDynamicInsn
public void visitInvokeDynamicInsn(java.lang.String name, java.lang.String desc, Handle bsm, java.lang.Object... bsmArgs)
Description copied from class:MethodVisitor
Visits an invokedynamic instruction.- Overrides:
visitInvokeDynamicInsn
in classMethodVisitor
- Parameters:
name
- the method's name.desc
- the method's descriptor (seeType
).bsm
- the bootstrap method.bsmArgs
- the bootstrap method constant arguments. Each argument must be anInteger
,Float
,Long
,Double
,String
,Type
orHandle
value. This method is allowed to modify the content of the array so a caller should expect that this array may change.
-
visitJumpInsn
public void visitJumpInsn(int opcode, Label label)
Description copied from class:MethodVisitor
Visits a jump instruction. A jump instruction is an instruction that may jump to another instruction.- Overrides:
visitJumpInsn
in classMethodVisitor
- Parameters:
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.
-
visitLabel
public void visitLabel(Label label)
Description copied from class:MethodVisitor
Visits a label. A label designates the instruction that will be visited just after it.- Overrides:
visitLabel
in classMethodVisitor
- Parameters:
label
- aLabel
object.
-
visitLdcInsn
public void visitLdcInsn(java.lang.Object cst)
Description copied from class:MethodVisitor
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 }
- Overrides:
visitLdcInsn
in classMethodVisitor
- Parameters:
cst
- the constant to be loaded on the stack. This parameter must be a non nullInteger
, aFloat
, aLong
, aDouble
, aString
, aType
of OBJECT or ARRAY sort for .class constants, for classes whose version is 49.0, aType
of METHOD sort or aHandle
for MethodType and MethodHandle constants, for classes whose version is 51.0.
-
visitIincInsn
public void visitIincInsn(int var, int increment)
Description copied from class:MethodVisitor
Visits an IINC instruction.- Overrides:
visitIincInsn
in classMethodVisitor
- Parameters:
var
- index of the local variable to be incremented.increment
- amount to increment the local variable by.
-
visitTableSwitchInsn
public void visitTableSwitchInsn(int min, int max, Label dflt, Label... labels)
Description copied from class:MethodVisitor
Visits a TABLESWITCH instruction.- Overrides:
visitTableSwitchInsn
in classMethodVisitor
- Parameters:
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.
-
visitLookupSwitchInsn
public void visitLookupSwitchInsn(Label dflt, int[] keys, Label[] labels)
Description copied from class:MethodVisitor
Visits a LOOKUPSWITCH instruction.- Overrides:
visitLookupSwitchInsn
in classMethodVisitor
- Parameters:
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.
-
visitMultiANewArrayInsn
public void visitMultiANewArrayInsn(java.lang.String desc, int dims)
Description copied from class:MethodVisitor
Visits a MULTIANEWARRAY instruction.- Overrides:
visitMultiANewArrayInsn
in classMethodVisitor
- Parameters:
desc
- an array type descriptor (seeType
).dims
- number of dimensions of the array to allocate.
-
nop
public void nop()
-
aconst
public void aconst(java.lang.Object cst)
-
iconst
public void iconst(int cst)
-
lconst
public void lconst(long cst)
-
fconst
public void fconst(float cst)
-
dconst
public void dconst(double cst)
-
tconst
public void tconst(Type type)
-
hconst
public void hconst(Handle handle)
-
load
public void load(int var, Type type)
-
aload
public void aload(Type type)
-
store
public void store(int var, Type type)
-
astore
public void astore(Type type)
-
pop
public void pop()
-
pop2
public void pop2()
-
dup
public void dup()
-
dup2
public void dup2()
-
dupX1
public void dupX1()
-
dupX2
public void dupX2()
-
dup2X1
public void dup2X1()
-
dup2X2
public void dup2X2()
-
swap
public void swap()
-
add
public void add(Type type)
-
sub
public void sub(Type type)
-
mul
public void mul(Type type)
-
div
public void div(Type type)
-
rem
public void rem(Type type)
-
neg
public void neg(Type type)
-
shl
public void shl(Type type)
-
shr
public void shr(Type type)
-
ushr
public void ushr(Type type)
-
and
public void and(Type type)
-
or
public void or(Type type)
-
xor
public void xor(Type type)
-
iinc
public void iinc(int var, int increment)
-
lcmp
public void lcmp()
-
cmpl
public void cmpl(Type type)
-
cmpg
public void cmpg(Type type)
-
ifeq
public void ifeq(Label label)
-
ifne
public void ifne(Label label)
-
iflt
public void iflt(Label label)
-
ifge
public void ifge(Label label)
-
ifgt
public void ifgt(Label label)
-
ifle
public void ifle(Label label)
-
ificmpeq
public void ificmpeq(Label label)
-
ificmpne
public void ificmpne(Label label)
-
ificmplt
public void ificmplt(Label label)
-
ificmpge
public void ificmpge(Label label)
-
ificmpgt
public void ificmpgt(Label label)
-
ificmple
public void ificmple(Label label)
-
ifacmpeq
public void ifacmpeq(Label label)
-
ifacmpne
public void ifacmpne(Label label)
-
goTo
public void goTo(Label label)
-
jsr
public void jsr(Label label)
-
ret
public void ret(int var)
-
areturn
public void areturn(Type t)
-
getstatic
public void getstatic(java.lang.String owner, java.lang.String name, java.lang.String desc)
-
putstatic
public void putstatic(java.lang.String owner, java.lang.String name, java.lang.String desc)
-
getfield
public void getfield(java.lang.String owner, java.lang.String name, java.lang.String desc)
-
putfield
public void putfield(java.lang.String owner, java.lang.String name, java.lang.String desc)
-
invokevirtual
public void invokevirtual(java.lang.String owner, java.lang.String name, java.lang.String desc)
-
invokespecial
public void invokespecial(java.lang.String owner, java.lang.String name, java.lang.String desc)
-
invokestatic
public void invokestatic(java.lang.String owner, java.lang.String name, java.lang.String desc)
-
invokeinterface
public void invokeinterface(java.lang.String owner, java.lang.String name, java.lang.String desc)
-
invokedynamic
public void invokedynamic(java.lang.String name, java.lang.String desc, Handle bsm, java.lang.Object[] bsmArgs)
-
anew
public void anew(Type type)
-
newarray
public void newarray(Type type)
-
arraylength
public void arraylength()
-
athrow
public void athrow()
-
checkcast
public void checkcast(Type type)
-
instanceOf
public void instanceOf(Type type)
-
monitorenter
public void monitorenter()
-
monitorexit
public void monitorexit()
-
multianewarray
public void multianewarray(java.lang.String desc, int dims)
-
ifnull
public void ifnull(Label label)
-
ifnonnull
public void ifnonnull(Label label)
-
mark
public void mark(Label label)
-
-