public class EnhancerPropertyGetterAdapter extends MethodVisitor
YYY getZZZ() { if (dnFlags > 0 && dnStateManager != null && !dnStateManager.isLoaded(this, 0)) return (Integer) dnStateManager.getObjectField(this, 0, dnGetXXX()); if (dnIsDetached() && !((BitSet) dnDetachedState[2]).get(0)) throw new DetachedFieldAccessException ("You have just attempted to access property \"id\" yet this field was not detached ..."); return dnGetXXX(); }and when not detachable
YYY getZZZ() { if (dnFlags > 0 && dnStateManager != null && !dnStateManager.isLoaded(this, 0)) return (Integer) dnStateManager.getObjectField(this, 0, dnGetXXX()); return dnGetXXX(); }There are other variants for MEDIATE_READ and NORMAL_READ
Modifier and Type | Field and Description |
---|---|
protected ClassEnhancer |
enhancer
The enhancer for this class.
|
protected String |
methodDescriptor
Descriptor for the method being adapted.
|
protected String |
methodName
Name for the method being adapted.
|
protected AbstractMemberMetaData |
mmd
MetaData for the property.
|
protected MethodVisitor |
visitor
Visitor for the dnGetXXX method.
|
api, mv
Constructor and Description |
---|
EnhancerPropertyGetterAdapter(MethodVisitor mv,
ClassEnhancer enhancer,
String methodName,
String methodDesc,
AbstractMemberMetaData mmd,
ClassVisitor cv)
Constructor for the method adapter.
|
Modifier and Type | Method and Description |
---|---|
static void |
generateGetXXXMethod(MethodVisitor mv,
AbstractMemberMetaData mmd,
String asmClassName,
String asmClassDesc,
boolean detachListener,
EnhancementNamer namer)
Convenience method to use the MethodVisitor to generate the code for the method getXXX() for the property with the specified MetaData.
|
AnnotationVisitor |
visitAnnotation(String arg0,
boolean arg1)
Visits an annotation of this method.
|
AnnotationVisitor |
visitAnnotationDefault()
Visits the default value of this annotation interface method.
|
void |
visitAttribute(Attribute arg0)
Visits a non standard attribute of this method.
|
void |
visitCode()
Starts the visit of the method's code, if any (i.e.
|
void |
visitEnd()
Method called at the end of visiting the getXXX method.
|
void |
visitFieldInsn(int opcode,
String owner,
String name,
String desc)
Visits a field instruction.
|
void |
visitFrame(int arg0,
int arg1,
Object[] arg2,
int arg3,
Object[] arg4)
Visits the current state of the local variables and operand stack elements.
|
void |
visitIincInsn(int arg0,
int arg1)
Visits an IINC instruction.
|
void |
visitInsn(int opcode)
Visits a zero operand instruction.
|
AnnotationVisitor |
visitInsnAnnotation(int typeRef,
TypePath typePath,
String desc,
boolean visible)
Visits an annotation on an instruction.
|
void |
visitIntInsn(int arg0,
int arg1)
Visits an instruction with a single int operand.
|
void |
visitInvokeDynamicInsn(String name,
String desc,
Handle bsm,
Object... bsmArgs)
Visits an invokedynamic instruction.
|
void |
visitJumpInsn(int arg0,
Label arg1)
Visits a jump instruction.
|
void |
visitLabel(Label arg0)
Visits a label.
|
void |
visitLdcInsn(Object arg0)
Visits a LDC instruction.
|
void |
visitLineNumber(int arg0,
Label arg1)
Visits a line number declaration.
|
void |
visitLocalVariable(String arg0,
String arg1,
String arg2,
Label arg3,
Label arg4,
int arg5)
Visits a local variable declaration.
|
AnnotationVisitor |
visitLocalVariableAnnotation(int typeRef,
TypePath typePath,
Label[] start,
Label[] end,
int[] index,
String desc,
boolean visible)
Visits an annotation on a local variable type.
|
void |
visitLookupSwitchInsn(Label arg0,
int[] arg1,
Label[] arg2)
Visits a LOOKUPSWITCH instruction.
|
void |
visitMaxs(int arg0,
int arg1)
Visits the maximum stack size and the maximum number of local variables of the method.
|
void |
visitMethodInsn(int opcode,
String owner,
String name,
String desc)
Visits a method instruction.
|
void |
visitMethodInsn(int opcode,
String owner,
String name,
String desc,
boolean itf)
Visits a method instruction.
|
void |
visitMultiANewArrayInsn(String arg0,
int arg1)
Visits a MULTIANEWARRAY instruction.
|
void |
visitParameter(String name,
int access)
Visits a parameter of this method.
|
AnnotationVisitor |
visitParameterAnnotation(int arg0,
String arg1,
boolean arg2)
Visits an annotation of a parameter this method.
|
void |
visitTableSwitchInsn(int arg0,
int arg1,
Label arg2,
Label... arg3)
Visits a TABLESWITCH instruction.
|
AnnotationVisitor |
visitTryCatchAnnotation(int typeRef,
TypePath typePath,
String desc,
boolean visible)
Visits an annotation on an exception handler type.
|
void |
visitTryCatchBlock(Label arg0,
Label arg1,
Label arg2,
String arg3)
Visits a try catch block.
|
AnnotationVisitor |
visitTypeAnnotation(int typeRef,
TypePath typePath,
String desc,
boolean visible)
Visits an annotation on a type in the method signature.
|
void |
visitTypeInsn(int arg0,
String arg1)
Visits a type instruction.
|
void |
visitVarInsn(int arg0,
int arg1)
Visits a local variable instruction.
|
visitAnnotableParameterCount
protected ClassEnhancer enhancer
protected String methodName
protected String methodDescriptor
protected AbstractMemberMetaData mmd
protected MethodVisitor visitor
public EnhancerPropertyGetterAdapter(MethodVisitor mv, ClassEnhancer enhancer, String methodName, String methodDesc, AbstractMemberMetaData mmd, ClassVisitor cv)
mv
- MethodVisitorenhancer
- ClassEnhancer for the class with the methodmethodName
- Name of the methodmethodDesc
- Method descriptormmd
- MetaData for the propertycv
- ClassVisitorpublic void visitEnd()
visitEnd
in class MethodVisitor
public static void generateGetXXXMethod(MethodVisitor mv, AbstractMemberMetaData mmd, String asmClassName, String asmClassDesc, boolean detachListener, EnhancementNamer namer)
mv
- MethodVisitormmd
- MetaData for the propertyasmClassName
- ASM class name for the owning classasmClassDesc
- ASM descriptor for the owning classdetachListener
- true if the generate code must support DetachListenernamer
- Namer for methods etcpublic AnnotationVisitor visitAnnotation(String arg0, boolean arg1)
MethodVisitor
visitAnnotation
in class MethodVisitor
arg0
- the class descriptor of the annotation class.arg1
- true if the annotation is visible at runtime.public AnnotationVisitor visitAnnotationDefault()
MethodVisitor
visitAnnotationDefault
in class MethodVisitor
public void visitParameter(String name, int access)
MethodVisitor
visitParameter
in class MethodVisitor
name
- parameter name or null if none is provided.access
- the parameter's access flags, only ACC_FINAL, ACC_SYNTHETIC
or/and ACC_MANDATED are allowed (see Opcodes
).public AnnotationVisitor visitTypeAnnotation(int typeRef, TypePath typePath, String desc, boolean visible)
MethodVisitor
visitTypeAnnotation
in class MethodVisitor
typeRef
- a reference to the annotated type. The sort of this type reference must be
TypeReference.METHOD_TYPE_PARAMETER
, TypeReference.METHOD_TYPE_PARAMETER_BOUND
, TypeReference.METHOD_RETURN
, TypeReference.METHOD_RECEIVER
, TypeReference.METHOD_FORMAL_PARAMETER
or TypeReference.THROWS
. See TypeReference
.typePath
- the path to the annotated type argument, wildcard bound, array element type, or
static inner type within 'typeRef'. May be null if the annotation targets
'typeRef' as a whole.desc
- the class descriptor of the annotation class.visible
- true if the annotation is visible at runtime.public void visitMethodInsn(int opcode, String owner, String name, String desc, boolean itf)
MethodVisitor
visitMethodInsn
in class MethodVisitor
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 Type.getInternalName()
).name
- the method's name.desc
- the method's descriptor (see Type
).itf
- if the method's owner class is an interface.public void visitInvokeDynamicInsn(String name, String desc, Handle bsm, Object... bsmArgs)
MethodVisitor
visitInvokeDynamicInsn
in class MethodVisitor
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.public AnnotationVisitor visitInsnAnnotation(int typeRef, TypePath typePath, String desc, boolean visible)
MethodVisitor
visitInsnAnnotation
in class MethodVisitor
typeRef
- a reference to the annotated type. The sort of this type reference must be
TypeReference.INSTANCEOF
, TypeReference.NEW
, TypeReference.CONSTRUCTOR_REFERENCE
, TypeReference.METHOD_REFERENCE
, TypeReference.CAST
, TypeReference.CONSTRUCTOR_INVOCATION_TYPE_ARGUMENT
, TypeReference.METHOD_INVOCATION_TYPE_ARGUMENT
, TypeReference.CONSTRUCTOR_REFERENCE_TYPE_ARGUMENT
, or TypeReference.METHOD_REFERENCE_TYPE_ARGUMENT
. See TypeReference
.typePath
- the path to the annotated type argument, wildcard bound, array element type, or
static inner type within 'typeRef'. May be null if the annotation targets
'typeRef' as a whole.desc
- the class descriptor of the annotation class.visible
- true if the annotation is visible at runtime.public AnnotationVisitor visitTryCatchAnnotation(int typeRef, TypePath typePath, String desc, boolean visible)
MethodVisitor
MethodVisitor.visitTryCatchBlock(org.datanucleus.enhancer.asm.Label, org.datanucleus.enhancer.asm.Label, org.datanucleus.enhancer.asm.Label, java.lang.String)
for the annotated exception handler. It can be called several times
for the same exception handler.visitTryCatchAnnotation
in class MethodVisitor
typeRef
- a reference to the annotated type. The sort of this type reference must be
TypeReference.EXCEPTION_PARAMETER
. See TypeReference
.typePath
- the path to the annotated type argument, wildcard bound, array element type, or
static inner type within 'typeRef'. May be null if the annotation targets
'typeRef' as a whole.desc
- the class descriptor of the annotation class.visible
- true if the annotation is visible at runtime.public AnnotationVisitor visitLocalVariableAnnotation(int typeRef, TypePath typePath, Label[] start, Label[] end, int[] index, String desc, boolean visible)
MethodVisitor
visitLocalVariableAnnotation
in class MethodVisitor
typeRef
- a reference to the annotated type. The sort of this type reference must be
TypeReference.LOCAL_VARIABLE
or TypeReference.RESOURCE_VARIABLE
. See TypeReference
.typePath
- the path to the annotated type argument, wildcard bound, array element type, or
static inner type within 'typeRef'. May be null if the annotation targets
'typeRef' as a whole.start
- the fist instructions corresponding to the continuous ranges that make the scope
of this local variable (inclusive).end
- the last instructions corresponding to the continuous ranges that make the scope of
this local variable (exclusive). This array must have the same size as the 'start' array.index
- the local variable's index in each range. This array must have the same size as
the 'start' array.desc
- the class descriptor of the annotation class.visible
- true if the annotation is visible at runtime.public void visitAttribute(Attribute arg0)
MethodVisitor
visitAttribute
in class MethodVisitor
arg0
- an attribute.public void visitCode()
MethodVisitor
visitCode
in class MethodVisitor
public void visitFieldInsn(int opcode, String owner, String name, String desc)
MethodVisitor
visitFieldInsn
in class MethodVisitor
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 Type.getInternalName()
).name
- the field's name.desc
- the field's descriptor (see Type
).public void visitFrame(int arg0, int arg1, Object[] arg2, int arg3, Object[] arg4)
MethodVisitor
Opcodes.V1_6
. Opcodes.F_SAME
representing frame with exactly the same locals as the
previous frame and with the empty stack.
Opcodes.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).
Opcodes.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).
Opcodes.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).
Opcodes.F_FULL
representing complete frame data.
visitFrame
in class MethodVisitor
arg0
- the type of this stack map frame. Must be Opcodes.F_NEW
for expanded
frames, or Opcodes.F_FULL
, Opcodes.F_APPEND
, Opcodes.F_CHOP
, Opcodes.F_SAME
or Opcodes.F_APPEND
, Opcodes.F_SAME1
for compressed frames.arg1
- the number of local variables in the visited frame.arg2
- the local variable types in this frame. This array must not be modified. Primitive
types are represented by Opcodes.TOP
, Opcodes.INTEGER
, Opcodes.FLOAT
, Opcodes.LONG
, Opcodes.DOUBLE
, Opcodes.NULL
or
Opcodes.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).arg3
- the number of operand stack elements in the visited frame.arg4
- the operand stack types in this frame. This array must not be modified. Its
content has the same format as the "local" array.public void visitIincInsn(int arg0, int arg1)
MethodVisitor
visitIincInsn
in class MethodVisitor
arg0
- index of the local variable to be incremented.arg1
- amount to increment the local variable by.public void visitInsn(int opcode)
MethodVisitor
visitInsn
in class MethodVisitor
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.public void visitIntInsn(int arg0, int arg1)
MethodVisitor
visitIntInsn
in class MethodVisitor
arg0
- the opcode of the instruction to be visited. This opcode is either BIPUSH, SIPUSH
or NEWARRAY.arg1
- the operand of the instruction to be visited.Opcodes.T_BOOLEAN
, Opcodes.T_CHAR
, Opcodes.T_FLOAT
, Opcodes.T_DOUBLE
, Opcodes.T_BYTE
,
Opcodes.T_SHORT
, Opcodes.T_INT
or Opcodes.T_LONG
.public void visitJumpInsn(int arg0, Label arg1)
MethodVisitor
visitJumpInsn
in class MethodVisitor
arg0
- 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.arg1
- the operand of the instruction to be visited. This operand is a label that
designates the instruction to which the jump instruction may jump.public void visitLabel(Label arg0)
MethodVisitor
visitLabel
in class MethodVisitor
arg0
- a Label
object.public void visitLdcInsn(Object arg0)
MethodVisitor
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 }
visitLdcInsn
in class MethodVisitor
arg0
- 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.public void visitLineNumber(int arg0, Label arg1)
MethodVisitor
visitLineNumber
in class MethodVisitor
arg0
- a line number. This number refers to the source file from which the class was
compiled.arg1
- the first instruction corresponding to this line number.public void visitLocalVariable(String arg0, String arg1, String arg2, Label arg3, Label arg4, int arg5)
MethodVisitor
visitLocalVariable
in class MethodVisitor
arg0
- the name of a local variable.arg1
- the type descriptor of this local variable.arg2
- the type signature of this local variable. May be null if the local
variable type does not use generic types.arg3
- the first instruction corresponding to the scope of this local variable
(inclusive).arg4
- the last instruction corresponding to the scope of this local variable (exclusive).arg5
- the local variable's index.public void visitLookupSwitchInsn(Label arg0, int[] arg1, Label[] arg2)
MethodVisitor
visitLookupSwitchInsn
in class MethodVisitor
arg0
- beginning of the default handler block.arg1
- the values of the keys.arg2
- beginnings of the handler blocks. labels[i] is the beginning of the
handler block for the keys[i] key.public void visitMaxs(int arg0, int arg1)
MethodVisitor
visitMaxs
in class MethodVisitor
arg0
- maximum stack size of the method.arg1
- maximum number of local variables for the method.public void visitMethodInsn(int opcode, String owner, String name, String desc)
MethodVisitor
visitMethodInsn
in class MethodVisitor
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 Type.getInternalName()
).name
- the method's name.desc
- the method's descriptor (see Type
).public void visitMultiANewArrayInsn(String arg0, int arg1)
MethodVisitor
visitMultiANewArrayInsn
in class MethodVisitor
arg0
- an array type descriptor (see Type
).arg1
- the number of dimensions of the array to allocate.public AnnotationVisitor visitParameterAnnotation(int arg0, String arg1, boolean arg2)
MethodVisitor
visitParameterAnnotation
in class MethodVisitor
arg0
- the parameter index. This index must be strictly smaller than the number of
parameters in the method descriptor, and strictly smaller than the parameter count
specified in MethodVisitor.visitAnnotableParameterCount(int, boolean)
. Important note: a parameter index i
is not required to correspond to the i'th parameter descriptor in the method
descriptor, in particular in case of synthetic parameters (see
https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7.18).arg1
- the class descriptor of the annotation class.arg2
- true if the annotation is visible at runtime.public void visitTableSwitchInsn(int arg0, int arg1, Label arg2, Label... arg3)
MethodVisitor
visitTableSwitchInsn
in class MethodVisitor
arg0
- the minimum key value.arg1
- the maximum key value.arg2
- beginning of the default handler block.arg3
- beginnings of the handler blocks. labels[i] is the beginning of the
handler block for the min + i key.public void visitTryCatchBlock(Label arg0, Label arg1, Label arg2, String arg3)
MethodVisitor
visitTryCatchBlock
in class MethodVisitor
arg0
- the beginning of the exception handler's scope (inclusive).arg1
- the end of the exception handler's scope (exclusive).arg2
- the beginning of the exception handler's code.arg3
- the internal name of the type of exceptions handled by the handler, or
null to catch any exceptions (for "finally" blocks).public void visitTypeInsn(int arg0, String arg1)
MethodVisitor
visitTypeInsn
in class MethodVisitor
arg0
- the opcode of the type instruction to be visited. This opcode is either NEW,
ANEWARRAY, CHECKCAST or INSTANCEOF.arg1
- the operand of the instruction to be visited. This operand must be the internal
name of an object or array class (see Type.getInternalName()
).public void visitVarInsn(int arg0, int arg1)
MethodVisitor
visitVarInsn
in class MethodVisitor
arg0
- 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.arg1
- the operand of the instruction to be visited. This operand is the index of a local
variable.Copyright © 2019. All rights reserved.