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

Class ExpressionNodeBase

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

All Implemented Interfaces:

ISourceLocation, IASNode, IExpressionNode

Direct Known Subclasses:

BaseLiteralContainerNode, BaseStatementExpressionNode, ClassReferenceNode, EmbedNode, FoldedExpressionNode, FunctionCallNode, FunctionObjectNode, IdentifierNode, LiteralNode, NilNode, ObjectLiteralValuePairNode, OperatorNodeBase, RuntimeNameExpressionNode, TypedExpressionNode, VariableExpressionNode

public abstract class ExpressionNodeBase
extends FixedChildrenNode
implements IExpressionNode

ActionScript parse tree node representing an expression

Field Summary

Fields

Modifier and Type	Field and Description
protected int	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
	ExpressionNodeBase() Constructor.
protected	ExpressionNodeBase(ExpressionNodeBase other) Copy constructor.

Method Summary

Methods

Modifier and Type	Method and Description
INamespaceReference	computeNamespaceReference() Generate an INamespaceReference that can serve as the namespace reference for something like a namespace initializer.
protected abstract ExpressionNodeBase	copy() Copy the ExpressionNodeBase and its subtree.
ExpressionNodeBase	copyForInitializer(IScopedNode scopedNode) Return a copy of this IExpressionNode and all it's children that can be used by VariableDefinition to resolve it's initial value without having to hold onto the entire syntax tree for a source file.
ASScope	getASScope() Get the scope this Node uses for name resolution as an ASScope.
ExpressionNodeBase	getBaseExpression() Get the base expression, if any.
ExpressionNodeBase	getDecorationNode() Get the appropriate node at which to start decoration.
DependencyType	getDependencyType() Compute the type of dependency between two compilation unit this expression node creates.
Name	getMName(ICompilerProject project) Gets the AET Name object to be used for an expression.
protected ExpressionNodeBase	getParentExpression() Get the parent of this Node as an ExpressionNodeBase.
boolean	hasParenthesis() Determines whether this expression is surrounded by parenthesis.
boolean	inFilter() Check if the expression is inside a filter expression.
boolean	inWith()
boolean	isDynamicExpression(ICompilerProject project) Does this expression evaluate to a dynamic value
boolean	isPackageReference() Determine if this node is a reference to a package
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	setHasParenthesis(boolean hasParens)

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

isTerminal

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

analyze, buildInnerString, buildStringRecursive, canContinueContainmentSearch, collectImportNodes, combineAttributes, connectedToProjectScope, contains, endAfter, endAfter, endBefore, endBefore, fillInOffsets, getAbsoluteEnd, getAbsoluteStart, getAncestorOfType, getChild, getChildCount, getContainingFilePath, getContainingNode, getContainingScope, getEnd, getFileScope, getFileSpecification, getInnerString, getNodeKind, getPackageName, getParent, getScopeNode, 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.IASNode

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

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

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

Field Detail

flags

protected int flags

Constructor Detail

ExpressionNodeBase

public ExpressionNodeBase()

Constructor.

ExpressionNodeBase

protected ExpressionNodeBase(ExpressionNodeBase other)

Copy constructor.

Parameters:

other - The node to copy.

Method Detail

normalize

public void normalize(boolean fillInOffsets)

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 NodeBase

getASScope

public ASScope getASScope()

Description copied from class: NodeBase

Get the scope this Node uses for name resolution as an ASScope.

Overrides:

getASScope in class NodeBase

Returns:

the ASScope for this node, or null if there isn't one.

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

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

Parameters:

project - The ICompilerProject to use to do lookups.

Returns:

The ITypeDefinition of the type this expression results in.

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

Parameters:

project - The ICompilerProject to use to do lookups.

Returns:

true if we evaluate to something dynamic

copyForInitializer

public ExpressionNodeBase copyForInitializer(IScopedNode scopedNode)

Description copied from interface: IExpressionNode

Return a copy of this IExpressionNode and all it's children that can be used by VariableDefinition to resolve it's initial value without having to hold onto the entire syntax tree for a source file. Not all expressions will be copy-able - e.g. a function expression won't be successfully copied, but that is OK because we can't constant evaluate a function expression anyways.

Specified by:

copyForInitializer in interface IExpressionNode

Returns:

a new IExpressionNode that is not tied to the syntax tree it came from. If a copy can not be generated, null is returned.

hasParenthesis

public boolean hasParenthesis()

Description copied from interface: IExpressionNode

Determines whether this expression is surrounded by parenthesis. Nested parenthesis are reduced to the smallest number needed to maintain code meaning

Specified by:

hasParenthesis in interface IExpressionNode

Returns:

true if surrounded by parenthesis

copy

protected abstract ExpressionNodeBase copy()

Copy the ExpressionNodeBase and its subtree.

Returns:

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

getMName

public Name getMName(ICompilerProject project)

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.

Parameters:

project - The ICompilerProject to use to do lookups.

Returns:

A AET Name object.

setHasParenthesis

public void setHasParenthesis(boolean hasParens)

isPackageReference

public boolean isPackageReference()

Determine if this node is a reference to a package

Returns:

true if this node is really a package reference.

getBaseExpression

public ExpressionNodeBase getBaseExpression()

Get the base expression, if any. In a.b, or a.@b, or a.c::b, the base of b is a.

Returns:

The base as an ExpressionNodeBase, if it is one, otherwise null

inWith

public boolean inWith()

Returns:

true if this ExpressionNodeBase is in a with scope.

getDecorationNode

public ExpressionNodeBase getDecorationNode()

Get the appropriate node at which to start decoration. This returns the largest containing expression node, which should provide enough context to figure out what the definitions are.

Returns:

the node that should be decorated

inFilter

public final boolean inFilter()

Check if the expression is inside a filter expression. For example:

 xmlData.(getName() == "hello")
 

getName() == "hello" is in a filter.

The implementation walks up the parent nodes till the first ScopedBlockNode. If a MemberAccessExpressionNode with ASTNodeID.E4XFilterID is found, this node is inside a filter expression.

Returns:

True if this node is in a filter expression.

getParentExpression

protected ExpressionNodeBase getParentExpression()

Get the parent of this Node as an ExpressionNodeBase.

Returns:

the parent of this node as an ExpressionNodeBase, or null if it isn't an ExpressionNodeBase.

computeNamespaceReference

public INamespaceReference computeNamespaceReference()

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

Returns:

An INamespaceReference that represents this expression node or null.

getDependencyType

public DependencyType getDependencyType()

Compute the type of dependency between two compilation unit this expression node creates.

Returns:

The type of dependency between two compilation unit this identifier node creates.