com.whitestein.lsps.wsserver.task

Class WsRequestWaitPointTask

java.lang.Object

com.whitestein.lsps.wsserver.task.WsRequestWaitPointTask

All Implemented Interfaces:

ExecutableTask

@PermitAll
public class WsRequestWaitPointTask
extends java.lang.Object
implements ExecutableTask

This task implements the behavior of waiting for the web service request. If placed into process, this task will register the WsRequestWaitPoint object in database, which signalize, that the process is waiting for particular web service invocation. After the invocation, the content of soap request is transformed into lsps variable and stored into process context via the task parameter input - this parameter is reference of variable which will be used to store the request data. This task contains following fields:

• requestId : ReferenceHolder object, It is the reference to the variable where the id of request should be stored
• input : ReferenceHolder object. It is the reference to the variable where the input from the webservice call should be stored
• principal : ReferenceHolder object. It is the reference to the variable where the principal performing the webservice call should be stored

Author:

mbj

Nested Class Summary

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

ExecutableTask.Result

Constructor Summary

Constructors

Constructor and Description
WsRequestWaitPointTask() Creates new instance.
WsRequestWaitPointTask(WsRequestHandlerDao wsRequestHandlerDao, BinaryDataServiceLocal binaryDataService) Creates new instance.

Method Summary

Modifier and Type	Method and Description
ExecutableTask.Result	processInput(TaskContext context, java.lang.Object in) The method for processing the model instance input.
ExecutableTask.Result	start(TaskContext context) This method starts the task - it only register the WsRequestWaitPoint (i.e.
void	terminate(TaskContext context, TerminationReason reason) Called when this task is to be terminated.

Methods inherited from class java.lang.Object

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

Constructor Detail

WsRequestWaitPointTask

public WsRequestWaitPointTask()

Creates new instance.

WsRequestWaitPointTask

public WsRequestWaitPointTask(WsRequestHandlerDao wsRequestHandlerDao,
                              BinaryDataServiceLocal binaryDataService)

Creates new instance.

Parameters:

wsRequestHandlerDao -

binaryDataService -

Throws:

java.lang.NullPointerException - if any of the arguments is null

Method Detail

start

public ExecutableTask.Result start(TaskContext context)
                            throws ErrorException

This method starts the task - it only register the WsRequestWaitPoint (i.e. persists the information that the process is waiting for request) and waits for the request. After receiving, the request is parsed and stored into variable determined by parameter input. Also the principal performing the web service request is stored and the requestId. The requestId is later used to identify the request belonging to given web service response.

Specified by:

start in interface ExecutableTask

Returns:

result of execution, must not be null

Throws:

ErrorException

processInput

public ExecutableTask.Result processInput(TaskContext context,
                                          java.lang.Object in)
                                   throws ErrorException

Description copied from interface: ExecutableTask

The method for processing the model instance input.

This method is invoked when a previous call to either start method or processInput method returned WAITING_FOR_INPUT and a new input is to be process by the model instance.

Specified by:

processInput in interface ExecutableTask

Returns:

result of execution, must not be null

Throws:

ErrorException - the BPMN error

terminate

public void terminate(TaskContext context,
                      TerminationReason reason)

Description copied from interface: ExecutableTask

Called when this task is to be terminated. This method is called also in case of normal task completion.

Specified by:

terminate in interface ExecutableTask

See Also:

ErrorException