com.whitestein.lsps.stdlib.function

Class ActionFunctionsImpl

java.lang.Object

com.whitestein.lsps.stdlib.function.ActionFunctionsImpl

All Implemented Interfaces:

ActionFunctions

@PermitAll
public class ActionFunctionsImpl
extends Object
implements ActionFunctions

Implementation of ActionFunctions.

Author:

bhl

Constructor Summary

Constructors

Constructor and Description
ActionFunctionsImpl()

Method Summary

Modifier and Type	Method and Description
void	cleanEvaluation(ExecutionContext ctx) Cleans auxiliary contexts and values used by the evaluation in the 'isFullExecutionMode = false' mode.
ClosureHolder	compileClosure(ExecutionContext ctx, String closureString)
RecordHolder	createInstance(ExecutionContext ctx, Type type, MapHolder values) Creates new instance of record type T.
RecordHolder	createModelInstance(ExecutionContext ctx, Boolean synchronous, RecordHolder model, MapHolder properties) Creates a model instance.
RecordHolder	createModelInstance(ExecutionContext ctx, Boolean synchronous, RecordHolder model, RecordHolder processEntity, MapHolder properties) Creates a model instance with a specified process entity record.
void	createProxyOfProperties(ExecutionContext ctx, RecordHolder record, Property... properties) Creates change proxy for all object referenced by the property and sets the proxy values to the property.
RecordProxySetHolder	createProxySet(ExecutionContext ctx, RecordHolder parentProxySet) Creates new record proxy set.
void	createWithProxySetStart(RecordHolder proxySet)
void	createWithProxySetStop(RecordHolder proxySet)
String	debugLog(ExecutionContext ctx, ClosureHolder message) Logs a message to the console at the debug logging level.
String	debugLog(ExecutionContext ctx, ClosureHolder message, Decimal level) Logs a message to the console at the specified logging level.
void	deleteAllRecords(ExecutionContext ctx, CollectionHolder records) Deletes the specified records and all related data links navigable from the deleted records.
void	deleteRecords(ExecutionContext ctx, RecordHolder... records) Deletes the specified records and all related data links navigable from the deleted records.
Object	evaluateExpression(ExecutionContext ctx, Boolean isFullExecutionMode, ClosureHolder expression) This method evaluates an expression defined in the closure using defined evaluationMode.
void	flushAndRefresh(ExecutionContext ctx, RecordHolder... record) Executes flush on all relevant sessions and performs refresh (re-read from database) on the specified records.
RecordHolder	getCommonProxySet()
RecordHolder	getProxiedRecord(Object proxy) Returns proxied record of the proxy.
Decimal	getProxyLevel(RecordHolder record) Returns proxy level of the record.
RecordProxySetHolder	getProxySet(RecordHolder record) Returns RecordProxySetHolder for the record.
void	log(ExecutionContext ctx, String message, Decimal level) Logs a message to the application log on specified level.
ListHolder	mergeAllProxies(ExecutionContext ctx, Boolean checkConflicts, CollectionHolder records) Merges changes from the proxies to the proxied records.
void	mergeEvaluation(ExecutionContext ctx) Merges auxiliary contexts and values to the original execution contexts and values.
ListHolder	mergeProxies(ExecutionContext ctx, Boolean checkConflicts, Object... records) Merges changes from the proxies to the proxied records.
void	notifyModelInstance(ExecutionContext ctx, Decimal modelInstanceId, String reason, Boolean synchronously) Notify provided model instance.
void	removeFromProxySet(RecordHolder record) Remove the record from the proxySet the record is included in.
void	sendSignal(ExecutionContext ctx, Boolean synchronous, SetHolder receivers, Object signal) Sends a sync or async signal to receivers.
void	setCommonProxySet(RecordHolder proxySet)
void	throwEscalation(ExecutionContext ctx, String escalationCode, Object payload) Throws an escalation event with the escalation code and optional payload.

Methods inherited from class java.lang.Object

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

Constructor Detail

ActionFunctionsImpl

public ActionFunctionsImpl()

Method Detail

sendSignal

public void sendSignal(ExecutionContext ctx,
                       Boolean synchronous,
                       SetHolder receivers,
                       Object signal)
                throws ErrorException

Description copied from interface: ActionFunctions

Sends a sync or async signal to receivers.

Specified by:

sendSignal in interface ActionFunctions

Throws:

ErrorException

createModelInstance

public RecordHolder createModelInstance(ExecutionContext ctx,
                                        Boolean synchronous,
                                        RecordHolder model,
                                        MapHolder properties)
                                 throws ErrorException

Description copied from interface: ActionFunctions

Creates a model instance.

Specified by:

createModelInstance in interface ActionFunctions

Returns:

created model instance

Throws:

ErrorException

createModelInstance

public RecordHolder createModelInstance(ExecutionContext ctx,
                                        Boolean synchronous,
                                        RecordHolder model,
                                        RecordHolder processEntity,
                                        MapHolder properties)
                                 throws ErrorException

Description copied from interface: ActionFunctions

Creates a model instance with a specified process entity record.

Specified by:

createModelInstance in interface ActionFunctions

Returns:

the created model instance

Throws:

ErrorException

notifyModelInstance

public void notifyModelInstance(ExecutionContext ctx,
                                Decimal modelInstanceId,
                                String reason,
                                Boolean synchronously)
                         throws ErrorException

Description copied from interface: ActionFunctions

Notify provided model instance.

Specified by:

notifyModelInstance in interface ActionFunctions

reason - string used for logging

Throws:

ErrorException

log

public void log(ExecutionContext ctx,
                String message,
                Decimal level)
         throws ErrorException

Description copied from interface: ActionFunctions

Logs a message to the application log on specified level.

Specified by:

log in interface ActionFunctions

Throws:

ErrorException

debugLog

public String debugLog(ExecutionContext ctx,
                       ClosureHolder message)
                throws ErrorException

Description copied from interface: ActionFunctions

Logs a message to the console at the debug logging level. If logging is not enabled for the debug level, the message closure is not even evaluated. The function returns a string that was logged, or null if the message was not logged. Logs given message through java.util.logging subsystem on Level.FINE.

Specified by:

debugLog in interface ActionFunctions

Returns:

The message as a string.

Throws:

ErrorException

debugLog

public String debugLog(ExecutionContext ctx,
                       ClosureHolder message,
                       Decimal level)
                throws ErrorException

Description copied from interface: ActionFunctions

Logs a message to the console at the specified logging level. If logging is not enabled at the specified level, the message closure is not even evaluated. The function returns a string that was logged, or null if the message was not logged. Logs given message through java.util.logging subsystem on specified level. level <= 100 -> Level.FINE level <= 200 -> Level.INFO level <= 300 -> Level.WARNING level <= 400 -> Level.SEVERE

Specified by:

debugLog in interface ActionFunctions

Returns:

The message as a string.

Throws:

ErrorException

evaluateExpression

public Object evaluateExpression(ExecutionContext ctx,
                                 Boolean isFullExecutionMode,
                                 ClosureHolder expression)
                          throws ErrorException

Description copied from interface: ActionFunctions

This method evaluates an expression defined in the closure using defined evaluationMode. If the isFullExecutionMode = true then the expression is evaluated in an ordinary execution context in which this function is called. SharedRecords are treated as in standard execution. If the isFullExecutionMode = false the expression is executed in an auxiliary execution contexts. The original contexts of the model instance are not affected. The auxiliary contexts and values are stored in the model instance, so they are persisted together with the model instance. Shared records are not created, instead an auxiliary (non-shared) records are used. Therefore shared records created during evaluation are not returned by queries. Auxiliary contexts and values can be cleaned, all auxiliary contexts and values are removed from the model instance. In such a case all changes caused by the evaluation are removed. Auxiliary contexts and values can be merged to the original execution contexts and values. After such merge the auxiliary contexts and values are cleaned. During the merge shared records are created for all shared records created during evaluation. Evaluation of an expression in 'isFullexecutionMode = false' mode and merging it to original context is not fully equivalent to the evaluation of the expression in the 'isFullExecutionMode = true' mode as the execution of queries can have different results. If the result of the execution is not of a simple type. It will be discarded by a cleanEvaluation method.

Specified by:

evaluateExpression in interface ActionFunctions

Returns:

result of evaluation

Throws:

ErrorException

cleanEvaluation

public void cleanEvaluation(ExecutionContext ctx)

Description copied from interface: ActionFunctions

Cleans auxiliary contexts and values used by the evaluation in the 'isFullExecutionMode = false' mode. All auxiliary contexts and values are removed from the model instance. In such a case all changes caused by the evaluation are removed.

Specified by:

cleanEvaluation in interface ActionFunctions

mergeEvaluation

public void mergeEvaluation(ExecutionContext ctx)
                     throws ErrorException

Description copied from interface: ActionFunctions

Merges auxiliary contexts and values to the original execution contexts and values. After such merge the auxiliary contexts and values are cleaned. During the merge shared records are created for all shared records created during evaluation.

Specified by:

mergeEvaluation in interface ActionFunctions

Throws:

ErrorException

deleteAllRecords

public void deleteAllRecords(ExecutionContext ctx,
                             CollectionHolder records)
                      throws ErrorException

Description copied from interface: ActionFunctions

Deletes the specified records and all related data links navigable from the deleted records. Works for shared and for non-shared records. Value of deleted records become null in all slots (variables, function or task call parameters, etc.) referring to that records.

Specified by:

deleteAllRecords in interface ActionFunctions

Throws:

ErrorException

deleteRecords

public void deleteRecords(ExecutionContext ctx,
                          RecordHolder... records)
                   throws ErrorException

Description copied from interface: ActionFunctions

Deletes the specified records and all related data links navigable from the deleted records. Works for shared and for non-shared records. Value of deleted records become null in all slots (variables, function or task call parameters, etc.) referring to that records.

Specified by:

deleteRecords in interface ActionFunctions

Throws:

ErrorException

throwEscalation

public void throwEscalation(ExecutionContext ctx,
                            String escalationCode,
                            Object payload)
                     throws ErrorException

Description copied from interface: ActionFunctions

Throws an escalation event with the escalation code and optional payload. The escalation code can be used by the escalation handler to decide whether to handle the escalation or not.* The payload allows to provide additional information for the escalation handler about the escalation event.

Specified by:

throwEscalation in interface ActionFunctions

escalationCode - the code of the escalation

payload - the escalation payload (optional)

Throws:

ErrorException

createInstance

public RecordHolder createInstance(ExecutionContext ctx,
                                   Type type,
                                   MapHolder values)
                            throws ErrorException

Description copied from interface: ActionFunctions

Creates new instance of record type T. If the properties are specified, the instance is initialized with the specified values of properties.

Specified by:

createInstance in interface ActionFunctions

Returns:

RecordHolder

Throws:

ErrorException

createProxySet

public RecordProxySetHolder createProxySet(ExecutionContext ctx,
                                           RecordHolder parentProxySet)

Description copied from interface: ActionFunctions

Creates new record proxy set.

Specified by:

createProxySet in interface ActionFunctions

Returns:

new record proxy set

createProxyOfProperties

public void createProxyOfProperties(ExecutionContext ctx,
                                    RecordHolder record,
                                    Property... properties)
                             throws ErrorException

Description copied from interface: ActionFunctions

Creates change proxy for all object referenced by the property and sets the proxy values to the property. If there are no listed properties the action is executed for all properties of the record type.

Specified by:

createProxyOfProperties in interface ActionFunctions

Throws:

ErrorException

getProxiedRecord

public RecordHolder getProxiedRecord(Object proxy)

Description copied from interface: ActionFunctions

Returns proxied record of the proxy.

Specified by:

getProxiedRecord in interface ActionFunctions

Returns:

proxied record.

getProxySet

public RecordProxySetHolder getProxySet(RecordHolder record)

Description copied from interface: ActionFunctions

Returns RecordProxySetHolder for the record. If the record is not a proxy it returns null;

Specified by:

getProxySet in interface ActionFunctions

Returns:

record proxy for the record

removeFromProxySet

public void removeFromProxySet(RecordHolder record)

Description copied from interface: ActionFunctions

Remove the record from the proxySet the record is included in.

Specified by:

removeFromProxySet in interface ActionFunctions

getProxyLevel

public Decimal getProxyLevel(RecordHolder record)

Description copied from interface: ActionFunctions

Returns proxy level of the record.

Specified by:

getProxyLevel in interface ActionFunctions

Returns:

proxy level of the record

setCommonProxySet

public void setCommonProxySet(RecordHolder proxySet)

Specified by:

setCommonProxySet in interface ActionFunctions

getCommonProxySet

public RecordHolder getCommonProxySet()

Specified by:

getCommonProxySet in interface ActionFunctions

createWithProxySetStart

public void createWithProxySetStart(RecordHolder proxySet)

Specified by:

createWithProxySetStart in interface ActionFunctions

createWithProxySetStop

public void createWithProxySetStop(RecordHolder proxySet)

Specified by:

createWithProxySetStop in interface ActionFunctions

mergeProxies

public ListHolder mergeProxies(ExecutionContext ctx,
                               Boolean checkConflicts,
                               Object... records)
                        throws LspsException

Description copied from interface: ActionFunctions

Merges changes from the proxies to the proxied records.

Specified by:

mergeProxies in interface ActionFunctions

Returns:

returns proxied records with applied changes

Throws:

LspsException

mergeAllProxies

public ListHolder mergeAllProxies(ExecutionContext ctx,
                                  Boolean checkConflicts,
                                  CollectionHolder records)
                           throws LspsException

Description copied from interface: ActionFunctions

Merges changes from the proxies to the proxied records.

Specified by:

mergeAllProxies in interface ActionFunctions

Returns:

returns proxied records with applied changes

Throws:

LspsException

flushAndRefresh

public void flushAndRefresh(ExecutionContext ctx,
                            RecordHolder... record)

Description copied from interface: ActionFunctions

Executes flush on all relevant sessions and performs refresh (re-read from database) on the specified records.

Specified by:

flushAndRefresh in interface ActionFunctions

compileClosure

public ClosureHolder compileClosure(ExecutionContext ctx,
                                    String closureString)
                             throws ValidationException

Specified by:

compileClosure in interface ActionFunctions

Throws:

ValidationException