com.whitestein.lsps.engine.lang.compiled

Class CompiledContext

java.lang.Object

com.whitestein.lsps.engine.lang.compiled.CompiledNamespace

com.whitestein.lsps.engine.lang.compiled.CompiledContext

All Implemented Interfaces:

HandleResolver, ExecutionContext, TraceableExecution

Direct Known Subclasses:

AdditionalExpressionCompiledContext

public abstract class CompiledContext
extends CompiledNamespace
implements ExecutionContext

Java class that represents execution context in the generated java code.

Author:

bhl

Constructor Summary

Constructors

Constructor and Description
CompiledContext(ExecutionContext ctx) Creates new instance.

Method Summary

Modifier and Type	Method and Description
void	addExecutionTrace(ExecutionTrace et) Adds ExecutionTrace to the context.
void	addExecutionTraceElement(ExecutionTraceElement e) Adds ExecutionTraceElement to the context.
void	addSignal(Object signal) Adds a signal to the signal queue.
void	flushAll() Flush of all sessions (core, org, human,...
CompiledContext	getCompiled()
CompiledContext	getCompiled(String moduleName)
CompiledContext	getCompiledContext() Returns this compiled context.
long	getContextId() Returns the context id.
ExecutionTrace	getExecutionTrace()
Handle	getHandle(ValueHolder valueHolder) Returns a serializable handle for the given value-holder.
com.whitestein.lsps.model.ContextModelElement	getModelElement() Returns the corresponding context model element.
ModelInstance	getModelInstance() Returns the model instance.
ExecutionContext	getParentContext() Returns the parent execution context or null if it does not exist.
String	getPath() Returns the full path to this context as a string.
QID	getPathQID() Returns the full path to this context as a QID.
ProcessInstance	getProcessInstance() Returns the process instance.
protected abstract QID	getQID()
InterpreterStackTrace	getStackTrace() Returns the interpreter stack trace.
String[]	getStackTraceInfo() Returns the stack trace info from the interpreter stack trace.
ValueHolder	getValueHolder(Handle handle) Returns a value-holder for the given handle.
Object	getVariableValue(QID name) Resolves variable for given name and returns its value.
Object	getVariableValue(String name) Deprecated.
void	persist(ValueHolder object) When getting ValueHolders from the context, they may be later garbage collected.
Namespace	resolveVariableNamespace(QID name) Resolves variable for given name and returns its containing namespace.
Namespace	resolveVariableNamespace(String name) Deprecated.
protected ExecutionContext	selectContext(ExecutionContext ctx)
void	setCompiled(CompiledContext compiledContext)
void	setVariableValue(QID name, Object value) Resolves variable for given name and sets its value.
void	setVariableValue(String name, Object value) Deprecated.

Methods inherited from class com.whitestein.lsps.engine.lang.compiled.CompiledNamespace

addVariable, addVariable, checkRollback, checkRollback, createChildContext, createList, createList, createMap, createMap, createOperationHolder, createOperationHolder, createOperationHolder, createOperationHolder, createRecord, createRecord, createRecordByConstructor, createRecordByConstructor, createReference, createSet, createSet, getCompiledContext, getComponent, getComponent, getConstantValue, getConstantValue, getEvaluationLevel, getEvaluationLevel, getExecutionContext, getModelId, getModelId, getModelProviderService, getModelProviderService, getNamespace, getNamespace, getProcessModel, getProcessModel, getPropertySafe, getReferencedOperation, getReferencedOperation, getStaticVariableValue, getType, getType, getVariableValue, getVariableValue, nullsOrEquals, requireNonNull, special, toboolean, toboolean, toBoolean, toBoolean, toCompiled, toCompiled, toCompiledObject, toCompiledObject

Methods inherited from class java.lang.Object

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

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

getComponentService, getEvaluationLevel, getModelProviderService, getNamespace, getProcessModel

Constructor Detail

CompiledContext

public CompiledContext(ExecutionContext ctx)

Creates new instance.

Parameters:

ctx -

Method Detail

getCompiledContext

public CompiledContext getCompiledContext()

Returns this compiled context.

Specified by:

getCompiledContext in class CompiledNamespace

Returns:

this compiled context

getCompiled

public CompiledContext getCompiled()

Specified by:

getCompiled in interface ExecutionContext

setCompiled

public void setCompiled(CompiledContext compiledContext)

Specified by:

setCompiled in interface ExecutionContext

getQID

protected abstract QID getQID()

selectContext

protected ExecutionContext selectContext(ExecutionContext ctx)

Overrides:

selectContext in class CompiledNamespace

getHandle

public Handle getHandle(ValueHolder valueHolder)

Description copied from interface: HandleResolver

Returns a serializable handle for the given value-holder. The holder can be obtained back using HandleResolver.getValueHolder(Handle).

Specified by:

getHandle in interface HandleResolver

Parameters:

valueHolder - the value-holder

Returns:

the handle

getValueHolder

public ValueHolder getValueHolder(Handle handle)

Description copied from interface: HandleResolver

Returns a value-holder for the given handle.

Specified by:

getValueHolder in interface HandleResolver

Parameters:

handle - the handle

Returns:

the value-holder

addExecutionTraceElement

public void addExecutionTraceElement(ExecutionTraceElement e)

Description copied from interface: TraceableExecution

Adds ExecutionTraceElement to the context. See ExecutionTrace and ExecutionTraceElement.

Specified by:

addExecutionTraceElement in interface TraceableExecution

Parameters:

e - ExecutionTraceElement to be added.

addExecutionTrace

public void addExecutionTrace(ExecutionTrace et)

Description copied from interface: TraceableExecution

Adds ExecutionTrace to the context. See ExecutionTrace and ExecutionTraceElement.

Specified by:

addExecutionTrace in interface TraceableExecution

Parameters:

et - ExecutionTrace to be added.

getExecutionTrace

public ExecutionTrace getExecutionTrace()

Specified by:

getExecutionTrace in interface TraceableExecution

Returns:

Returns ExecutionTrace. See ExecutionTrace and ExecutionTraceElement.

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

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

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

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

resolveVariableNamespace

public Namespace resolveVariableNamespace(QID name)

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:

name - variable name

Returns:

resolved variable namespace

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

addSignal

public void addSignal(Object signal)

Description copied from interface: ExecutionContext

Adds a signal to the signal queue.

Specified by:

addSignal in interface ExecutionContext

getModelElement

public com.whitestein.lsps.model.ContextModelElement getModelElement()

Description copied from interface: ExecutionContext

Returns the corresponding context model element.

Specified by:

getModelElement in interface ExecutionContext

Returns:

the corresponding context model element

getContextId

public long getContextId()

Description copied from interface: ExecutionContext

Returns the context id. The context id is unique for all running processes.

Specified by:

getContextId in interface ExecutionContext

Returns:

the context id

getParentContext

public ExecutionContext getParentContext()

Description copied from interface: ExecutionContext

Returns the parent execution context or null if it does not exist.

Specified by:

getParentContext in interface ExecutionContext

Returns:

the parent execution context or null if it does not exist

persist

public void persist(ValueHolder object)

Description copied from interface: ExecutionContext

When getting ValueHolders from the context, they may be later garbage collected. This method ensures that the object will never be garbage collected.

Specified by:

persist in interface ExecutionContext

Parameters:

object - object to make persistent

getPathQID

public QID getPathQID()

Description copied from interface: ExecutionContext

Returns the full path to this context as a QID.

Specified by:

getPathQID in interface ExecutionContext

Returns:

the full path to this context as a QID

getPath

public String getPath()

Description copied from interface: ExecutionContext

Returns the full path to this context as a string.

Specified by:

getPath in interface ExecutionContext

Returns:

the full path to this context as a string

getModelInstance

public ModelInstance getModelInstance()

Description copied from interface: ExecutionContext

Returns the model instance.

Specified by:

getModelInstance in interface ExecutionContext

Overrides:

getModelInstance in class CompiledNamespace

Returns:

the model instance

getProcessInstance

public ProcessInstance getProcessInstance()

Description copied from interface: ExecutionContext

Returns the process instance.

Specified by:

getProcessInstance in interface ExecutionContext

Returns:

the process instance

flushAll

public void flushAll()

Description copied from interface: ExecutionContext

Flush of all sessions (core, org, human,... and sessions for all shared records).

Specified by:

flushAll in interface ExecutionContext

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 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

getCompiled

public CompiledContext getCompiled(String moduleName)

Specified by:

getCompiled in interface ExecutionContext