com.whitestein.lsps.engine.lang

Class AbstractExecutionContext

java.lang.Object

com.whitestein.lsps.engine.lang.AbstractExecutionContext

All Implemented Interfaces:

HandleResolver, ExecutionContext, TraceableExecution

Direct Known Subclasses:

ExecutionContextImpl, MockExecutionContext

public abstract class AbstractExecutionContext
extends Object
implements ExecutionContext

This class contains functionality of ExecutionContext that should be common to all its implementations.

Author:

rba

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractExecutionContext() Creates new instance.
protected	AbstractExecutionContext(InterpreterStackTrace stackTrace)

Method Summary

Modifier and Type	Method and Description
protected abstract NamespaceModel	getNamespaceModel() Returns namespace model for this context.
InterpreterStackTrace	getStackTrace() Returns the interpreter stack trace.
String[]	getStackTraceInfo() Returns the stack trace info from the interpreter stack trace.
Object	getVariableValue(QID name) Resolves variable for given name and returns its value.
Object	getVariableValue(String name) Deprecated.
Namespace	resolveVariableNamespace(QID qid) Resolves variable for given name and returns its containing namespace.
Namespace	resolveVariableNamespace(String name) Deprecated.
void	setVariableValue(QID name, Object value) Resolves variable for given name and sets its value.
void	setVariableValue(String name, Object value) Deprecated.
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.whitestein.lsps.engine.lang.ExecutionContext

addSignal, flushAll, getCompiled, getCompiled, getComponentService, getContextId, getConverter, getEvaluationLevel, getInLevel, getModelElement, getModelInstance, getModelProvider, getNamespace, getParentContext, getPath, getPathQID, getProcessInstance, getProcessModel, getProcessPath, getProcessPathQID, setCompiled

Methods inherited from interface com.whitestein.lsps.engine.dto.HandleResolver

getHandle, getValueHolder

Methods inherited from interface com.whitestein.lsps.engine.lang.TraceableExecution

addExecutionTrace, addExecutionTraceElement, getExecutionTrace

Constructor Detail

AbstractExecutionContext

protected AbstractExecutionContext()

Creates new instance.

AbstractExecutionContext

protected AbstractExecutionContext(InterpreterStackTrace stackTrace)

Method Detail

resolveVariableNamespace

@Deprecated
public Namespace resolveVariableNamespace(String name)

Deprecated.

Description copied from interface: ExecutionContext

Resolves variable for given name and returns its containing namespace.

The resolution goes primarily into parents, if it fails then it looks in the imports. The resolution throws IllegalArgumentException if the variable is not found or the name is ambiguous.

Known issue: The name parameter should be unescaped name. The method may not work correctly if the variable name is a full name (i.e. with module prefix) and contains special characters.

Specified by:

resolveVariableNamespace in interface ExecutionContext

Parameters:

name - variable name

Returns:

resolved variable namespace

resolveVariableNamespace

public Namespace resolveVariableNamespace(QID qid)

Description copied from interface: ExecutionContext

Resolves variable for given name and returns its containing namespace.

The resolution goes primarily into parents, if it fails then it looks in the imports. The resolution throws IllegalArgumentException if the variable is not found or the name is ambiguous.

Specified by:

resolveVariableNamespace in interface ExecutionContext

Parameters:

qid - variable name

Returns:

resolved variable namespace

getNamespaceModel

protected abstract NamespaceModel getNamespaceModel()

Returns namespace model for this context.

Returns:

namespace model for this context

getVariableValue

public Object getVariableValue(QID name)

Description copied from interface: ExecutionContext

Resolves variable for given name and returns its value.

Difference between this method and Namespace.getVariableValue(String) is that the latter return only value directly from its namespace while this one does resolution of namespace and calls Namespace.getVariableValue(String) on the resolved namespace.

Specified by:

getVariableValue in interface ExecutionContext

Parameters:

name - a variable name

Returns:

the variable value

setVariableValue

public void setVariableValue(QID name,
                             Object value)

Description copied from interface: ExecutionContext

Resolves variable for given name and sets its value.

Difference between this method and Namespace.setVariableValue(String, Object) is that the latter sets variable directly from its namespace while this one does resolution of namespace and calls Namespace.setVariableValue(String, Object) on the resolved namespace.

Specified by:

setVariableValue in interface ExecutionContext

Parameters:

name - a variable name

value - a new variable value

getVariableValue

@Deprecated
public Object getVariableValue(String name)

Deprecated.

Description copied from interface: ExecutionContext

Resolves variable for given name and returns its value.

Difference between this method and Namespace.getVariableValue(String) is that the latter return only value directly from its namespace while this one does resolution of namespace and calls Namespace.getVariableValue(String) on the resolved namespace.

Known issue: The name parameter should be unescaped name. The method may not work correctly if the variable name is a full name (i.e. with module prefix) and contains special characters.

Specified by:

getVariableValue in interface ExecutionContext

Parameters:

name - a variable name

Returns:

the variable value

setVariableValue

@Deprecated
public void setVariableValue(String name,
                                         Object value)

Deprecated.

Description copied from interface: ExecutionContext

Resolves variable for given name and sets its value.

Difference between this method and Namespace.setVariableValue(String, Object) is that the latter sets variable directly from its namespace while this one does resolution of namespace and calls Namespace.setVariableValue(String, Object) on the resolved namespace.

Known issue: The name parameter should be unescaped name. The method may not work correctly if the variable name is a full name (i.e. with module prefix) and contains special characters.

Specified by:

setVariableValue in interface ExecutionContext

Parameters:

name - a variable name

value - a new variable value

getStackTrace

public InterpreterStackTrace getStackTrace()

Description copied from interface: ExecutionContext

Returns the interpreter stack trace. Custom Java function should use this stack trace to pass it further when evaluating closures or filling the stack trace of error exceptions.

The method returns null if the execution context is not a JavaOperationExecutionContext.

Specified by:

getStackTrace in interface ExecutionContext

Returns:

the interpreter stack trace, may be null

getStackTraceInfo

public final String[] getStackTraceInfo()

Description copied from interface: ExecutionContext

Returns the stack trace info from the interpreter stack trace.

Should be equivalent to

 return getStackTrace() != null ? getStackTrace().getStackTraceInfo() : null;
 

Specified by:

getStackTraceInfo in interface ExecutionContext

Returns:

the stack trace info

toString

public String toString()

Overrides:

toString in class Object