Module org.eclipse.persistence.asm
Class InstructionAdapter
java.lang.Object
org.eclipse.persistence.internal.libraries.asm.MethodVisitor
org.eclipse.persistence.internal.libraries.asm.commons.InstructionAdapter
A
MethodVisitor
providing a more detailed API to generate and transform instructions.-
Field Summary
FieldsFields inherited from class org.eclipse.persistence.internal.libraries.asm.MethodVisitor
api, mv
-
Constructor Summary
ConstructorsModifierConstructorDescriptionprotected
InstructionAdapter
(int api, MethodVisitor methodVisitor) Constructs a newInstructionAdapter
.InstructionAdapter
(MethodVisitor methodVisitor) Constructs a newInstructionAdapter
. -
Method Summary
Modifier and TypeMethodDescriptionvoid
Generates the instruction to push the given value on the stack.void
void
void
void
void
void
void
void
athrow()
void
Generates the instruction to cast from the first given type to the other.void
cconst
(ConstantDynamic constantDynamic) Generates the instruction to push the given constant dynamic on the stack.void
void
void
void
dconst
(double doubleValue) Generates the instruction to push the given value on the stack.void
void
dup()
void
dup2()
void
dup2X1()
void
dup2X2()
void
dupX1()
void
dupX2()
void
fconst
(float floatValue) Generates the instruction to push the given value on the stack.void
void
void
void
Generates the instruction to push the given handle on the stack.void
iconst
(int intValue) Generates the instruction to push the given value on the stack.void
void
void
void
void
void
void
void
void
void
void
void
void
void
void
void
void
iinc
(int varIndex, int increment) void
instanceOf
(Type type) void
invokedynamic
(String name, String descriptor, Handle bootstrapMethodHandle, Object[] bootstrapMethodArguments) Generates the instruction to call the given dynamic method.void
invokeinterface
(String owner, String name, String descriptor) Generates the instruction to call the given interface method.void
invokespecial
(String owner, String name, String descriptor) Deprecated.void
invokespecial
(String owner, String name, String descriptor, boolean isInterface) Generates the instruction to call the given special method.void
invokestatic
(String owner, String name, String descriptor) Deprecated.useinvokestatic(String, String, String, boolean)
instead.void
invokestatic
(String owner, String name, String descriptor, boolean isInterface) Generates the instruction to call the given static method.void
invokevirtual
(String owner, String name, String descriptor) Deprecated.useinvokevirtual(String, String, String, boolean)
instead.void
invokevirtual
(String owner, String name, String descriptor, boolean isInterface) Generates the instruction to call the given virtual method.void
void
lcmp()
void
lconst
(long longValue) Generates the instruction to push the given value on the stack.void
void
lookupswitch
(Label dflt, int[] keys, Label[] labels) void
void
void
void
void
multianewarray
(String descriptor, int numDimensions) void
void
Generates the instruction to create and push on the stack an array of the given type.void
nop()
Generates a nop instruction.void
void
pop()
void
pop2()
void
void
void
void
ret
(int varIndex) void
void
void
void
void
swap()
void
tableswitch
(int min, int max, Label dflt, Label... labels) void
Generates the instruction to push the given type on the stack.void
void
visitFieldInsn
(int opcode, String owner, String name, String descriptor) Visits a field instruction.void
visitIincInsn
(int varIndex, 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
(String name, String descriptor, Handle bootstrapMethodHandle, Object... bootstrapMethodArguments) Visits an invokedynamic instruction.void
visitJumpInsn
(int opcode, Label label) Visits a jump instruction.void
visitLabel
(Label label) Visits a label.void
visitLdcInsn
(Object value) Visits a LDC instruction.void
visitLookupSwitchInsn
(Label dflt, int[] keys, Label[] labels) Visits a LOOKUPSWITCH instruction.void
visitMethodInsn
(int opcodeAndSource, String owner, String name, String descriptor, boolean isInterface) Visits a method instruction.void
visitMultiANewArrayInsn
(String descriptor, int numDimensions) Visits a MULTIANEWARRAY instruction.void
visitTableSwitchInsn
(int min, int max, Label dflt, Label... labels) Visits a TABLESWITCH instruction.void
visitTypeInsn
(int opcode, String type) Visits a type instruction.void
visitVarInsn
(int opcode, int varIndex) Visits a local variable instruction.void
Methods inherited from class org.eclipse.persistence.internal.libraries.asm.MethodVisitor
getDelegate, visitAnnotableParameterCount, visitAnnotation, visitAnnotationDefault, visitAttribute, visitCode, visitEnd, visitFrame, visitInsnAnnotation, visitLineNumber, visitLocalVariable, visitLocalVariableAnnotation, visitMaxs, visitMethodInsn, visitParameter, visitParameterAnnotation, visitTryCatchAnnotation, visitTryCatchBlock, visitTypeAnnotation
-
Field Details
-
OBJECT_TYPE
The type of the java.lang.Object class.
-
-
Constructor Details
-
InstructionAdapter
Constructs a newInstructionAdapter
. Subclasses must not use this constructor. Instead, they must use theInstructionAdapter(int, MethodVisitor)
version.- Parameters:
methodVisitor
- the method visitor to which this adapter delegates calls.- Throws:
IllegalStateException
- If a subclass calls this constructor.
-
InstructionAdapter
Constructs a newInstructionAdapter
.- Parameters:
api
- the ASM API version implemented by this visitor. Must be one of theASM
x values inOpcodes
.methodVisitor
- the method visitor to which this adapter delegates calls.
-
-
Method Details
-
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 varIndex) 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.varIndex
- the operand of the instruction to be visited. This operand is the index of a local variable.
-
visitTypeInsn
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 (seeType.getInternalName()
).- 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 (seeType.getInternalName()
).
-
visitFieldInsn
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 (seeType.getInternalName()
).name
- the field's name.descriptor
- the field's descriptor (seeType
).
-
visitMethodInsn
public void visitMethodInsn(int opcodeAndSource, String owner, String name, String descriptor, boolean isInterface) Description copied from class:MethodVisitor
Visits a method instruction. A method instruction is an instruction that invokes a method.- Overrides:
visitMethodInsn
in classMethodVisitor
- Parameters:
opcodeAndSource
- 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 (seeType.getInternalName()
).name
- the method's name.descriptor
- the method's descriptor (seeType
).isInterface
- if the method's owner class is an interface.
-
visitInvokeDynamicInsn
public void visitInvokeDynamicInsn(String name, String descriptor, Handle bootstrapMethodHandle, Object... bootstrapMethodArguments) Description copied from class:MethodVisitor
Visits an invokedynamic instruction.- Overrides:
visitInvokeDynamicInsn
in classMethodVisitor
- Parameters:
name
- the method's name.descriptor
- the method's descriptor (seeType
).bootstrapMethodHandle
- the bootstrap method.bootstrapMethodArguments
- the bootstrap method constant arguments. Each argument must be anInteger
,Float
,Long
,Double
,String
,Type
,Handle
orConstantDynamic
value. This method is allowed to modify the content of the array so a caller should expect that this array may change.
-
visitJumpInsn
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
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
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 if (cst instanceof ConstantDynamic) { // ... } else { // throw an exception }
- Overrides:
visitLdcInsn
in classMethodVisitor
- Parameters:
value
- 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, aType
of METHOD sort for MethodType, aHandle
for MethodHandle constants, for classes whose version is 51 or aConstantDynamic
for a constant dynamic for classes whose version is 55.
-
visitIincInsn
public void visitIincInsn(int varIndex, int increment) Description copied from class:MethodVisitor
Visits an IINC instruction.- Overrides:
visitIincInsn
in classMethodVisitor
- Parameters:
varIndex
- index of the local variable to be incremented.increment
- amount to increment the local variable by.
-
visitTableSwitchInsn
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 themin + i
key.
-
visitLookupSwitchInsn
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 thekeys[i]
key.
-
visitMultiANewArrayInsn
Description copied from class:MethodVisitor
Visits a MULTIANEWARRAY instruction.- Overrides:
visitMultiANewArrayInsn
in classMethodVisitor
- Parameters:
descriptor
- an array type descriptor (seeType
).numDimensions
- the number of dimensions of the array to allocate.
-
nop
public void nop()Generates a nop instruction. -
aconst
Generates the instruction to push the given value on the stack.- Parameters:
value
- the constant to be pushed on the stack. This parameter must be anInteger
, aFloat
, aLong
, aDouble
, aString
, aType
of OBJECT or ARRAY sort for.class
constants, for classes whose version is 49, aType
of METHOD sort for MethodType, aHandle
for MethodHandle constants, for classes whose version is 51 or aConstantDynamic
for a constant dynamic for classes whose version is 55.
-
iconst
public void iconst(int intValue) Generates the instruction to push the given value on the stack.- Parameters:
intValue
- the constant to be pushed on the stack.
-
lconst
public void lconst(long longValue) Generates the instruction to push the given value on the stack.- Parameters:
longValue
- the constant to be pushed on the stack.
-
fconst
public void fconst(float floatValue) Generates the instruction to push the given value on the stack.- Parameters:
floatValue
- the constant to be pushed on the stack.
-
dconst
public void dconst(double doubleValue) Generates the instruction to push the given value on the stack.- Parameters:
doubleValue
- the constant to be pushed on the stack.
-
tconst
Generates the instruction to push the given type on the stack.- Parameters:
type
- the type to be pushed on the stack.
-
hconst
Generates the instruction to push the given handle on the stack.- Parameters:
handle
- the handle to be pushed on the stack.
-
cconst
Generates the instruction to push the given constant dynamic on the stack.- Parameters:
constantDynamic
- the constant dynamic to be pushed on the stack.
-
load
-
aload
-
store
-
astore
-
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
-
sub
-
mul
-
div
-
rem
-
neg
-
shl
-
shr
-
ushr
-
and
-
or
-
xor
-
iinc
public void iinc(int varIndex, int increment) -
cast
Generates the instruction to cast from the first given type to the other.- Parameters:
from
- a Type.to
- a Type.
-
lcmp
public void lcmp() -
cmpl
-
cmpg
-
ifeq
-
ifne
-
iflt
-
ifge
-
ifgt
-
ifle
-
ificmpeq
-
ificmpne
-
ificmplt
-
ificmpge
-
ificmpgt
-
ificmple
-
ifacmpeq
-
ifacmpne
-
goTo
-
jsr
-
ret
public void ret(int varIndex) -
tableswitch
-
lookupswitch
-
areturn
-
getstatic
-
putstatic
-
getfield
-
putfield
-
invokevirtual
Deprecated.useinvokevirtual(String, String, String, boolean)
instead.Deprecated.- Parameters:
owner
- the internal name of the method's owner class (seeType.getInternalName()
).name
- the method's name.descriptor
- the method's descriptor (seeType
).
-
invokevirtual
Generates the instruction to call the given virtual method.- Parameters:
owner
- the internal name of the method's owner class (seeType.getInternalName()
).name
- the method's name.descriptor
- the method's descriptor (seeType
).isInterface
- if the method's owner class is an interface.
-
invokespecial
Deprecated.useinvokespecial(String, String, String, boolean)
instead.Deprecated.- Parameters:
owner
- the internal name of the method's owner class (seeType.getInternalName()
).name
- the method's name.descriptor
- the method's descriptor (seeType
).
-
invokespecial
Generates the instruction to call the given special method.- Parameters:
owner
- the internal name of the method's owner class (seeType.getInternalName()
).name
- the method's name.descriptor
- the method's descriptor (seeType
).isInterface
- if the method's owner class is an interface.
-
invokestatic
Deprecated.useinvokestatic(String, String, String, boolean)
instead.Deprecated.- Parameters:
owner
- the internal name of the method's owner class (seeType.getInternalName()
).name
- the method's name.descriptor
- the method's descriptor (seeType
).
-
invokestatic
Generates the instruction to call the given static method.- Parameters:
owner
- the internal name of the method's owner class (seeType.getInternalName()
).name
- the method's name.descriptor
- the method's descriptor (seeType
).isInterface
- if the method's owner class is an interface.
-
invokeinterface
Generates the instruction to call the given interface method.- Parameters:
owner
- the internal name of the method's owner class (seeType.getInternalName()
).name
- the method's name.descriptor
- the method's descriptor (seeType
).
-
invokedynamic
public void invokedynamic(String name, String descriptor, Handle bootstrapMethodHandle, Object[] bootstrapMethodArguments) Generates the instruction to call the given dynamic method.- Parameters:
name
- the method's name.descriptor
- the method's descriptor (seeType
).bootstrapMethodHandle
- the bootstrap method.bootstrapMethodArguments
- the bootstrap method constant arguments. Each argument must be anInteger
,Float
,Long
,Double
,String
,Type
,Handle
orConstantDynamic
value. This method is allowed to modify the content of the array so a caller should expect that this array may change.
-
anew
-
newarray
Generates the instruction to create and push on the stack an array of the given type.- Parameters:
type
- an array Type.
-
arraylength
public void arraylength() -
athrow
public void athrow() -
checkcast
-
instanceOf
-
monitorenter
public void monitorenter() -
monitorexit
public void monitorexit() -
multianewarray
-
ifnull
-
ifnonnull
-
mark
-
invokespecial(String, String, String, boolean)
instead.