recoder.java.reference
Class TypeReference

java.lang.Object
  recoder.java.JavaSourceElement
      recoder.java.JavaProgramElement
          recoder.java.JavaNonTerminalProgramElement
              recoder.java.reference.TypeReference

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, ExpressionContainer, NamedProgramElement, NonTerminalProgramElement, ProgramElement, Reference, MemberReference, NameReference, PackageReferenceContainer, ReferencePrefix, ReferenceSuffix, TypeReferenceContainer, TypeReferenceInfix, SourceElement, ModelElement, NamedModelElement

public class TypeReference
extends JavaNonTerminalProgramElement
implements TypeReferenceInfix, TypeReferenceContainer, PackageReferenceContainer, MemberReference

TypeReferences reference Types by name. A TypeReference can refer to an outer or inner type and hence can also be a MemberReference, but does not have to. A TypeReference can also occur as part of a reference path and as a prefix for types, too. As a possible suffix for types, it can have other TypeReferences as a prefix, playing the role of a TypeReferenceContainer.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface recoder.NamedModelElement

NamedModelElement.LexicalOrder

Field Summary

Fields inherited from class recoder.java.JavaSourceElement

factory

Fields inherited from interface recoder.NamedModelElement

LEXICAL_ORDER

Constructor Summary

	TypeReference() Type reference.
	TypeReference(Identifier name) Type reference.
	TypeReference(Identifier name, ASTList<TypeArgumentDeclaration> typeArgs)
	TypeReference(Identifier name, int dim) Type reference.
	TypeReference(ReferencePrefix prefix, Identifier name) Type reference.
protected	TypeReference(TypeReference proto) Type reference.

Method Summary

void	accept(SourceVisitor v) Receive a visitor, for instance a pretty printer.
TypeReference	deepClone() Deep clone.
NonTerminalProgramElement	getASTParent() Get AST parent.
ProgramElement	getChildAt(int index) Returns the child at the specified index in this node's "virtual" child array
int	getChildCount() Returns the number of children of this node.
int	getChildPositionCode(ProgramElement child) Returns the positional code of the given child, or -1 if there is no such child.
int	getDimensions() Get dimensions.
Expression	getExpressionAt(int index)
int	getExpressionCount() Get the number of expressions in this container.
SourceElement	getFirstElement() Finds the source element that occurs first in the source.
Identifier	getIdentifier() Get identifier.
java.lang.String	getName() Get name.
PackageReference	getPackageReference() Get the package reference.
TypeReferenceContainer	getParent() Get parent.
ReferencePrefix	getReferencePrefix() Get reference prefix.
ReferenceSuffix	getReferenceSuffix() Get reference suffix.
ASTList<TypeArgumentDeclaration>	getTypeArguments()
TypeReference	getTypeReferenceAt(int index)
int	getTypeReferenceCount() Get the number of type references in this container.
void	makeParentRoleValid() Make parent role valid.
boolean	replaceChild(ProgramElement p, ProgramElement q) Replace a single child in the current node.
void	setDimensions(int dim) Set dimensions.
void	setIdentifier(Identifier id) Set identifier.
void	setParent(TypeReferenceContainer elem) Set parent.
void	setReferencePrefix(ReferencePrefix x) Set reference prefix.
void	setReferenceSuffix(ReferenceSuffix x) Set reference suffix.
void	setTypeArguments(ASTList<TypeArgumentDeclaration> ta)
java.lang.String	toString()

Methods inherited from class recoder.java.JavaNonTerminalProgramElement

getIndexOfChild, getRoleOfChild, makeAllParentRolesValid, validateAll

Methods inherited from class recoder.java.JavaProgramElement

getComments, getID, setComments, validate

Methods inherited from class recoder.java.JavaSourceElement

getEndPosition, getFactory, getLastElement, getRelativePosition, getStartPosition, setEndPosition, setRelativePosition, setStartPosition, toSource

Methods inherited from class java.lang.Object

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

Constructor Detail

TypeReference

public TypeReference()

Type reference.

TypeReference

public TypeReference(Identifier name)

Type reference.

Parameters:

name - an identifier.

TypeReference

public TypeReference(ReferencePrefix prefix,
                     Identifier name)

Type reference.

Parameters:

prefix - a reference prefix.

name - an identifier.

TypeReference

public TypeReference(Identifier name,
                     int dim)

Type reference.

Parameters:

name - an identifier.

dim - an int value.

TypeReference

public TypeReference(Identifier name,
                     ASTList<TypeArgumentDeclaration> typeArgs)

TypeReference

protected TypeReference(TypeReference proto)

Type reference.

Parameters:

proto - a type reference.

Method Detail

deepClone

public TypeReference deepClone()

Deep clone.

Specified by:

deepClone in interface SourceElement

Returns:

the object.

makeParentRoleValid

public void makeParentRoleValid()

Make parent role valid.

Specified by:

makeParentRoleValid in interface NonTerminalProgramElement

Overrides:

makeParentRoleValid in class JavaNonTerminalProgramElement

getFirstElement

public SourceElement getFirstElement()

Description copied from class: JavaSourceElement

Finds the source element that occurs first in the source. The default implementation returns this element, which is correct for all terminal program elements, and many non terminals such as statements and prefixed operators.

Specified by:

getFirstElement in interface SourceElement

Overrides:

getFirstElement in class JavaSourceElement

Returns:

the first source element in the syntactical representation of this element, may be equals to this element.

See Also:

JavaSourceElement.toSource(), JavaSourceElement.getStartPosition()

getASTParent

public NonTerminalProgramElement getASTParent()

Get AST parent.

Specified by:

getASTParent in interface ProgramElement

Returns:

the non terminal program element.

getChildCount

public int getChildCount()

Returns the number of children of this node.

Specified by:

getChildCount in interface NonTerminalProgramElement

Returns:

an int giving the number of children of this node

getChildAt

public ProgramElement getChildAt(int index)

Returns the child at the specified index in this node's "virtual" child array

Specified by:

getChildAt in interface NonTerminalProgramElement

Parameters:

index - an index into this node's "virtual" child array

Returns:

the program element at the given position

Throws:

java.lang.ArrayIndexOutOfBoundsException - if index is out of bounds

getChildPositionCode

public int getChildPositionCode(ProgramElement child)

Description copied from interface: NonTerminalProgramElement

Returns the positional code of the given child, or -1 if there is no such child. The result contains an encoding of the relative position of the child as well as the role it has been playing in this parent element. This information is required internally for proper undo of transformations and is to be delivered to the detached method of the ChangeHistory.

Specified by:

getChildPositionCode in interface NonTerminalProgramElement

Parameters:

child - the exact child to look for.

Returns:

the positional code of the given child, or -1.

See Also:

ChangeHistory.detached(recoder.java.ProgramElement, recoder.java.NonTerminalProgramElement, int)

getTypeReferenceCount

public int getTypeReferenceCount()

Get the number of type references in this container.

Specified by:

getTypeReferenceCount in interface TypeReferenceContainer

Returns:

the number of type references.

getTypeReferenceAt

public TypeReference getTypeReferenceAt(int index)

Specified by:

getTypeReferenceAt in interface TypeReferenceContainer

getExpressionCount

public int getExpressionCount()

Get the number of expressions in this container.

Specified by:

getExpressionCount in interface ExpressionContainer

Returns:

the number of expressions.

getExpressionAt

public Expression getExpressionAt(int index)

Specified by:

getExpressionAt in interface ExpressionContainer

replaceChild

public boolean replaceChild(ProgramElement p,
                            ProgramElement q)

Replace a single child in the current node. The child to replace is matched by identity and hence must be known exactly. The replacement element can be null - in that case, the child is effectively removed. The parent role of the new child is validated, while the parent link of the replaced child is left untouched.

Specified by:

replaceChild in interface NonTerminalProgramElement

Parameters:

p - the old child.

p - the new child.

Returns:

true if a replacement has occured, false otherwise.

Throws:

java.lang.ClassCastException - if the new child cannot take over the role of the old one.

getParent

public TypeReferenceContainer getParent()

Get parent.

Returns:

the type reference container.

setParent

public void setParent(TypeReferenceContainer elem)

Set parent.

Parameters:

elem - a type reference container.

getReferencePrefix

public ReferencePrefix getReferencePrefix()

Get reference prefix.

Specified by:

getReferencePrefix in interface ReferenceSuffix

Returns:

the reference prefix.

getPackageReference

public PackageReference getPackageReference()

Get the package reference.

Specified by:

getPackageReference in interface PackageReferenceContainer

Returns:

the package reference.

setReferencePrefix

public void setReferencePrefix(ReferencePrefix x)

Set reference prefix.

Specified by:

setReferencePrefix in interface TypeReferenceInfix

Parameters:

x - a reference prefix.

getReferenceSuffix

public ReferenceSuffix getReferenceSuffix()

Get reference suffix.

Specified by:

getReferenceSuffix in interface ReferencePrefix

Returns:

the reference suffix.

setReferenceSuffix

public void setReferenceSuffix(ReferenceSuffix x)

Set reference suffix.

Specified by:

setReferenceSuffix in interface ReferencePrefix

Parameters:

x - a reference suffix, must also be a type reference container.

getDimensions

public int getDimensions()

Get dimensions.

Returns:

the int value.

setDimensions

public void setDimensions(int dim)

Set dimensions.

Parameters:

dim - an int value.

getName

public final java.lang.String getName()

Get name.

Specified by:

getName in interface NamedModelElement

Returns:

the string.

getIdentifier

public Identifier getIdentifier()

Get identifier.

Specified by:

getIdentifier in interface NamedProgramElement

Returns:

the identifier.

setIdentifier

public void setIdentifier(Identifier id)

Set identifier.

Specified by:

setIdentifier in interface NamedProgramElement

Parameters:

id - an identifier.

accept

public void accept(SourceVisitor v)

Description copied from interface: SourceElement

Receive a visitor, for instance a pretty printer.

Specified by:

accept in interface SourceElement

Parameters:

v - a source visitor.

setTypeArguments

public void setTypeArguments(ASTList<TypeArgumentDeclaration> ta)

getTypeArguments

public ASTList<TypeArgumentDeclaration> getTypeArguments()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object