com.whitestein.lsps.engine

Interface AsynchronousExecutionTask

All Superinterfaces:

ExecutableTask

All Known Implementing Classes:

AbstractAsynchronousExecutionTask, HttpClientTask, WsSoapCall

public interface AsynchronousExecutionTask
extends ExecutableTask

Local interface of AbstractAsynchronousExecutionTask

Author:

mbj

Nested Class Summary

Nested classes/interfaces inherited from interface com.whitestein.lsps.engine.ExecutableTask

ExecutableTask.Result

Method Summary

Modifier and Type	Method and Description
Serializable	collectDataForExecution(TaskContext context) Collects data from task context for asynchronous execution.
boolean	executeAsynchronously(TaskContext context) Determines, based on current task context (params, metadata, etc.) if the exeuction should be done asynchronously.
Serializable	processDataAsynchronously(Serializable data) Process data collected in collectDataForExecution(com.whitestein.lsps.engine.lang.TaskContext).
void	processExecutionResult(TaskContext context, Serializable result) This method is called after the asynchronous execution has been done

Methods inherited from interface com.whitestein.lsps.engine.ExecutableTask

processInput, start, terminate

Method Detail

collectDataForExecution

Serializable collectDataForExecution(TaskContext context)
                              throws ErrorException

Collects data from task context for asynchronous execution. These data will be used to invoke processDataAsynchronously(java.io.Serializable) method asynchronously.

Parameters:

context -

Returns:

data that will be used in asynchronous execution

Throws:

ErrorException

processExecutionResult

void processExecutionResult(TaskContext context,
                            Serializable result)
                     throws ErrorException

This method is called after the asynchronous execution has been done

Parameters:

context -

result - result of asynchronous call of method processDataAsynchronously(java.io.Serializable)

Throws:

ErrorException

processDataAsynchronously

Serializable processDataAsynchronously(Serializable data)

Process data collected in collectDataForExecution(com.whitestein.lsps.engine.lang.TaskContext). This execution is done asynchronously outside of process model. The result of this execution is afterwards sent back to task (processExecutionResult(com.whitestein.lsps.engine.lang.TaskContext, java.io.Serializable)) so that the computed results can be processed and any necessary changes in model instance can be done. This method should not throw ErrorException since it is not executed in model instance context.

Parameters:

data - data to process

Returns:

result of execution

executeAsynchronously

boolean executeAsynchronously(TaskContext context)
                       throws ErrorException

Determines, based on current task context (params, metadata, etc.) if the exeuction should be done asynchronously. If true, method processDataAsynchronously(java.io.Serializable) will be executed outside model instance (thus not blocking transaction, model execution, etc.}. If false it will be called directly.

Parameters:

context -

Returns:

true if the execution should be performed asynchronously, false otherwise

Throws:

ErrorException