com.evolveum.midpoint.wf.impl.tasks

Class WfTaskController

java.lang.Object

com.evolveum.midpoint.wf.impl.tasks.WfTaskController

@Component
public class WfTaskController
extends Object

Manages everything related to a activiti process instance, including the task that monitors that process instance. This class provides a facade over ugly mess of code managing activiti + task pair describing a workflow process instance.

Author:

mederly

Field Summary

Fields

Modifier and Type	Field and Description
static long	TASK_START_DELAY

Constructor Summary

Constructors

Constructor and Description
WfTaskController()

Method Summary

Methods

Modifier and Type	Method and Description
void	addDependency(WfTask executesFirst, WfTask executesSecond) Beware, in order to make the change permanent, it is necessary to call commitChanges on "executesFirst".
MiscDataUtil	getMiscDataUtil()
PrismContext	getPrismContext()
TaskManager	getTaskManager()
WfConfiguration	getWfConfiguration()
WfTaskUtil	getWfTaskUtil()
void	onProcessEvent(ProcessEvent event, Task task, OperationResult result)
void	onTaskEvent(com.evolveum.midpoint.xml.ns._public.common.common_3.WorkItemType workItem, TaskEvent taskEvent, OperationResult result)
WfTask	recreateChildWfTask(Task subtask, WfTask parentWfTask) Re-creates a child job, knowing the task and the parent job.
WfTask	recreateRootWfTask(Task task) Re-creates a root job, based on existing task information.
WfTask	recreateWfTask(Task task) Re-creates a job, based on existing task information.
WfTask	recreateWfTask(Task task, ChangeProcessor changeProcessor)
void	registerProcessListener(ProcessListener processListener)
void	registerWorkItemListener(WorkItemListener workItemListener)
void	resumeTask(WfTask wfTask, OperationResult result)
WfTask	submitWfTask(WfTaskCreationInstruction instruction, Task parentTask, com.evolveum.midpoint.xml.ns._public.common.common_3.WfConfigurationType wfConfigurationType, OperationResult result) As before, but this time we know only the parent task (not a job).
WfTask	submitWfTask(WfTaskCreationInstruction instruction, WfTask parentWfTask, com.evolveum.midpoint.xml.ns._public.common.common_3.WfConfigurationType wfConfigurationType, OperationResult result) Creates a background task, just as prescribed by the task creation instruction.
void	unpauseTask(WfTask wfTask, OperationResult result)

Methods inherited from class java.lang.Object

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

Field Detail

TASK_START_DELAY

public static final long TASK_START_DELAY

See Also:

Constant Field Values

Constructor Detail

WfTaskController

public WfTaskController()

Method Detail

submitWfTask

public WfTask submitWfTask(WfTaskCreationInstruction instruction,
                  WfTask parentWfTask,
                  com.evolveum.midpoint.xml.ns._public.common.common_3.WfConfigurationType wfConfigurationType,
                  OperationResult result)
                    throws SchemaException,
                           ObjectNotFoundException

Creates a background task, just as prescribed by the task creation instruction.

Parameters:

instruction - the job creation instruction

parentWfTask - the job that will be the parent of newly created one; it may be null

wfConfigurationType -

Throws:

SchemaException

ObjectNotFoundException

submitWfTask

public WfTask submitWfTask(WfTaskCreationInstruction instruction,
                  Task parentTask,
                  com.evolveum.midpoint.xml.ns._public.common.common_3.WfConfigurationType wfConfigurationType,
                  OperationResult result)
                    throws SchemaException,
                           ObjectNotFoundException

As before, but this time we know only the parent task (not a job).

Parameters:

instruction - the job creation instruction

parentTask - the task that will be the parent of the task of newly created job; it may be null

wfConfigurationType -

Throws:

SchemaException

ObjectNotFoundException

recreateWfTask

public WfTask recreateWfTask(Task task)

Re-creates a job, based on existing task information.

Parameters:

task - a task from task-processInstance pair

Returns:

recreated job

recreateWfTask

public WfTask recreateWfTask(Task task,
                    ChangeProcessor changeProcessor)

recreateChildWfTask

public WfTask recreateChildWfTask(Task subtask,
                         WfTask parentWfTask)

Re-creates a child job, knowing the task and the parent job.

Parameters:

subtask - a task from task-processInstance pair

parentWfTask - the parent job

Returns:

recreated job

recreateRootWfTask

public WfTask recreateRootWfTask(Task task)

Re-creates a root job, based on existing task information. Does not try to find the wf process instance.

addDependency

public void addDependency(WfTask executesFirst,
                 WfTask executesSecond)

Beware, in order to make the change permanent, it is necessary to call commitChanges on "executesFirst". It is advisable not to modify underlying tasks between 'addDependency' and 'commitChanges' because of the savePendingModifications() mechanism that is used here.

Parameters:

executesFirst -

executesSecond -

resumeTask

public void resumeTask(WfTask wfTask,
              OperationResult result)
                throws SchemaException,
                       ObjectNotFoundException

Throws:

SchemaException

ObjectNotFoundException

unpauseTask

public void unpauseTask(WfTask wfTask,
               OperationResult result)
                 throws SchemaException,
                        ObjectNotFoundException

Throws:

SchemaException

ObjectNotFoundException

onProcessEvent

public void onProcessEvent(ProcessEvent event,
                  Task task,
                  OperationResult result)
                    throws ObjectAlreadyExistsException,
                           ObjectNotFoundException,
                           SchemaException

Throws:

ObjectAlreadyExistsException

ObjectNotFoundException

SchemaException

onTaskEvent

public void onTaskEvent(com.evolveum.midpoint.xml.ns._public.common.common_3.WorkItemType workItem,
               TaskEvent taskEvent,
               OperationResult result)
                 throws WorkflowException,
                        SchemaException

Throws:

WorkflowException

SchemaException

registerProcessListener

public void registerProcessListener(ProcessListener processListener)

registerWorkItemListener

public void registerWorkItemListener(WorkItemListener workItemListener)

getWfTaskUtil

public WfTaskUtil getWfTaskUtil()

getMiscDataUtil

public MiscDataUtil getMiscDataUtil()

getPrismContext

public PrismContext getPrismContext()

getTaskManager

public TaskManager getTaskManager()

getWfConfiguration

public WfConfiguration getWfConfiguration()