gnu.bytecode

Class ArrayType

java.lang.Object

gnu.bytecode.Type

gnu.bytecode.ObjectType

gnu.bytecode.ArrayType

All Implemented Interfaces:

java.io.Externalizable, java.io.Serializable, java.lang.reflect.Type

public class ArrayType
extends ObjectType
implements java.io.Externalizable

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class gnu.bytecode.Type

Type.NeverReturns

Field Summary

Fields

Modifier and Type	Field and Description
Type	elements

Fields inherited from class gnu.bytecode.ObjectType

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, errorType, float_type, floatType, floatValue_method, int_type, intType, intValue_method, java_lang_Class_type, javalangannotationAnnotationType, javalangBooleanType, javalangCharacterType, javalangClassType, javalanginvokeMethodHandleType, 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

Constructors

Constructor and Description
ArrayType(Type elements)

Method Summary

Modifier and Type	Method and Description
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.
Type	getComponentType()
Type	getImplementationType() Return Java-level implementation type.
ClassType[]	getInterfaces()
java.lang.String	getInternalName() Returns class name if a class type, signature if an array type.
int	getMethods(Filter filter, int searchSupers, java.util.List<Method> result)
Type	getRawType() Return JVM-level implementation type.
java.lang.Class	getReflectClass() Get the java.lang.Class object for the representation type.
java.lang.String	getSignature()
ClassType	getSuperclass()
int	isCompatibleWithValue(Type valueType) If this is the target type, is a given source type compatible?
static ArrayType	make(Type elements) Find or create an ArrayType for the specified element type.
void	readExternal(java.io.ObjectInput in)
java.lang.Object	readResolve()
void	writeExternal(java.io.ObjectOutput out)

Methods inherited from class gnu.bytecode.ObjectType

coerceFromObject, emitCoerceFromObject, getContextClass, getContextClassLoader, getField, getMethod, getMethods, isExisting, isInstance, setExisting

Methods inherited from class gnu.bytecode.Type

coerceToObject, emitCoerceToObject, emitConvertFromPrimitive, emitIsInstance, getGenericSignature, getMaybeGenericSignature, getName, getRealType, getSize, getSizeInWords, getType, hashCode, isCompatibleWithValue, isInterface, isMoreSpecific, isSame, isSubtype, isValidJavaTypeName, isVoid, lookupType, lowestCommonSharedType, lowestCommonSuperType, make, make, printSignature, promote, promoteIfUnsigned, registerTypeForClass, setGenericSignature, 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

Methods inherited from interface java.lang.reflect.Type

getTypeName

Field Detail

elements

public Type elements

Constructor Detail

ArrayType

public ArrayType(Type elements)

Method Detail

getSignature

public java.lang.String getSignature()

Overrides:

getSignature in class Type

getImplementationType

public Type getImplementationType()

Description copied from class: Type

Return Java-level implementation type. The type used to implement types not natively understood by the JVM or the Java language. 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 Java level, and known at compile time.

Overrides:

getImplementationType in class Type

getRawType

public Type getRawType()

Description copied from class: Type

Return JVM-level implementation type.

Overrides:

getRawType in class Type

make

public static ArrayType make(Type elements)

Find or create an ArrayType for the specified element type.

getComponentType

public Type getComponentType()

getInternalName

public java.lang.String getInternalName()

Description copied from class: ObjectType

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 '.'.

Overrides:

getInternalName in class ObjectType

getSuperclass

public ClassType getSuperclass()

Overrides:

getSuperclass in class ObjectType

getInterfaces

public ClassType[] getInterfaces()

Overrides:

getInterfaces in class ObjectType

getReflectClass

public java.lang.Class getReflectClass()

Description copied from class: ObjectType

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

Overrides:

getReflectClass in class ObjectType

getMethods

public int getMethods(Filter filter,
                      int searchSupers,
                      java.util.List<Method> result)

Overrides:

getMethods in class ObjectType

isCompatibleWithValue

public int isCompatibleWithValue(Type valueType)

Description copied from class: Type

If this is the target type, is a given source type compatible?

Overrides:

isCompatibleWithValue in class Type

Returns:

-1 if not compatible; 0 if need to check at run-time; 1 if compatible; 2 if compatible and no conversion or cast needed. We also return 0 for some "narrowing" conversions even if we know they will always succeed, so as to make such conversions less preferred when doing method overloading.

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 values" 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 but 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 class ObjectType

writeExternal

public void writeExternal(java.io.ObjectOutput out)
                   throws java.io.IOException

Specified by:

writeExternal in interface java.io.Externalizable

Throws:

java.io.IOException

readExternal

public void readExternal(java.io.ObjectInput in)
                  throws java.io.IOException,
                         java.lang.ClassNotFoundException

Specified by:

readExternal in interface java.io.Externalizable

Throws:

java.io.IOException

java.lang.ClassNotFoundException

readResolve

public java.lang.Object readResolve()
                             throws java.io.ObjectStreamException

Throws:

java.io.ObjectStreamException