gnu.bytecode
Class ObjectType

java.lang.Object
  gnu.bytecode.Type
      gnu.bytecode.ObjectType

All Implemented Interfaces:

java.lang.reflect.Type

Direct Known Subclasses:

ArrayType, ClassType, LangObjType, NodeType, OccurrenceType, SingletonType

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

boolean_ctype, boolean_type, booleanType, booleanValue_method, byte_type, byteType, char_type, charType, clone_method, double_type, doubleType, doubleValue_method, float_type, floatType, floatValue_method, int_type, intType, intValue_method, java_lang_Class_type, javalangBooleanType, javalangClassType, javalangNumberType, javalangObjectType, javalangStringType, javalangThrowableType, long_type, longType, longValue_method, neverReturnsType, nullType, number_type, objectType, pointer_type, reflectClass, short_type, shortType, string_type, throwable_type, toString_method, tostring_type, toStringType, typeArray0, void_type, voidType

Constructor Summary

protected	ObjectType()
	ObjectType(java.lang.String name)

Method Summary

java.lang.Object	coerceFromObject(java.lang.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.
static java.lang.Class	getContextClass(java.lang.String cname) Get named class using context class loader.
Field	getField(java.lang.String name, int mask)
Type	getImplementationType() The type used to implement types not natively understood by the JVM.
java.lang.String	getInternalName() Returns class name if a class type, signature if an array type.
Method	getMethod(java.lang.String name, Type[] arg_types)
int	getMethods(Filter filter, int searchSupers, java.util.Vector result, java.lang.String context)
java.lang.Class	getReflectClass() Get the java.lang.Class object for the representation type.
boolean	isExisting()
boolean	isInstance(java.lang.Object obj)
Type	promote()
void	setExisting(boolean existing)

Methods inherited from class gnu.bytecode.Type

coerceToObject, emitCoerceToObject, emitIsInstance, getName, getSignature, getSize, getSizeInWords, getType, hashCode, isMoreSpecific, isSubtype, isValidJavaTypeName, isVoid, lookupType, lowestCommonSuperType, make, printSignature, registerTypeForClass, setName, setReflectClass, setSignature, signatureLength, signatureLength, signatureToName, signatureToPrimitive, signatureToType, signatureToType, swappedCompareResult, toString

Methods inherited from class java.lang.Object

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

Field Detail

flags

public int flags

Constructor Detail

ObjectType

protected ObjectType()

ObjectType

public ObjectType(java.lang.String name)

Method Detail

isExisting

public final boolean isExisting()

setExisting

public final void setExisting(boolean existing)

getInternalName

public java.lang.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 '.'.

getContextClass

public static java.lang.Class getContextClass(java.lang.String cname)
                                       throws java.lang.ClassNotFoundException

Get named class using context class loader. If the security policy prohibits that, fall back to this class's loader.

Throws:

java.lang.ClassNotFoundException

getReflectClass

public java.lang.Class getReflectClass()

Get the java.lang.Class object for the representation type.

Overrides:

getReflectClass in class Type

getImplementationType

public Type getImplementationType()

Description copied from class: Type

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 class Type

promote

public Type promote()

Overrides:

promote in class Type

isInstance

public boolean isInstance(java.lang.Object obj)

Overrides:

isInstance in class Type

getField

public Field getField(java.lang.String name,
                      int mask)

getMethod

public Method getMethod(java.lang.String name,
                        Type[] arg_types)

getMethods

public int getMethods(Filter filter,
                      int searchSupers,
                      java.util.Vector result,
                      java.lang.String context)

compare

public int compare(Type other)

Description copied from class: Type

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.

Specified by:

compare in class Type

coerceFromObject

public java.lang.Object coerceFromObject(java.lang.Object obj)

Description copied from class: Type

Convert an object to a value of this Type. Throw a ClassCastException when this is not possible.

Specified by:

coerceFromObject in class Type

emitCoerceFromObject

public void emitCoerceFromObject(CodeAttr code)

Compile (in given method) cast from Object to this Type.

Overrides:

emitCoerceFromObject in class Type