com.whitestein.lsps.wsserver.task

Class WsResponseTask

java.lang.Object

com.whitestein.lsps.wsserver.task.WsResponseTask

All Implemented Interfaces:

ExecutableTask

@PermitAll
public class WsResponseTask
extends Object
implements ExecutableTask

Implementation of task which is responsible for processing web service response. Depending on parameters defined in task definition, it sends back either soap fault constructed from field error or regular soap response constructed from field output. I.e. if task definition contains parameter output regular response is generated, otherwise the soap fault. In case task definition doesn't have any of these parameters, exception is raised. Thus in common case, for each web service two tasks with this implementation are generated. One for returning error response (soap fault), second for returning valid response.

The generated soap message is registered for id given by field requestId, which is mandatory in task definition.

This task contains following fields:

• requestId : id of request to which the generated response belongs
• output : RecordHolder object, the output (response) of the webservice. This output is transformed to webservice xml response, which will be send back to the client
• error : RecordHolder object, the error output (response) of the webservice. This error output is transformed to webservice xml response (as soap fault), which will be send back to the client

Author:

mbj

Nested Class Summary

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

ExecutableTask.Result

Constructor Summary

Constructors

Constructor and Description
WsResponseTask() Creates new instance.

Method Summary

Modifier and Type	Method and Description
ExecutableTask.Result	processInput(TaskContext context, Object input) The method for processing the model instance input.
ExecutableTask.Result	start(TaskContext context) An initial method that is called when the task execution starts.
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

WsResponseTask

public WsResponseTask()

Creates new instance.

Method Detail

start

public ExecutableTask.Result start(TaskContext context)
                            throws ErrorException

Description copied from interface: ExecutableTask

An initial method that is called when the task execution starts.

Specified by:

start in interface ExecutableTask

Returns:

result of execution, must not be null

Throws:

ErrorException - the BPMN error

processInput

public ExecutableTask.Result processInput(TaskContext context,
                                          Object input)

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

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