com.goldencode.proxy

Class PrimitiveInfo

java.lang.Object

com.goldencode.proxy.ClassInfo

com.goldencode.proxy.PrimitiveInfo

All Implemented Interfaces:

TypeInfo, org.objectweb.asm.Opcodes

final class PrimitiveInfo
extends ClassInfo

Type information specific to a primitive data type. This differs from the type information for a class in that primitives each have a corresponding object wrapper type (e.g., boolean has java/lang/Boolean). Information about the wrapper type is recorded in this class to allow auto-boxing code to be assembled, which enables, for instance:

• a primitive to be wrapped before being passed as an argument to InvocationHandler.invoke;
• the Object return value from InvocationHandler.invoke to be cast into the appropriate object wrapper type, and then unwrapped to the corresponding primitive value.

Author:

ECF

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	castName Internal class name (of wrapper) used with CHECKCAST instruction
private java.lang.String	descriptor Internal data type descriptor
private int	loadInsn Load instruction
private int	returnInsn Return instruction
private MethodInfo	unwrapInfo Information for unwrapper method
private int	width Width of data type in stack or local variable slots
private MethodInfo	wrapInfo Information for wrapper method

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_MANDATED, ACC_MODULE, ACC_NATIVE, ACC_OPEN, ACC_PRIVATE, ACC_PROTECTED, ACC_PUBLIC, ACC_RECORD, ACC_STATIC, ACC_STATIC_PHASE, ACC_STRICT, ACC_SUPER, ACC_SYNCHRONIZED, ACC_SYNTHETIC, ACC_TRANSIENT, ACC_TRANSITIVE, ACC_VARARGS, ACC_VOLATILE, ACONST_NULL, ALOAD, ANEWARRAY, ARETURN, ARRAYLENGTH, ASM10_EXPERIMENTAL, ASM4, ASM5, ASM6, ASM7, ASM8, ASM9, ASTORE, ATHROW, BALOAD, BASTORE, BIPUSH, CALOAD, CASTORE, CHECKCAST, D2F, D2I, D2L, DADD, DALOAD, DASTORE, DCMPG, DCMPL, DCONST_0, DCONST_1, DDIV, DLOAD, DMUL, DNEG, DOUBLE, DREM, DRETURN, DSTORE, DSUB, DUP, DUP_X1, DUP_X2, DUP2, DUP2_X1, DUP2_X2, F_APPEND, F_CHOP, F_FULL, F_NEW, F_SAME, F_SAME1, F2D, F2I, F2L, FADD, FALOAD, FASTORE, FCMPG, FCMPL, FCONST_0, FCONST_1, FCONST_2, FDIV, FLOAD, FLOAT, FMUL, FNEG, FREM, FRETURN, FSTORE, FSUB, GETFIELD, GETSTATIC, GOTO, H_GETFIELD, H_GETSTATIC, H_INVOKEINTERFACE, H_INVOKESPECIAL, H_INVOKESTATIC, H_INVOKEVIRTUAL, H_NEWINVOKESPECIAL, H_PUTFIELD, H_PUTSTATIC, 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, INTEGER, INVOKEDYNAMIC, 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, LONG, LOOKUPSWITCH, LOR, LREM, LRETURN, LSHL, LSHR, LSTORE, LSUB, LUSHR, LXOR, MONITORENTER, MONITOREXIT, MULTIANEWARRAY, NEW, NEWARRAY, NOP, NULL, POP, POP2, PUTFIELD, PUTSTATIC, RET, RETURN, SALOAD, SASTORE, SIPUSH, SOURCE_DEPRECATED, SOURCE_MASK, SWAP, T_BOOLEAN, T_BYTE, T_CHAR, T_DOUBLE, T_FLOAT, T_INT, T_LONG, T_SHORT, TABLESWITCH, TOP, UNINITIALIZED_THIS, V_PREVIEW, V1_1, V1_2, V1_3, V1_4, V1_5, V1_6, V1_7, V1_8, V10, V11, V12, V13, V14, V15, V16, V17, V18, V19, V20, V21, V22, V9

Constructor Summary

Constructors

Constructor and Description
PrimitiveInfo(java.lang.Class<?> type, java.lang.Class<?> wrapper, java.lang.String descriptor, int width, int loadInsn, int returnInsn) Constructor.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getCastName() Get the internal name of the class which should be used with a CHECKCAST instruction when casting an Object returned from a call to InvocationHandler.invoke to an instance of this data type.
java.lang.String	getDescriptor() Get the descriptor which is used internally within the JVM to represent this data type.
int	getLoadInsn() Get the ASM constant representing the instruction used to load an instance of this data type from a local variable and push it onto the operand stack (e.g., DLOAD, ILOAD, etc.).
int	getReturnInsn() Get the ASM constant representing the instruction used to pop an instance of this data type from the operand stack and return it from a method (e.g., DRETURN, IRETURN, etc.).
MethodInfo	getUnwrapInfo() Get information for the method, if any, used to unwrap instances of this data type from a J2SE data wrapper object.
int	getWidth() Get the width, in stack or local variable slots for instances of this data type, when compiling bytecode instructions which manipulate such data.
MethodInfo	getWrapInfo() Get information for the method, if any, used to wrap instances of this data type in a J2SE data wrapper object.
private static MethodInfo	makeUnwrapInfo(java.lang.String typeName, TypeInfo wrapperInfo, java.lang.String typeDescriptor) Generate the information for the data unwrapper method, given the primitive type name, wrapper type information, and primitive type descriptor.
private static MethodInfo	makeWrapInfo(TypeInfo wrapperInfo, java.lang.String typeDescriptor) Generate the information for the data wrapper method, given the wrapper type information and the primitive type descriptor.

Methods inherited from class com.goldencode.proxy.ClassInfo

getType

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

castName

private final java.lang.String castName

Internal class name (of wrapper) used with CHECKCAST instruction

descriptor

private final java.lang.String descriptor

Internal data type descriptor

wrapInfo

private final MethodInfo wrapInfo

Information for wrapper method

unwrapInfo

private final MethodInfo unwrapInfo

Information for unwrapper method

width

private final int width

Width of data type in stack or local variable slots

loadInsn

private final int loadInsn

Load instruction

returnInsn

private final int returnInsn

Return instruction

Constructor Detail

PrimitiveInfo

PrimitiveInfo(java.lang.Class<?> type,
              java.lang.Class<?> wrapper,
              java.lang.String descriptor,
              int width,
              int loadInsn,
              int returnInsn)

Constructor.

Parameters:

type - Class representing primitive data type.

wrapper - Class representing J2SE object wrapper data type.

descriptor - Internal data type descriptor.

width - Width of data type in stack or local variable slots.

loadInsn - Load instruction.

returnInsn - Return instruction.

Method Detail

makeWrapInfo

private static MethodInfo makeWrapInfo(TypeInfo wrapperInfo,
                                       java.lang.String typeDescriptor)

Generate the information for the data wrapper method, given the wrapper type information and the primitive type descriptor.

Parameters:

wrapperInfo - Type information for object wrapper.

typeDescriptor - Internal type descriptor of primitive data type.

Returns:

Method information for the data wrapper method.

makeUnwrapInfo

private static MethodInfo makeUnwrapInfo(java.lang.String typeName,
                                         TypeInfo wrapperInfo,
                                         java.lang.String typeDescriptor)

Generate the information for the data unwrapper method, given the primitive type name, wrapper type information, and primitive type descriptor.

Parameters:

typeName - External name of primitive data type (e.g., "boolean").

wrapperInfo - Type information for object wrapper.

typeDescriptor - Internal type descriptor of primitive data type.

Returns:

Method information for the data unwrapper method.

getDescriptor

public java.lang.String getDescriptor()

Get the descriptor which is used internally within the JVM to represent this data type.

Specified by:

getDescriptor in interface TypeInfo

Overrides:

getDescriptor in class ClassInfo

Returns:

Type descriptor.

getCastName

public java.lang.String getCastName()

Get the internal name of the class which should be used with a CHECKCAST instruction when casting an Object returned from a call to InvocationHandler.invoke to an instance of this data type.

For primitive data types, this is the internal name of the wrapper data type (e.g., "java/lang/Boolean").

Specified by:

getCastName in interface TypeInfo

Overrides:

getCastName in class ClassInfo

Returns:

Internal class name for CHECKCAST instruction, or null for the void return type.

getWrapInfo

public MethodInfo getWrapInfo()

Get information for the method, if any, used to wrap instances of this data type in a J2SE data wrapper object. Note that this only applies to primitive data types.

Specified by:

getWrapInfo in interface TypeInfo

Overrides:

getWrapInfo in class ClassInfo

Returns:

Method information for the wrapper method invoked to wrap an instance of this data type in an object, or null for the void data type.

getUnwrapInfo

public MethodInfo getUnwrapInfo()

Get information for the method, if any, used to unwrap instances of this data type from a J2SE data wrapper object. Note that this only applies to primitive data types.

Specified by:

getUnwrapInfo in interface TypeInfo

Overrides:

getUnwrapInfo in class ClassInfo

Returns:

Method information for the unwrapper method invoked to unwrap an instance of this data type from an object, or null for the void data type.

getWidth

public int getWidth()

Get the width, in stack or local variable slots for instances of this data type, when compiling bytecode instructions which manipulate such data. This will be 2 for long and double types, and 1 for all others.

Specified by:

getWidth in interface TypeInfo

Overrides:

getWidth in class ClassInfo

Returns:

Width of this data type in slots.

getLoadInsn

public int getLoadInsn()

Get the ASM constant representing the instruction used to load an instance of this data type from a local variable and push it onto the operand stack (e.g., DLOAD, ILOAD, etc.).

Specified by:

getLoadInsn in interface TypeInfo

Overrides:

getLoadInsn in class ClassInfo

Returns:

Load instruction for this data type.

getReturnInsn

public int getReturnInsn()

Get the ASM constant representing the instruction used to pop an instance of this data type from the operand stack and return it from a method (e.g., DRETURN, IRETURN, etc.).

Note: the RETURN instruction (used for return type void) does not pop an operand off the stack; it simply returns.

Specified by:

getReturnInsn in interface TypeInfo

Overrides:

getReturnInsn in class ClassInfo

Returns:

Return instruction for this data type.