com.whitestein.lsps.lang.ast

Class Expression

java.lang.Object

com.whitestein.lsps.lang.ast.ASTRangeImpl

com.whitestein.lsps.lang.ast.ASTNodeImpl

com.whitestein.lsps.lang.ast.Expression

All Implemented Interfaces:

ASTInfo, ASTNode, ASTRange

Direct Known Subclasses:

AssignableExpression, AssignmentExpression, BlockExpression, BreakExpression, CastExpression, ChainedExpression, ClosureInvocationExpression, CompoundAssignmentExpression, ConditionalExpression, ConstantExpression, ContainerExpression, ContextReferencingExpression, ContinueExpression, CustomConstantExpression, DebugExpression, DefExpression, EnumerationExpression, ForeachExpression, ForExpression, FunctionCallExpression, FunctionCallWithNamedArgs, IfnullExpression, IncDecExpression, InstanceofExpression, MethodCallExpression, MissingReturnExpression, PropertyLiteralExpression, RecordConstructorExpression, RecordExpression, SignatureExpression, SuperConstructorExpression, SwitchExpression, SyntheticExpression, ThisConstructorExpression, ThisExpression, TryCatchExpression, TypeExpression, UnknownExpression, WhileExpression

public abstract class Expression
extends ASTNodeImpl
implements ASTInfo

Author:

rba

Field Summary

Fields inherited from interface com.whitestein.lsps.lang.ast.ASTInfo

EMPTY

Method Summary

Modifier and Type	Method and Description
abstract <T,E extends java.lang.Throwable> T	accept(ExpressionVisitor<T,E> visitor) Accepts visitor.
protected abstract java.lang.Object	basicInterpret(Interpreter interpreter, InterpreterStackTrace stackTrace) Interpret expression.
protected com.whitestein.lsps.lang.parser.antlr.ANTLRLangParser	createANTLRParser()
protected java.lang.Object	doInterpret(Interpreter interpreter, InterpreterStackTrace stackTrace) Interpretation of expression with debugger support.
protected boolean	evalCondition(Interpreter interpreter, InterpreterStackTrace stackTrace) Evaluates expression as boolean expression.
protected java.util.List<Expression>	evaluateToExpressions(Expression[] expressions, Interpreter interpreter, InterpreterStackTrace stackTrace)
protected java.lang.Object	executeCompiled(Interpreter interpreter, InterpreterStackTrace stackTrace)
Compiled	getCompiled()
int	getDebugLine() Returns the debug line.
protected IdentifierAst	getIdentifierAst(org.antlr.runtime.tree.CommonTree tree)
java.lang.Object	getParseTimeConstant() Returns the value of the expression determined in parse time.
protected ASTNode	getPrimaryRange()
protected ASTNode	getPropertySelectorRange()
protected ASTNode	getRange(org.antlr.runtime.tree.CommonTree tree)
Expression	getResultExpression() Returns the result expression.
java.util.List<Expression>	getResultExpressions() Returns the result expression.
Type	getType() Returns the return type.
java.lang.Object	interpret(Interpreter interpreter, InterpreterStackTrace stackTrace) Interpretation of the expression with handling of correct namespace.
java.lang.Object	interpretInCurrentNamespace(Interpreter interpreter, InterpreterStackTrace stackTrace) Interpretation of the expression in the current interpreter namespace.
boolean	isCreatingNonModuleContextObjects() Returns true if this expression contains closures or references that reference the enclosing (non-module) context.
boolean	isParseTimeConstant() Returns true if the value of the expression is known in parse time.
boolean	requiresNewNamespace()
void	setCompiled(Compiled compiled)
java.lang.String	showInFullText() Returns the text of this expression enclosed in curly braces in the full text.
java.lang.String	showInSurroundingText(int surroundingLinesCount) Returns the text of this expression enclosed in curly braces with defined number of lines before and after.
java.lang.String	showInText() Returns the text of this expression enclosed in curly braces in the full or surrounding text.
protected java.util.List<Expression>	toExpressions(java.util.List<?> values)

Methods inherited from class com.whitestein.lsps.lang.ast.ASTNodeImpl

getFullText, getLine, getNodeText, getText, toString

Methods inherited from class com.whitestein.lsps.lang.ast.ASTRangeImpl

contains, getBeginIndex, getEndIndex, getLength

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.whitestein.lsps.lang.ast.ASTNode

getFullText, getLine, getNodeText, getText

Methods inherited from interface com.whitestein.lsps.lang.ast.ASTRange

contains, getBeginIndex, getEndIndex, getLength

Method Detail

getType

public Type getType()

Returns the return type.

Returns:

the return type

requiresNewNamespace

public boolean requiresNewNamespace()

Returns:

true if the interpretation requires a new namespace

getDebugLine

public int getDebugLine()

Description copied from interface: ASTInfo

Returns the debug line.

Specified by:

getDebugLine in interface ASTInfo

Returns:

the debug line

getResultExpression

public Expression getResultExpression()

Returns the result expression. E.g. for a chained expression, it returns its last child (applied recursively). May return this.

Returns:

the result expression (may be this)

getResultExpressions

public java.util.List<Expression> getResultExpressions()

Returns the result expression. E.g. for a chained expression, it returns its last child (applied recursively).

Returns:

the result expressions

isParseTimeConstant

public boolean isParseTimeConstant()

Returns true if the value of the expression is known in parse time. E.g. constant literals, enumerations, types (without free types).

Returns:

true if the expression value is known during parsing

See Also:

getParseTimeConstant()

getParseTimeConstant

public java.lang.Object getParseTimeConstant()

Returns the value of the expression determined in parse time. The default implementation throws UnsupportedOperationException. Subclasses, which return true when isParseTimeConstant() is called, should override this method.

Returns:

the value determined in parse time

See Also:

isParseTimeConstant()

isCreatingNonModuleContextObjects

public boolean isCreatingNonModuleContextObjects()

Returns true if this expression contains closures or references that reference the enclosing (non-module) context. Referencing the top module context is allowed (e.g. module variables).

Returns:

true if the expression "references" enclosing namespace

showInText

public java.lang.String showInText()

Returns the text of this expression enclosed in curly braces in the full or surrounding text.

Returns:

the text of this expression enclosed in curly braces in the full or surrounding text

showInFullText

public java.lang.String showInFullText()

Returns the text of this expression enclosed in curly braces in the full text.

Returns:

the text of this expression enclosed in curly braces in the full text

showInSurroundingText

public java.lang.String showInSurroundingText(int surroundingLinesCount)

Returns the text of this expression enclosed in curly braces with defined number of lines before and after.

Parameters:

surroundingLinesCount -

Returns:

the text of this expression enclosed in curly braces with defined number of lines before and after.

accept

public abstract <T,E extends java.lang.Throwable> T accept(ExpressionVisitor<T,E> visitor)
                                                    throws E extends java.lang.Throwable

Accepts visitor.

Type Parameters:

T -

E -

Parameters:

visitor -

Returns:

the result of visit

Throws:

E

E extends java.lang.Throwable

basicInterpret

protected abstract java.lang.Object basicInterpret(Interpreter interpreter,
                                                   InterpreterStackTrace stackTrace)
                                            throws ErrorException

Interpret expression.

Parameters:

interpreter -

stackTrace -

Returns:

result of interpretation

Throws:

ErrorException

executeCompiled

protected java.lang.Object executeCompiled(Interpreter interpreter,
                                           InterpreterStackTrace stackTrace)
                                    throws ErrorException

Throws:

ErrorException

interpret

public final java.lang.Object interpret(Interpreter interpreter,
                                        InterpreterStackTrace stackTrace)
                                 throws ErrorException

Interpretation of the expression with handling of correct namespace.

Parameters:

interpreter -

stackTrace -

Returns:

result of interpretation

Throws:

ErrorException

interpretInCurrentNamespace

public final java.lang.Object interpretInCurrentNamespace(Interpreter interpreter,
                                                          InterpreterStackTrace stackTrace)
                                                   throws ErrorException

Interpretation of the expression in the current interpreter namespace.

Parameters:

interpreter -

stackTrace -

Returns:

result of interpretation

Throws:

ErrorException

doInterpret

protected final java.lang.Object doInterpret(Interpreter interpreter,
                                             InterpreterStackTrace stackTrace)
                                      throws ErrorException

Interpretation of expression with debugger support.

Parameters:

interpreter -

stackTrace -

Returns:

result of interpretation

Throws:

ErrorException

evalCondition

protected final boolean evalCondition(Interpreter interpreter,
                                      InterpreterStackTrace stackTrace)
                               throws ErrorException

Evaluates expression as boolean expression.

Parameters:

interpreter -

stackTrace -

Returns:

result of interpretation

Throws:

ErrorException

evaluateToExpressions

protected final java.util.List<Expression> evaluateToExpressions(Expression[] expressions,
                                                                 Interpreter interpreter,
                                                                 InterpreterStackTrace stackTrace)
                                                          throws ErrorException

Throws:

ErrorException

toExpressions

protected final java.util.List<Expression> toExpressions(java.util.List<?> values)

setCompiled

public void setCompiled(Compiled compiled)

getCompiled

public Compiled getCompiled()

getPrimaryRange

protected ASTNode getPrimaryRange()

getPropertySelectorRange

protected ASTNode getPropertySelectorRange()

createANTLRParser

protected com.whitestein.lsps.lang.parser.antlr.ANTLRLangParser createANTLRParser()

getRange

protected ASTNode getRange(org.antlr.runtime.tree.CommonTree tree)

getIdentifierAst

protected IdentifierAst getIdentifierAst(org.antlr.runtime.tree.CommonTree tree)