org.apache.flex.compiler.internal.tree.as

Class IdentifierNode

java.lang.Object

org.apache.flex.compiler.common.SourceLocation

org.apache.flex.compiler.internal.tree.as.NodeBase

org.apache.flex.compiler.internal.tree.as.FixedChildrenNode

org.apache.flex.compiler.internal.tree.as.ExpressionNodeBase

org.apache.flex.compiler.internal.tree.as.IdentifierNode

All Implemented Interfaces:

ISourceLocation, IASNode, IExpressionNode, IIdentifierNode

Direct Known Subclasses:

LanguageIdentifierNode, NamespaceIdentifierNode, NonResolvingIdentifierNode, QualifiedNameExpressionNode

public class IdentifierNode
extends ExpressionNodeBase
implements IIdentifierNode

ActionScript parse tree node representing an identifier

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.flex.compiler.tree.as.IIdentifierNode

IIdentifierNode.IdentifierType

Field Summary

Fields inherited from class org.apache.flex.compiler.internal.tree.as.ExpressionNodeBase

flags

Fields inherited from class org.apache.flex.compiler.internal.tree.as.NodeBase

emptyNodeArray, parent

Fields inherited from interface org.apache.flex.compiler.common.ISourceLocation

UNKNOWN

Constructor Summary

Constructors

Modifier	Constructor and Description
	IdentifierNode(IASToken token) Constructor.
protected	IdentifierNode(IdentifierNode other) Copy constructor.
	IdentifierNode(String name) Constructor.
	IdentifierNode(String name, IASToken token) Constructor.
	IdentifierNode(String name, antlr.Token token) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	analyze(EnumSet<PostProcessStep> set, ASScope scope, Collection<ICompilerProblem> problems)
protected boolean	buildInnerString(StringBuilder sb) For debugging only.
protected boolean	canEarlyBind(ICompilerProject project, IDefinition def) Can this Node be early bound to the Definition it refers to.
INamespaceReference	computeNamespaceReference() Generate an INamespaceReference that can serve as the namespace reference for something like a namespace initializer.
protected IdentifierNode	copy() Copy the ExpressionNodeBase and its subtree.
static IdentifierNode	createEmptyIdentifierNodeAfterToken(antlr.Token token) Create a dummy IdentifierNode after the given token.
protected void	fillInOffsets() If the start and end offsets haven't been set explicitly, fill them in based on the offsets of the children.
IIdentifierNode.IdentifierType	getIdentifierType() Returns of the type of this identifier.
Name	getMName(ICompilerProject project) Gets the AET Name object to be used for an expression.
String	getName() Gets the full name of this identifier
ASTNodeID	getNodeID() Get the opcode of this node
IScopedNode	getScopeNode() Get the nearest containing scope for this node.
protected boolean	isAttributeIdentifier() Determine if this identifier is an attribute reference (e.g.
boolean	isDynamicExpression(ICompilerProject project) Does this expression evaluate to a dynamic value
boolean	isImplicit() Determines if this identifier is actually implicit and does not exist in source.
boolean	isLegacyCodegen(ICompilerProject project)
boolean	isMemberRef() Is this a reference that should be resolve in another object e.g. the node for 'b' in a.b would return true
boolean	isTerminal() Determines if this node is a terminal node, meaning it cannot have children
protected boolean	isTypeRef() Is this a type reference - e.g. a base class ref, type anno, etc
static boolean	isXMLish(IDefinition def, ICompilerProject project) Determine if the definition passed in is one of the XML types (XML or XMLList) These classes are unrelated, but behave in similar manners.
void	normalize(boolean fillInOffsets) Normalize the tree.
IDefinition	resolve(ICompilerProject project) If this expression is statically known to refer to a definition return a reference to that definition.
ITypeDefinition	resolveType(ICompilerProject project) The type of the result of this expression.
void	setReferenceValue(IDefinition definition)

Methods inherited from class org.apache.flex.compiler.internal.tree.as.ExpressionNodeBase

copyForInitializer, getASScope, getBaseExpression, getDecorationNode, getDependencyType, getParentExpression, hasParenthesis, inFilter, inWith, isPackageReference, setHasParenthesis

Methods inherited from class org.apache.flex.compiler.internal.tree.as.NodeBase

buildStringRecursive, canContinueContainmentSearch, collectImportNodes, combineAttributes, connectedToProjectScope, contains, endAfter, endAfter, endBefore, endBefore, getAbsoluteEnd, getAbsoluteStart, getAncestorOfType, getChild, getChildCount, getContainingFilePath, getContainingNode, getContainingScope, getEnd, getFileScope, getFileSpecification, getInnerString, getNodeKind, getPackageName, getParent, getSpanningStart, getStart, getSucceedingNode, getWorkspace, isTransparent, looselyContains, replaceChild, runPostProcess, setChildren, setParent, span, span, span, startAfter, startAfter, startBefore, startBefore, swapChildren, toString, tryGetOffsetLookup, verify

Methods inherited from class org.apache.flex.compiler.common.SourceLocation

getColumn, getEndColumn, getEndLine, getLine, getLineColumnString, getOffsetsString, getSourcePath, getSourcePathString, setColumn, setEnd, setEndColumn, setEndLine, setLine, setSourceLocation, setSourcePath, setStart, span, span

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.flex.compiler.tree.as.IExpressionNode

copyForInitializer, hasParenthesis

Methods inherited from interface org.apache.flex.compiler.tree.as.IASNode

contains, getAncestorOfType, getChild, getChildCount, getContainingNode, getContainingScope, getFileSpecification, getPackageName, getParent, getSpanningStart, getSucceedingNode

Methods inherited from interface org.apache.flex.compiler.common.ISourceLocation

getAbsoluteEnd, getAbsoluteStart, getColumn, getEnd, getEndColumn, getEndLine, getLine, getSourcePath, getStart

Constructor Detail

IdentifierNode

public IdentifierNode(String name)

Constructor.

IdentifierNode

public IdentifierNode(String name,
              antlr.Token token)

Constructor.

IdentifierNode

public IdentifierNode(String name,
              IASToken token)

Constructor.

IdentifierNode

public IdentifierNode(IASToken token)

Constructor.

IdentifierNode

protected IdentifierNode(IdentifierNode other)

Copy constructor.

Parameters:

other - The node to copy.

Method Detail

createEmptyIdentifierNodeAfterToken

public static IdentifierNode createEmptyIdentifierNodeAfterToken(antlr.Token token)

Create a dummy IdentifierNode after the given token. This is used to repair the AST where an identifier node is expected.

Parameters:

token - The empty ID node will have start offset following this token.

Returns:

Dummy identifier node.

isXMLish

public static boolean isXMLish(IDefinition def,
               ICompilerProject project)

Determine if the definition passed in is one of the XML types (XML or XMLList) These classes are unrelated, but behave in similar manners.

Parameters:

def - the IDefinition to check

project - the ICompilerProject in which to look up types

Returns:

true if definition is the built-in XML or XMLList type.

getNodeID

public ASTNodeID getNodeID()

Description copied from interface: IASNode

Get the opcode of this node

Specified by:

getNodeID in interface IASNode

Returns:

the opcode - this is one of the constants defined in ASTConstants

isTerminal

public boolean isTerminal()

Description copied from interface: IASNode

Determines if this node is a terminal node, meaning it cannot have children

Specified by:

isTerminal in interface IASNode

Overrides:

isTerminal in class FixedChildrenNode

Returns:

true if this node is terminal

analyze

protected void analyze(EnumSet<PostProcessStep> set,
           ASScope scope,
           Collection<ICompilerProblem> problems)

Overrides:

analyze in class NodeBase

normalize

public void normalize(boolean fillInOffsets)

Description copied from class: ExpressionNodeBase

Normalize the tree. Move custom children into the real child list and fill in missing offsets so that offset lookup will work. Used during parsing.

Overrides:

normalize in class ExpressionNodeBase

fillInOffsets

protected void fillInOffsets()

Description copied from class: NodeBase

If the start and end offsets haven't been set explicitly, fill them in based on the offsets of the children. Used during parsing. If the end offset is less than any of the kids' offsets, change fLocation.fEnd to encompass kids.

Overrides:

fillInOffsets in class NodeBase

getScopeNode

public IScopedNode getScopeNode()

Description copied from class: NodeBase

Get the nearest containing scope for this node. Used during type decoration.

Overrides:

getScopeNode in class NodeBase

Returns:

nearest containing scope for this node

buildInnerString

protected boolean buildInnerString(StringBuilder sb)

Description copied from class: NodeBase

For debugging only. This method is called by buildOuterString(). It is overridden by subclasses to display optional node-specific information in the middle of the string, between the node type and the location information.

Overrides:

buildInnerString in class NodeBase

resolve

public IDefinition resolve(ICompilerProject project)

Description copied from interface: IExpressionNode

If this expression is statically known to refer to a definition return a reference to that definition. In many cases this will return the same definition as resolveType, but when an identifier resolves to an member variable or member function of a class, this method will return the IDefinition for the member variable or member function not the definition for the type of the member variable or the member function.

Specified by:

resolve in interface IExpressionNode

Overrides:

resolve in class ExpressionNodeBase

Parameters:

project - The ICompilerProject to use to do lookups.

Returns:

The IDefinition this expression refers to.

resolveType

public ITypeDefinition resolveType(ICompilerProject project)

Description copied from interface: IExpressionNode

The type of the result of this expression. This method returns the IDefinition representing the type that is the result of this expression. This can differ from the IDefinition you get from resolve(), such as when called on a FunctionCallNode: resolve() will return the IDefinition for the Function, whereas resolveType() will return the return type of the Function.

Specified by:

resolveType in interface IExpressionNode

Overrides:

resolveType in class ExpressionNodeBase

Parameters:

project - The ICompilerProject to use to do lookups.

Returns:

The ITypeDefinition of the type this expression results in.

copy

protected IdentifierNode copy()

Description copied from class: ExpressionNodeBase

Copy the ExpressionNodeBase and its subtree.

Specified by:

copy in class ExpressionNodeBase

Returns:

a new ExpressionNodeBase that represents the same content as the original node

isDynamicExpression

public boolean isDynamicExpression(ICompilerProject project)

Description copied from interface: IExpressionNode

Does this expression evaluate to a dynamic value

Specified by:

isDynamicExpression in interface IExpressionNode

Overrides:

isDynamicExpression in class ExpressionNodeBase

Parameters:

project - The ICompilerProject to use to do lookups.

Returns:

true if we evaluate to something dynamic

getMName

public Name getMName(ICompilerProject project)

Description copied from class: ExpressionNodeBase

Gets the AET Name object to be used for an expression.

For all expression nodes except for the identifier nodes and member access nodes, this method returns null.

This is the method that the code generator calls to determine what name to emit into the ABC file. It will handle resolving the identifier if necessary and generating the appropriate qname or multiname.

Overrides:

getMName in class ExpressionNodeBase

Parameters:

project - The ICompilerProject to use to do lookups.

Returns:

A AET Name object.

computeNamespaceReference

public INamespaceReference computeNamespaceReference()

Description copied from class: ExpressionNodeBase

Generate an INamespaceReference that can serve as the namespace reference for something like a namespace initializer.

Overrides:

computeNamespaceReference in class ExpressionNodeBase

Returns:

An INamespaceReference that represents this expression node or null.

getName

public String getName()

Description copied from interface: IIdentifierNode

Gets the full name of this identifier

Specified by:

getName in interface IIdentifierNode

Returns:

a String representing the name of this identifier

getIdentifierType

public IIdentifierNode.IdentifierType getIdentifierType()

Description copied from interface: IIdentifierNode

Returns of the type of this identifier.

Specified by:

getIdentifierType in interface IIdentifierNode

Returns:

the type of this identifier

See Also:

IIdentifierNode.IdentifierType

setReferenceValue

public void setReferenceValue(IDefinition definition)

isImplicit

public boolean isImplicit()

Determines if this identifier is actually implicit and does not exist in source.

isAttributeIdentifier

protected boolean isAttributeIdentifier()

Determine if this identifier is an attribute reference (e.g. @name).

Returns:

True if this node is an attribute

isMemberRef

public boolean isMemberRef()

Is this a reference that should be resolve in another object e.g. the node for 'b' in a.b would return true

Returns:

true if this node should be resolved in another object

canEarlyBind

protected boolean canEarlyBind(ICompilerProject project,
                   IDefinition def)

Can this Node be early bound to the Definition it refers to. We can early bind if we resolve to a definition, the definition is not ambiguous, and the definition is not something defined in one of the XML classes (XML or XMLList).

Parameters:

project - project to resolve things in

def - the definition this node resolved to

Returns:

true if we can early bind, otherwise false

isTypeRef

protected boolean isTypeRef()

Is this a type reference - e.g. a base class ref, type anno, etc

Returns:

true if this is a type reference

isLegacyCodegen

public boolean isLegacyCodegen(ICompilerProject project)