org.kie.services.remote.rest
Class RestProcessRequestBean

java.lang.Object
  org.kie.services.remote.rest.RestProcessRequestBean

@RequestScoped
public class RestProcessRequestBean
extends Object

This class is used by both the RuntimeResource and TaskResource to do the core operations on the Deployment/Runtime's KieSession and TaskService.

It contains the necessary logic to do the following:

• Retrieve the KieSession or TaskService
• Execute the submitted command

Constructor Summary

RestProcessRequestBean()

Method Summary

Object	doKieSessionOperation(org.kie.api.command.Command<?> cmd, String deploymentId, Long processInstanceId, String errorMsg) Executes a command on the KieSession from the proper RuntimeManager.
Object	doNonDeploymentTaskOperation(org.jbpm.services.task.commands.TaskCommand<?> cmd, String errorMsg) Intended for TaskCommand's which do not modify Tasks.
Object	doNonDeploymentTaskOperationAndSerializeResult(org.jbpm.services.task.commands.TaskCommand<?> cmd, String errorMsg) Intended for read-only TaskCommands on the TaskService.
Object	doTaskOperationOnDeployment(org.jbpm.services.task.commands.TaskCommand<?> cmd, String errorMsg) Executes a command on the TaskService (without synchronizing around the KieSession)
Object	doTaskOperationOnDeployment(org.jbpm.services.task.commands.TaskCommand<?> cmd, String deploymentId, Long processInstanceId, String errorMsg) Executes a command on the injected TaskService instance.
Object	getVariableObjectInstanceFromRuntime(String deploymentId, long processInstanceId, String varName)

Methods inherited from class java.lang.Object

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

Constructor Detail

RestProcessRequestBean

public RestProcessRequestBean()

Method Detail

doKieSessionOperation

public Object doKieSessionOperation(org.kie.api.command.Command<?> cmd,
                                    String deploymentId,
                                    Long processInstanceId,
                                    String errorMsg)

Executes a command on the KieSession from the proper RuntimeManager. This method ends up synchronizing around the retrieved KieSession in order to avoid race-conditions.

Parameters:

cmd - The command to be executed.

deploymentId - The id of the runtime.

processInstanceId - The process instance id, if available.

Returns:

The result of the Command.

doTaskOperationOnDeployment

public Object doTaskOperationOnDeployment(org.jbpm.services.task.commands.TaskCommand<?> cmd,
                                          String deploymentId,
                                          Long processInstanceId,
                                          String errorMsg)

Executes a command on the injected TaskService instance.

Should be used only for commands that end up affecting the associated KieSession. Since the CompleteTaskCommand ends up signalling the KieSession, we make sure to first retrieve the proper KieSession in order to synchronize around it.

Parameters:

cmd - The command to be executed.

errorMsg - The message to be added to any (non-runtime) exceptions thrown.

deploymentId - The deployment id of the runtime.

Returns:

The result of the completed command.

doTaskOperationOnDeployment

public Object doTaskOperationOnDeployment(org.jbpm.services.task.commands.TaskCommand<?> cmd,
                                          String errorMsg)

Executes a command on the TaskService (without synchronizing around the KieSession)

Parameters:

cmd - The command to be executed.

errorMsg - The error message to be attached to any exceptions thrown.

Returns:

The result of the completed command.

doNonDeploymentTaskOperationAndSerializeResult

public Object doNonDeploymentTaskOperationAndSerializeResult(org.jbpm.services.task.commands.TaskCommand<?> cmd,
                                                             String errorMsg)

Intended for read-only TaskCommands on the TaskService.

• This should be used when the TaskCommand returns an object instance that is also a (persistent) entity, and thus should also be serialized within a transaction.

Parameters:

cmd - The TaskCommand to be executed.

errorMsg - The error message that should be associated with any eventual errors or exceptions.

Returns:

The result of the TaskCommand, possibly null.

doNonDeploymentTaskOperation

public Object doNonDeploymentTaskOperation(org.jbpm.services.task.commands.TaskCommand<?> cmd,
                                           String errorMsg)

Intended for TaskCommand's which do not modify Tasks. This should be used:

• when retrieving an object instance
• when deleting task history entities

Parameters:

cmd - The TaskCommand to be executed.

errorMsg - The error message that should be associated with any eventual errors or exceptions.

Returns:

The result of the TaskCommand, possibly null.

getVariableObjectInstanceFromRuntime

public Object getVariableObjectInstanceFromRuntime(String deploymentId,
                                                   long processInstanceId,
                                                   String varName)