gnu.bytecode

Class ObjectType

Known Direct Subclasses:
ArrayType, ClassType, NodeType, OccurrenceType

public class ObjectType
extends Type

Semi-abstract class object reference types.

Extended by ClassType and ArrayType.

Field Summary

int
flags

Fields inherited from class gnu.bytecode.Type

booleanValue_method, boolean_ctype, boolean_type, byte_type, char_type, doubleValue_method, double_type, floatValue_method, float_type, intValue_method, int_type, java_lang_Class_type, longValue_method, long_type, neverReturnsType, nullType, number_type, pointer_type, reflectClass, short_type, string_type, throwable_type, toString_method, tostring_type, typeArray0, void_type

Constructor Summary

ObjectType()
ObjectType(String name)

Method Summary

Object
coerceFromObject(Object obj)
Convert an object to a value of this Type.
int
compare(Type other)
Return a numeric code showing "subtype" relationship: 1: if other is a pure subtype of this; 0: if has the same values; -1: if this is a pure subtype of other; -2: if they have values in common but neither is a subtype of the other; -3: if the types have no values in common.
void
emitCoerceFromObject(CodeAttr code)
Compile (in given method) cast from Object to this Type.
Type
getImplementationType()
The type used to implement types not natively understood by the JVM.
String
getInternalName()
Returns class name if a class type, signature if an array type.
Class
getReflectClass()
Get the java.lang.Class object for the representation type.
boolean
isExisting()
Type
promote()
void
setExisting(boolean existing)

Methods inherited from class gnu.bytecode.Type

coerceFromObject, coerceToObject, compare, emitCoerceFromObject, emitCoerceToObject, emitIsInstance, getImplementationType, getName, getReflectClass, getSignature, getSize, getType, hashCode, isInstance, isMoreSpecific, isSubtype, isValidJavaTypeName, isVoid, lookupType, lowestCommonSuperType, make, promote, registerTypeForClass, setName, setReflectClass, setSignature, signatureLength, signatureLength, signatureToName, signatureToPrimitive, signatureToType, signatureToType, swappedCompareResult, toString

Field Details

flags

public int flags

Constructor Details

ObjectType

protected ObjectType()

ObjectType

public ObjectType(String name)

Method Details

coerceFromObject

public Object coerceFromObject(Object obj)
Convert an object to a value of this Type. Throw a ClassCastException when this is not possible.
Overrides:
coerceFromObject in interface Type

compare

public int compare(Type other)
Return a numeric code showing "subtype" relationship: 1: if other is a pure subtype of this; 0: if has the same values; -1: if this is a pure subtype of other; -2: if they have values in common but neither is a subtype of the other; -3: if the types have no values in common. "Same member" is rather loose; by "A is a subtype of B" we mean that all instance of A can be "widened" to B. More formally, A.compare(B) returns: 1: all B values can be converted to A without a coercion failure (i.e. a ClassCastException or overflow or major loss of information), but not vice versa. 0: all A values can be converted to B without a coercion failure and vice versa; -1: all A values can be converted to B without a coercion failure not not vice versa; -2: there are (potentially) some A values that can be converted to B, and some B values can be converted to A; -3: there are no A values that can be converted to B, and neither are there any B values that can be converted to A.
Overrides:
compare in interface Type

emitCoerceFromObject

public void emitCoerceFromObject(CodeAttr code)
Compile (in given method) cast from Object to this Type.
Overrides:
emitCoerceFromObject in interface Type

getImplementationType

public Type getImplementationType()
The type used to implement types not natively understood by the JVM. Usually, the identity function. However, a language might handle union types or template types or type expressions calculated at run time. In that case return the type used at the JVM level, and known at compile time.
Overrides:
getImplementationType in interface Type

getInternalName

public String getInternalName()
Returns class name if a class type, signature if an array type. In both cases, uses '/' rather than '.' after packages prefixes. Seems rather arbitrary - but that is how classes are represented in the constant pool (CONSTANT_Class constants). Also, Class.forName is the same, except using '.'.

getReflectClass

public Class getReflectClass()
Get the java.lang.Class object for the representation type.
Overrides:
getReflectClass in interface Type

isExisting

public final boolean isExisting()

promote

public Type promote()
Overrides:
promote in interface Type

setExisting

public final void setExisting(boolean existing)