Package net.ssehub.easy.instantiation.core.model.expressions

Class EvaluationVisitor

java.lang.Object

net.ssehub.easy.instantiation.core.model.expressions.EvaluationVisitor

All Implemented Interfaces:

IExpressionVisitor

Direct Known Subclasses:

ExecutionVisitor

public class EvaluationVisitor
extends java.lang.Object
implements IExpressionVisitor

A basic visitor for evaluating expressions.

Author:

Holger Eichelberger

Field Summary

Fields

Modifier and Type	Field	Description
private IRuntimeEnvironment	environment
private ITracer	tracer

Constructor Summary

Constructors

Constructor	Description
EvaluationVisitor(IRuntimeEnvironment environment, ITracer tracer)	Creates a new evaluation visitor.

Method Summary

Modifier and Type	Method	Description
protected void	addImplicitParamters(java.util.Map<java.lang.String,java.lang.Object> named)	Adds additional implicit named parameters.
protected java.lang.String	appendInCompositeExpression(java.lang.String s1, Expression e1, java.lang.Object v1, java.lang.String s2, Expression e2)	Appends s2 to s2 originating from the respective expressions.
protected java.lang.String	evaluateContentExpression(IExpressionIterator iter)	Evaluates iter as a content expression.
IRuntimeEnvironment	getRuntimeEnvironment()	Returns the runtime environment (needed for iterator evaluation).
protected boolean	lastContentReplaceEmptyLine()	Returns whether the last content commands that empty lines (itself empty, following line breaks) shall be removed.
protected void	notifyValueDefined(VariableDeclaration var, FieldDescriptor field, java.lang.Object val)	Is called when a value of a value is defined.
private java.lang.Object	visitCall(AbstractCallExpression call, java.lang.Object parent, OperationDescriptor resolved, CallExpression.CallType type)	Processes a call.
java.lang.Object	visitCallExpression(CallExpression call)	Visits a call node.
java.lang.Object	visitCompositeExpression(CompositeExpression ex)	Visits a composite expression.
java.lang.Object	visitConstantExpression(ConstantExpression cst)	Visits a constant node.
java.lang.Object	visitContainerInitializerExpression(ContainerInitializerExpression ex)	Visits a container initializer expression.
java.lang.Object	visitExpression(Expression ex)	Visits an unspecified expression (in case of specialized nodes).
java.lang.Object	visitExpressionEvaluator(ExpressionEvaluator ex)	Visits an expression evaluator.
java.lang.Object	visitFieldAccessExpression(FieldAccessExpression ex)	Visits a field access expression.
java.lang.Object	visitMultiAndExpression(MultiAndExpression ex)	Visits a multi-and expression.
java.lang.Object	visitParenthesisExpression(ParenthesisExpression par)	Visits a parenthesis node.
java.lang.Object	visitResolvableOperationCallExpression(ResolvableOperationCallExpression ex)	Visits resolvable operation call expression (function pointer call).
java.lang.Object	visitResolvableOperationExpression(ResolvableOperationExpression ex)	Visits resolvable operation expression (function pointer resolution).
java.lang.Object	visitStringExpression(StringExpression ex)	Visits a string expression.
java.lang.Object	visitValueAssignmentExpression(ValueAssignmentExpression ex)	Visits a value assignment expression.
java.lang.Object	visitVariableExpression(VariableExpression cst)	Visits a constant node.
java.lang.Object	visitVarModelIdentifierExpression(VarModelIdentifierExpression identifier)	Visits a variability model identifier.
java.lang.Object	visitVilTypeExpression(VilTypeExpression typeExpression)	Visits a VIL type expression.

Methods inherited from class java.lang.Object

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

Field Detail

environment

private IRuntimeEnvironment environment

tracer

private ITracer tracer

Constructor Detail

EvaluationVisitor

public EvaluationVisitor(IRuntimeEnvironment environment,
                         ITracer tracer)

Creates a new evaluation visitor.

Parameters:

environment - the runtime environment carrying the variable assignments

tracer - a tracer for being informed about the actual execution

Method Detail

getRuntimeEnvironment

public IRuntimeEnvironment getRuntimeEnvironment()

Returns the runtime environment (needed for iterator evaluation).

Returns:

the runtime environment

visitParenthesisExpression

public java.lang.Object visitParenthesisExpression(ParenthesisExpression par)
                                            throws VilException

Description copied from interface: IExpressionVisitor

Visits a parenthesis node.

Specified by:

visitParenthesisExpression in interface IExpressionVisitor

Parameters:

par - the node

Returns:

the result of visiting this expression (may be null)

Throws:

VilException - in case that visiting fails (e.g., execution)

visitCallExpression

public java.lang.Object visitCallExpression(CallExpression call)
                                     throws VilException

Description copied from interface: IExpressionVisitor

Visits a call node.

Specified by:

visitCallExpression in interface IExpressionVisitor

Parameters:

call - the node

Returns:

the result of visiting this expression (may be null)

Throws:

VilException - in case that visiting fails (e.g., execution)

visitCall

private java.lang.Object visitCall(AbstractCallExpression call,
                                   java.lang.Object parent,
                                   OperationDescriptor resolved,
                                   CallExpression.CallType type)
                            throws VilException

Processes a call.

Parameters:

call - the call expression holding the arguments

parent - the parent of the call (may be null)

resolved - the resolved operation to be called

type - the call type

Returns:

the result of executing the call

Throws:

VilException - in case that the call or the evaluation of the arguments fails

addImplicitParamters

protected void addImplicitParamters(java.util.Map<java.lang.String,java.lang.Object> named)

Adds additional implicit named parameters.

Parameters:

named - the named parameters

visitConstantExpression

public java.lang.Object visitConstantExpression(ConstantExpression cst)
                                         throws VilException

Description copied from interface: IExpressionVisitor

Visits a constant node.

Specified by:

visitConstantExpression in interface IExpressionVisitor

Parameters:

cst - the node

Returns:

the result of visiting this expression (may be null)

Throws:

VilException - in case that visiting fails (e.g., execution)

visitStringExpression

public java.lang.Object visitStringExpression(StringExpression ex)
                                       throws VilException

Description copied from interface: IExpressionVisitor

Visits a string expression.

Specified by:

visitStringExpression in interface IExpressionVisitor

Parameters:

ex - the expression

Returns:

the result of visiting the given statement (may be null)

Throws:

VilException - in case that visiting fails (e.g., execution)

visitVarModelIdentifierExpression

public java.lang.Object visitVarModelIdentifierExpression(VarModelIdentifierExpression identifier)
                                                   throws VilException

Description copied from interface: IExpressionVisitor

Visits a variability model identifier.

Specified by:

visitVarModelIdentifierExpression in interface IExpressionVisitor

Parameters:

identifier - the identifier

Returns:

the result of visiting this expression (may be null)

Throws:

VilException - in case that visiting fails (e.g., execution)

visitVilTypeExpression

public java.lang.Object visitVilTypeExpression(VilTypeExpression typeExpression)
                                        throws VilException

Description copied from interface: IExpressionVisitor

Visits a VIL type expression.

Specified by:

visitVilTypeExpression in interface IExpressionVisitor

Parameters:

typeExpression - the expression

Returns:

the result of visiting this expression (may be null)

Throws:

VilException - in case that visiting fails (e.g., execution)

visitVariableExpression

public java.lang.Object visitVariableExpression(VariableExpression cst)
                                         throws VilException

Description copied from interface: IExpressionVisitor

Visits a constant node.

Specified by:

visitVariableExpression in interface IExpressionVisitor

Parameters:

cst - the node

Returns:

the result of visiting the given statement (may be null)

Throws:

VilException - in case that visiting fails (e.g., execution)

visitExpression

public java.lang.Object visitExpression(Expression ex)
                                 throws VilException

Description copied from interface: IExpressionVisitor

Visits an unspecified expression (in case of specialized nodes).

Specified by:

visitExpression in interface IExpressionVisitor

Parameters:

ex - the node

Returns:

the result of visiting this expression (may be null)

Throws:

VilException - in case that visiting fails (e.g., execution)

visitExpressionEvaluator

public java.lang.Object visitExpressionEvaluator(ExpressionEvaluator ex)
                                          throws VilException

Description copied from interface: IExpressionVisitor

Visits an expression evaluator.

Specified by:

visitExpressionEvaluator in interface IExpressionVisitor

Parameters:

ex - the evaluator

Returns:

the result of visiting this expression (may be null)

Throws:

VilException - in case that visiting fails (e.g., execution)

visitValueAssignmentExpression

public java.lang.Object visitValueAssignmentExpression(ValueAssignmentExpression ex)
                                                throws VilException

Description copied from interface: IExpressionVisitor

Visits a value assignment expression.

Specified by:

visitValueAssignmentExpression in interface IExpressionVisitor

Parameters:

ex - the expression

Returns:

the result of visiting the given statement (may be null)

Throws:

VilException - in case that visiting fails (e.g., execution)

notifyValueDefined

protected void notifyValueDefined(VariableDeclaration var,
                                  FieldDescriptor field,
                                  java.lang.Object val)

Is called when a value of a value is defined.

Parameters:

var - the variable

field - the field in var, may be null

val - the value

visitContainerInitializerExpression

public java.lang.Object visitContainerInitializerExpression(ContainerInitializerExpression ex)
                                                     throws VilException

Description copied from interface: IExpressionVisitor

Visits a container initializer expression.

Specified by:

visitContainerInitializerExpression in interface IExpressionVisitor

Parameters:

ex - the expression

Returns:

the result of visiting the given statement (may be null)

Throws:

VilException - in case that visiting fails (e.g., execution)

visitCompositeExpression

public java.lang.Object visitCompositeExpression(CompositeExpression ex)
                                          throws VilException

Description copied from interface: IExpressionVisitor

Visits a composite expression.

Specified by:

visitCompositeExpression in interface IExpressionVisitor

Parameters:

ex - the expression

Returns:

the result of visiting the given statement

Throws:

VilException - in case that visiting fails (e.g., execution)

evaluateContentExpression

protected java.lang.String evaluateContentExpression(IExpressionIterator iter)
                                              throws VilException

Evaluates iter as a content expression.

Parameters:

iter - the iterator

Returns:

the evaluation result

Throws:

VilException - if evaluation fails

lastContentReplaceEmptyLine

protected boolean lastContentReplaceEmptyLine()

Returns whether the last content commands that empty lines (itself empty, following line breaks) shall be removed.

Returns:

true for remove, false else

appendInCompositeExpression

protected java.lang.String appendInCompositeExpression(java.lang.String s1,
                                                       Expression e1,
                                                       java.lang.Object v1,
                                                       java.lang.String s2,
                                                       Expression e2)

Appends s2 to s2 originating from the respective expressions. This allows to potentially consider indentation formatting.

Parameters:

s1 - the first string

e1 - the expression causing s1

v1 - the value causting s1

s2 - the string to append

e2 - the expression causing s2

Returns:

the appended string

visitFieldAccessExpression

public java.lang.Object visitFieldAccessExpression(FieldAccessExpression ex)
                                            throws VilException

Description copied from interface: IExpressionVisitor

Visits a field access expression.

Specified by:

visitFieldAccessExpression in interface IExpressionVisitor

Parameters:

ex - the expression

Returns:

the result of visiting the given statement (may be null)

Throws:

VilException - in case that visiting fails (e.g., execution)

visitResolvableOperationExpression

public java.lang.Object visitResolvableOperationExpression(ResolvableOperationExpression ex)
                                                    throws VilException

Description copied from interface: IExpressionVisitor

Visits resolvable operation expression (function pointer resolution).

Specified by:

visitResolvableOperationExpression in interface IExpressionVisitor

Parameters:

ex - the expression

Returns:

the result of visiting the given statement (may be null)

Throws:

VilException - in case that visiting fails (e.g., execution)

visitResolvableOperationCallExpression

public java.lang.Object visitResolvableOperationCallExpression(ResolvableOperationCallExpression ex)
                                                        throws VilException

Description copied from interface: IExpressionVisitor

Visits resolvable operation call expression (function pointer call).

Specified by:

visitResolvableOperationCallExpression in interface IExpressionVisitor

Parameters:

ex - the expression

Returns:

the result of visiting the given statement (may be null)

Throws:

VilException - in case that visiting fails (e.g., execution)

visitMultiAndExpression

public java.lang.Object visitMultiAndExpression(MultiAndExpression ex)
                                         throws VilException

Description copied from interface: IExpressionVisitor

Visits a multi-and expression.

Specified by:

visitMultiAndExpression in interface IExpressionVisitor

Parameters:

ex - the expression

Returns:

the result of visiting the given statement (may be null)

Throws:

VilException - in case that visiting fails (e.g., execution)