Package gw.internal.gosu.parser

Class GosuPropertyInfo

java.lang.Object

gw.lang.reflect.BaseFeatureInfo

gw.internal.gosu.parser.GosuBaseAttributedFeatureInfo

gw.internal.gosu.parser.GosuPropertyInfo

All Implemented Interfaces:

IGosuPropertyInfo, IAnnotatedFeatureInfo, IAttributedFeatureInfo, IFeatureInfo, IGenericMethodInfo, IIntrinsicTypeReference, IMethodBackedPropertyInfo, IPropertyInfo

Direct Known Subclasses:

ParameterizedGosuPropertyInfo

public class GosuPropertyInfo
extends GosuBaseAttributedFeatureInfo
implements IGosuPropertyInfo

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private class	GosuPropertyInfo.GosuPropertyAccessor
private class	GosuPropertyInfo.ReflectivePropertyAccessor

Nested classes/interfaces inherited from interface gw.lang.reflect.IAnnotatedFeatureInfo

IAnnotatedFeatureInfo.IAnnotationInfoHelper

Nested classes/interfaces inherited from interface gw.lang.reflect.IAttributedFeatureInfo

IAttributedFeatureInfo.MODIFIER

Field Summary

Fields

Modifier and Type	Field	Description
private IPropertyAccessor	_accessor
private IType	_assignableType
private boolean	_bReadable
private ReducedDynamicPropertySymbol	_dps
private IType	_type

Fields inherited from class gw.internal.gosu.parser.GosuBaseAttributedFeatureInfo

_declaredAnnotations

Fields inherited from interface gw.lang.reflect.IAnnotatedFeatureInfo

ANNOTATION_HELPER

Constructor Summary

Constructors

Constructor	Description
GosuPropertyInfo(IFeatureInfo container, DynamicPropertySymbol dps)

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object o)
IPropertyAccessor	getAccessor()
IType	getAssignableFeatureType()	The type this feature can be assigned from.
IType	getContainingType()
String	getDescription()	A full description of this feature.
String	getDisplayName()	Gets the display name of this feature.
ReducedDynamicPropertySymbol	getDps()
IType	getFeatureType()	The type of this feature e.g., for a property this is the property's type.
protected List<IGosuAnnotation>	getGosuAnnotations()
(package private) IGosuClassInternal	getGosuClass()
String	getName()	Gets the programmatic name or identifier of this feature.
IType[]	getParameterizedParameterTypes(IType... typeParams)
IType[]	getParameterizedParameterTypes2(IType ownersType, IType... typeParams)
IType	getParameterizedReturnType(IType... typeParams)
IPresentationInfo	getPresentationInfo()
IMethodInfo	getReadMethodInfo()
String	getShortDescription()
GenericTypeVariable[]	getTypeVariables()
IMethodInfo	getWriteMethodInfo()
int	hashCode()
TypeVarToTypeMap	inferTypeParametersFromArgumentTypes(IType... argTypes)
TypeVarToTypeMap	inferTypeParametersFromArgumentTypes2(IType owningParameterizedType, IType... argTypes)
boolean	isAbstract()
boolean	isAccessible(IType whosAskin, ReducedDynamicFunctionSymbol accessor)
private boolean	isDefault(ReducedDynamicFunctionSymbol dfs)
boolean	isFinal()
boolean	isGetterDefault()
boolean	isInternal()	True if this feature is internal.
boolean	isPrivate()	True if this feature is private.
boolean	isProtected()	True if this feature is protected.
boolean	isPublic()	True if this feature is public.
boolean	isReadable()
boolean	isReadable(IType whosAskin)
boolean	isReified()
boolean	isSetterDefault()
boolean	isStatic()	True if this feature is static, meaning the feature is not specific to a particular instance of the feature's containing type.
boolean	isWritable()
boolean	isWritable(IType whosAskin)
String	toString()

Methods inherited from class gw.internal.gosu.parser.GosuBaseAttributedFeatureInfo

getActualTypeInContainer, getDeclaredAnnotations, getDeprecatedReason, getOwnersType, isDeprecated, isHidden, isVisible

Methods inherited from class gw.lang.reflect.BaseFeatureInfo

getAnnotation, getAnnotations, getAnnotationsOfType, getContainer, getParamTypes, getSuperAnnotatedElements, hasAnnotation, hasDeclaredAnnotation, isDefaultImpl, isInternalAPI, isScriptable

Methods inherited from class java.lang.Object

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

Methods inherited from interface gw.lang.reflect.IAnnotatedFeatureInfo

getAnnotation, getAnnotations, getAnnotationsOfType, getDeclaredAnnotations, getDeprecatedReason, hasAnnotation, hasDeclaredAnnotation, isDefaultImpl, isDeprecated

Methods inherited from interface gw.lang.reflect.IAttributedFeatureInfo

isHidden, isScriptable, isVisible

Methods inherited from interface gw.lang.reflect.IFeatureInfo

getContainer, getLocationInfo, getOwnersType

Field Details

_dps

private ReducedDynamicPropertySymbol _dps

_type

private IType _type

_assignableType

private IType _assignableType

_accessor

private IPropertyAccessor _accessor

_bReadable

private boolean _bReadable

Constructor Details

GosuPropertyInfo

public GosuPropertyInfo(IFeatureInfo container,
 DynamicPropertySymbol dps)

Method Details

getName

public String getName()

Description copied from interface: IFeatureInfo

Gets the programmatic name or identifier of this feature. Note this name should follow Java identifier naming conventions (alpha-num and underscores, but can't start with a digit).

Specified by:

getName in interface IFeatureInfo

getDisplayName

public String getDisplayName()

Description copied from interface: IFeatureInfo

Gets the display name of this feature. There is no guarantee this display name is localized.

Specified by:

getDisplayName in interface IFeatureInfo

Overrides:

getDisplayName in class BaseFeatureInfo

getShortDescription

public String getShortDescription()

Specified by:

getShortDescription in interface IGosuPropertyInfo

getDescription

public String getDescription()

Description copied from interface: IFeatureInfo

A full description of this feature.

Specified by:

getDescription in interface IFeatureInfo

Overrides:

getDescription in class BaseFeatureInfo

isStatic

public boolean isStatic()

Description copied from interface: IAttributedFeatureInfo

True if this feature is static, meaning the feature is not specific to a particular instance of the feature's containing type.

Specified by:

isStatic in interface IAttributedFeatureInfo

isPrivate

public boolean isPrivate()

Description copied from interface: IAttributedFeatureInfo

True if this feature is private. Private features are only accessible from within the type that owns them.

Specified by:

isPrivate in interface IAttributedFeatureInfo

Overrides:

isPrivate in class BaseFeatureInfo

isInternal

public boolean isInternal()

Description copied from interface: IAttributedFeatureInfo

True if this feature is internal. Internal features are accessible from within the type that owns them and from other types in the same namespace.

Specified by:

isInternal in interface IAttributedFeatureInfo

Overrides:

isInternal in class BaseFeatureInfo

isProtected

public boolean isProtected()

Description copied from interface: IAttributedFeatureInfo

True if this feature is protected. Protected features are accessible from within the type that owns them and from derived containers.

Specified by:

isProtected in interface IAttributedFeatureInfo

Overrides:

isProtected in class BaseFeatureInfo

isPublic

public boolean isPublic()

Description copied from interface: IAttributedFeatureInfo

True if this feature is public. Public features are not restricted.

Specified by:

isPublic in interface IAttributedFeatureInfo

Overrides:

isPublic in class BaseFeatureInfo

isAbstract

public boolean isAbstract()

Specified by:

isAbstract in interface IAttributedFeatureInfo

Overrides:

isAbstract in class BaseFeatureInfo

isFinal

public boolean isFinal()

Specified by:

isFinal in interface IAttributedFeatureInfo

Overrides:

isFinal in class BaseFeatureInfo

isReified

public boolean isReified()

Specified by:

isReified in interface IAttributedFeatureInfo

Overrides:

isReified in class BaseFeatureInfo

isGetterDefault

public boolean isGetterDefault()

Specified by:

isGetterDefault in interface IGosuPropertyInfo

isSetterDefault

public boolean isSetterDefault()

Specified by:

isSetterDefault in interface IGosuPropertyInfo

isDefault

private boolean isDefault(ReducedDynamicFunctionSymbol dfs)

getGosuAnnotations

protected List<IGosuAnnotation> getGosuAnnotations()

Specified by:

getGosuAnnotations in class GosuBaseAttributedFeatureInfo

isReadable

public boolean isReadable()

Specified by:

isReadable in interface IPropertyInfo

Returns:

true if the property is readable given the visibility constraint passed in, false otherwise.

isReadable

public boolean isReadable(IType whosAskin)

Specified by:

isReadable in interface IPropertyInfo

isWritable

public boolean isWritable()

Specified by:

isWritable in interface IPropertyInfo

Returns:

True if the property is writable given the visibility constraint passed in, false otherwise.

isWritable

public boolean isWritable(IType whosAskin)

Specified by:

isWritable in interface IPropertyInfo

Parameters:

whosAskin - The type querying the property writability. For example, passing in the type the property is on will allow properties that have private access in the setter to be written to. Passing in an unrelated type will only allow properties that are to be written to.

Returns:

True if the property is writable given the visibility constraint passed in, false otherwise.

isAccessible

public boolean isAccessible(IType whosAskin,
 ReducedDynamicFunctionSymbol accessor)

getAccessor

public IPropertyAccessor getAccessor()

Specified by:

getAccessor in interface IPropertyInfo

Returns:

the PropertyAccessor (for getting and setting) this property.

getPresentationInfo

public IPresentationInfo getPresentationInfo()

Specified by:

getPresentationInfo in interface IPropertyInfo

getGosuClass

IGosuClassInternal getGosuClass()

getFeatureType

public IType getFeatureType()

Description copied from interface: IIntrinsicTypeReference

The type of this feature e.g., for a property this is the property's type.

Specified by:

getFeatureType in interface IIntrinsicTypeReference

getAssignableFeatureType

public IType getAssignableFeatureType()

Description copied from interface: IIntrinsicTypeReference

The type this feature can be assigned from. Most of the time this is the same type as getFeatureType(), however it can be different and when it is it should almost always be contravariant with getFeatureType().

A property setter method is the primary use-case. For instance:

   interface Foo {
     property Name: CharSequence
   }

   class FooImpl implements Foo {
     var _name: String
     override property get Name(): String {
       return _name
     }
     override property set Name( cs: CharSequence ) {
       _name = cs.toString()
     }
   }
 

Here FooImpl overrides Foo's Name property with covariance on the getter's return type. This establishes that Name wrt FooImpl is of type String. Yet Foo's setter method must be overridden as-is, a method cannot override another method with covariant parameters. So, in terms of FooImpl's Name property, the setter method is contravariant with String, which again is Name's type wrt of FooImpl. Therefore, FooImpl's Name property should implement getAssignableFeatureType() and return CharSequence.

Specified by:

getAssignableFeatureType in interface IIntrinsicTypeReference

getDps

public ReducedDynamicPropertySymbol getDps()

Specified by:

getDps in interface IGosuPropertyInfo

getContainingType

public IType getContainingType()

Specified by:

getContainingType in interface IGosuPropertyInfo

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

getTypeVariables

public GenericTypeVariable[] getTypeVariables()

Specified by:

getTypeVariables in interface IGenericMethodInfo

Returns:

An array of generic type variables if this feature corresponds with a generic type.

getParameterizedReturnType

public IType getParameterizedReturnType(IType... typeParams)

Specified by:

getParameterizedReturnType in interface IGenericMethodInfo

getParameterizedParameterTypes

public IType[] getParameterizedParameterTypes(IType... typeParams)

Specified by:

getParameterizedParameterTypes in interface IGenericMethodInfo

getParameterizedParameterTypes2

public IType[] getParameterizedParameterTypes2(IType ownersType,
 IType... typeParams)

Specified by:

getParameterizedParameterTypes2 in interface IGenericMethodInfo

inferTypeParametersFromArgumentTypes

public TypeVarToTypeMap inferTypeParametersFromArgumentTypes(IType... argTypes)

Specified by:

inferTypeParametersFromArgumentTypes in interface IGenericMethodInfo

Parameters:

argTypes - The argument types from a generic method call.

Returns:

A map of inferred type parameters based on the argTypes. The map contains only the types that could be inferred -- the map may be empty.

E.g., given generic method: T[] toArray( T[] ) and call: list.toArray( new String[list.size()] ); => the toArray() method call should be automatically parameterized with based on the new String[0].

inferTypeParametersFromArgumentTypes2

public TypeVarToTypeMap inferTypeParametersFromArgumentTypes2(IType owningParameterizedType,
 IType... argTypes)

Specified by:

inferTypeParametersFromArgumentTypes2 in interface IGenericMethodInfo

getReadMethodInfo

public IMethodInfo getReadMethodInfo()

Specified by:

getReadMethodInfo in interface IMethodBackedPropertyInfo

getWriteMethodInfo

public IMethodInfo getWriteMethodInfo()

Specified by:

getWriteMethodInfo in interface IMethodBackedPropertyInfo

toString

public String toString()

Overrides:

toString in class BaseFeatureInfo