gw.lang.reflect

Class DefaultArrayType

java.lang.Object

gw.lang.reflect.AbstractType

gw.lang.reflect.DefaultArrayType

All Implemented Interfaces:

IDefaultArrayType, IEnhanceableType, IHasJavaClass, IType, Serializable

Direct Known Subclasses:

DefaultNonLoadableArrayType

public class DefaultArrayType
extends AbstractType
implements IDefaultArrayType, IHasJavaClass

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static LocklessLazyVar<List<IJavaType>>	INTERFACES

Fields inherited from interface gw.lang.reflect.IType

EMPTY_ARRAY, EMPTY_TYPE_ARRAY, EMPTY_TYPE_LIST

Constructor Summary

Constructors

Constructor and Description
DefaultArrayType(IType componentType, IJavaClassInfo componentConcreteClass, ITypeLoader typeLoader)

Method Summary

Modifier and Type	Method and Description
Set	getAllTypesInHierarchy() Returns a Set of all IIntrinsicTypes that this class is assignable from, including this class.
Object	getArrayComponent(Object array, int iIndex) Returns the value of the indexed component in the specified array object.
int	getArrayLength(Object array) Returns the length of the specified array object.
IDefaultArrayType	getArrayType() Make an array type from this type.
Class	getBackingClass()
IType	getComponentType() If this is an array type, a type representing the component type of the array.
Set<IType>	getCompoundTypeComponents()
IJavaClassInfo	getConcreteClass()
String	getDisplayName() The display name of this intrinsic type.
IType	getEnclosingType() Returns the type immediately enclosing this type.
IType	getGenericType() If this is a parameterized type, returns the generic type this type parameterizes.
IGenericTypeVariable[]	getGenericTypeVariables() Returns an array of GenericTypeVariables declared with this Generic Type.
IType[]	getInterfaces()
int	getModifiers() Returns the modifiers for this type, encoded in an integer.
String	getName() The fully qualified name of this intrinsic type.
String	getNamespace() The namespace for this class.
IType	getParameterizedType(IType... ofType) Assuming this intrinsic type is a Generic type, return the parameterized type associated with the given list of type parameters.
String	getRelativeName() The relative or unqualified name.
IType	getSupertype() Returns the type representing the supertype of this type.
IDefaultArrayType	getThisRef()
ITypeInfo	getTypeInfo() Get the type information for this intrinsic type.
ITypeLoader	getTypeLoader() Returns the type loader responsible for loading this intrinsic type.
IType[]	getTypeParameters() If this is a parameterized type, returns the specific types used to create this type, null otherwies.
boolean	isAbstract()
boolean	isArray() True if this is an array.
boolean	isAssignableFrom(IType type) Determines if the type represented by this intrinsic type is either the same as, or is a super-type of the type represented by the specified type parameter.
boolean	isCompoundType()
boolean	isDiscarded() True if this type has been replaced with a newer version of the same name in the type system.
boolean	isEnum() Returns true if this type is an enumeration.
boolean	isFinal() True if this type cannot be extended.
boolean	isGenericType() Returns true if this ia a Generic Type.
boolean	isInterface() Returns true if this type is an interface.
boolean	isMutable() Are intances of this type mutable? Note sometimes it's difficult to determine.
boolean	isParameterizedType() Returns true if this ia a Parameterized Type.
boolean	isPrimitive() True if this type represents a primitive type e.g., Java int, char, etc.
boolean	isValid() Defines this type if it is not yet fully defined.
Object	makeArrayInstance(int iLength) Construct an array instance of specified length.
protected IDefaultArrayType	makeArrayType() Allows subclasses to return a more specific interfaces
Object	readResolve() IType requires this method be implemented to ensure IType instances can be centrally defined and cached.
void	setArrayComponent(Object array, int iIndex, Object value) Sets the value of the indexed component in the specified array object.
void	setDiscarded(boolean bDiscarded)
String	toString()
void	unloadTypeInfo() Unload or nullify any references to this IType's ITypeInfo.

Methods inherited from class gw.lang.reflect.AbstractType

getLiteralMetaType, getMetaType, getTheRef

Methods inherited from class java.lang.Object

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

Methods inherited from interface gw.lang.reflect.IType

getLiteralMetaType, getMetaType

Field Detail

INTERFACES

public static final LocklessLazyVar<List<IJavaType>> INTERFACES

Constructor Detail

DefaultArrayType

public DefaultArrayType(IType componentType,
                        IJavaClassInfo componentConcreteClass,
                        ITypeLoader typeLoader)

Method Detail

getComponentType

public final IType getComponentType()

Description copied from interface: IType

If this is an array type, a type representing the component type of the array. Otherwise null.

Specified by:

getComponentType in interface IType

getRelativeName

public final String getRelativeName()

Description copied from interface: IType

The relative or unqualified name. For a class this should be just the class name without the package name.

Specified by:

getRelativeName in interface IType

isArray

public final boolean isArray()

Description copied from interface: IType

True if this is an array.

Specified by:

isArray in interface IType

readResolve

public final Object readResolve()

Description copied from interface: IType

IType requires this method be implemented to ensure IType instances can be centrally defined and cached.

Specified by:

readResolve in interface IType

isValid

public final boolean isValid()

Description copied from interface: IType

Defines this type if it is not yet fully defined. For instance, if this type has source code associated with it, it must fully compile the source for it to be fully defined.

Specified by:

isValid in interface IType

Returns:

true if this type is valid.

getModifiers

public int getModifiers()

Description copied from interface: IType

Returns the modifiers for this type, encoded in an integer. The modifiers consist of the constants for public, protected, private, final, static, abstract they should be decoded using the methods of class Modifier.

Specified by:

getModifiers in interface IType

See Also:

Modifier

isAbstract

public final boolean isAbstract()

Specified by:

isAbstract in interface IType

getName

public final String getName()

Description copied from interface: IType

The fully qualified name of this intrinsic type.

Specified by:

getName in interface IType

getDisplayName

public final String getDisplayName()

Description copied from interface: IType

The display name of this intrinsic type. Often this is simply the same as IType.getName(), but in some cases a type may want to modify it's name for presentation to the user.

Specified by:

getDisplayName in interface IType

getNamespace

public final String getNamespace()

Description copied from interface: IType

The namespace for this class. For a java class this will be the package, while for other types of intrinsic types it could be another logical name.

Specified by:

getNamespace in interface IType

getTypeLoader

public final ITypeLoader getTypeLoader()

Description copied from interface: IType

Returns the type loader responsible for loading this intrinsic type.

Specified by:

getTypeLoader in interface IType

getSupertype

public final IType getSupertype()

Description copied from interface: IType

Returns the type representing the supertype of this type. Returns null if this type has no supertype.

Specified by:

getSupertype in interface IType

getEnclosingType

public final IType getEnclosingType()

Description copied from interface: IType

Returns the type immediately enclosing this type. If this type is not enclosed, returns null.

Specified by:

getEnclosingType in interface IType

getGenericType

public final IType getGenericType()

Description copied from interface: IType

If this is a parameterized type, returns the generic type this type parameterizes. Otherwise, returns null.

Specified by:

getGenericType in interface IType

isFinal

public final boolean isFinal()

Description copied from interface: IType

True if this type cannot be extended.

Specified by:

isFinal in interface IType

isInterface

public final boolean isInterface()

Description copied from interface: IType

Returns true if this type is an interface.

Specified by:

isInterface in interface IType

isEnum

public boolean isEnum()

Description copied from interface: IType

Returns true if this type is an enumeration.

Specified by:

isEnum in interface IType

getInterfaces

public final IType[] getInterfaces()

Specified by:

getInterfaces in interface IType

Returns:

If this is a class, returns a list of all the interfaces this type implements. Similarly, if this is an interface, returns a list of all the interfaces this type extends. In any case, returns an empty list if this type neither implements nor extends interfaces.

isParameterizedType

public final boolean isParameterizedType()

Description copied from interface: IType

Returns true if this ia a Parameterized Type.

Note a Parameterzied Type is not the same as a Generic Type. The difference is that a Parameterized Type is a concrete version of a Generic Type. For instance, the class ArrayList is a Generic Type, while the class ArrayList is a Parameterized Type of the the Generic Type ArrayList.

Specified by:

isParameterizedType in interface IType

isGenericType

public final boolean isGenericType()

Description copied from interface: IType

Returns true if this ia a Generic Type.

Specified by:

isGenericType in interface IType

See Also:

IType.isParameterizedType()

getGenericTypeVariables

public final IGenericTypeVariable[] getGenericTypeVariables()

Description copied from interface: IType

Returns an array of GenericTypeVariables declared with this Generic Type. Otherwise, returns null if this is not a Generic Type.

Specified by:

getGenericTypeVariables in interface IType

getTypeParameters

public final IType[] getTypeParameters()

Description copied from interface: IType

If this is a parameterized type, returns the specific types used to create this type, null otherwies.

Specified by:

getTypeParameters in interface IType

getParameterizedType

public final IType getParameterizedType(IType... ofType)

Description copied from interface: IType

Assuming this intrinsic type is a Generic type, return the parameterized type associated with the given list of type parameters. If the type has not been created yet, creates the parameterized type. Successive calls to this method having identical parameter types must return the identical parameterized type.

Specified by:

getParameterizedType in interface IType

Parameters:

ofType - The type parameters.

Returns:

The concrete type associated with the type parameters.

getAllTypesInHierarchy

public final Set getAllTypesInHierarchy()

Description copied from interface: IType

Returns a Set of all IIntrinsicTypes that this class is assignable from, including this class. This includes implemented interfaces and superclasses, recursively up the hieararchy. For array types, this will be a Set of all types that its component type is assignable from.

Specified by:

getAllTypesInHierarchy in interface IType

isPrimitive

public final boolean isPrimitive()

Description copied from interface: IType

True if this type represents a primitive type e.g., Java int, char, etc.

Specified by:

isPrimitive in interface IType

getArrayType

public final IDefaultArrayType getArrayType()

Description copied from interface: IType

Make an array type from this type. E.g., String -> String[]

Specified by:

getArrayType in interface IType

makeArrayType

protected IDefaultArrayType makeArrayType()

Allows subclasses to return a more specific interfaces

makeArrayInstance

public Object makeArrayInstance(int iLength)

Description copied from interface: IType

Construct an array instance of specified length.

Specified by:

makeArrayInstance in interface IType

getConcreteClass

public IJavaClassInfo getConcreteClass()

Specified by:

getConcreteClass in interface IDefaultArrayType

getArrayComponent

public Object getArrayComponent(Object array,
                                int iIndex)
                         throws IllegalArgumentException,
                                ArrayIndexOutOfBoundsException

Description copied from interface: IType

Returns the value of the indexed component in the specified array object.

Specified by:

getArrayComponent in interface IType

Parameters:

array - An array instance of this intrinsic type.

iIndex - The index of the component to get.

Returns:

The value of the indexed component in the specified array.

Throws:

IllegalArgumentException - If the specified object is not an array.

ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array

setArrayComponent

public void setArrayComponent(Object array,
                              int iIndex,
                              Object value)
                       throws IllegalArgumentException,
                              ArrayIndexOutOfBoundsException

Description copied from interface: IType

Sets the value of the indexed component in the specified array object.

Specified by:

setArrayComponent in interface IType

Parameters:

array - An array instance of this intrinsic type.

iIndex - The index of the component to set.

value - The new value of the indexed component.

Throws:

IllegalArgumentException - If the specified object is not an array.

ArrayIndexOutOfBoundsException - If the specified index argument is negative, or if it is greater than or equal to the length of the specified array

getArrayLength

public int getArrayLength(Object array)
                   throws IllegalArgumentException

Description copied from interface: IType

Returns the length of the specified array object.

Specified by:

getArrayLength in interface IType

Parameters:

array - An array instance of this intrinsic type.

Returns:

The length of the array.

Throws:

IllegalArgumentException - If the object argument is not an array.

isAssignableFrom

public boolean isAssignableFrom(IType type)

Description copied from interface: IType

Determines if the type represented by this intrinsic type is either the same as, or is a super-type of the type represented by the specified type parameter.

Specified by:

isAssignableFrom in interface IType

isMutable

public boolean isMutable()

Description copied from interface: IType

Are intances of this type mutable? Note sometimes it's difficult to determine. For instance, java classes don't contain any information about mutability. In which case we always assume mutable, even when the underlying type may in fact be immutable. E.g., even though java.lang.String is not mutable, its corresponding JavaIntrinsicType will say it is.

Specified by:

isMutable in interface IType

Returns:

True if this type is mutable.

getTypeInfo

public final ITypeInfo getTypeInfo()

Description copied from interface: IType

Get the type information for this intrinsic type.

Specified by:

getTypeInfo in interface IType

See Also:

ITypeInfo

unloadTypeInfo

public final void unloadTypeInfo()

Description copied from interface: IType

Unload or nullify any references to this IType's ITypeInfo.

Specified by:

unloadTypeInfo in interface IType

toString

public String toString()

Overrides:

toString in class Object

getThisRef

public IDefaultArrayType getThisRef()

isDiscarded

public boolean isDiscarded()

Description copied from interface: IType

True if this type has been replaced with a newer version of the same name in the type system.

Specified by:

isDiscarded in interface IType

setDiscarded

public void setDiscarded(boolean bDiscarded)

Specified by:

setDiscarded in interface IType

isCompoundType

public boolean isCompoundType()

Specified by:

isCompoundType in interface IType

getCompoundTypeComponents

public Set<IType> getCompoundTypeComponents()

Specified by:

getCompoundTypeComponents in interface IType

getBackingClass

public Class getBackingClass()

Specified by:

getBackingClass in interface IHasJavaClass