org.camunda.bpm.engine.impl
Class ProcessInstanceActivityInstantiationBuilderImpl

java.lang.Object
  org.camunda.bpm.engine.impl.ProcessInstanceActivityInstantiationBuilderImpl

All Implemented Interfaces:

ProcessInstanceActivityInstantiationBuilder, ProcessInstanceModificationBuilder

public class ProcessInstanceActivityInstantiationBuilderImpl
extends Object
implements ProcessInstanceActivityInstantiationBuilder

Author:

Thorben Lindhauer

Field Summary

protected ProcessInstanceModificationBuilderImpl	builder
protected AbstractInstantiationCmd	currentInstantiation

Constructor Summary

ProcessInstanceActivityInstantiationBuilderImpl(ProcessInstanceModificationBuilderImpl builder, AbstractInstantiationCmd currentInstantiation)

Method Summary

ProcessInstanceModificationBuilder	cancelActivityInstance(String activityInstanceId) Submits the instruction:
ProcessInstanceModificationBuilder	cancelAllForActivity(String activityId) Submits the instruction:
ProcessInstanceModificationBuilder	cancelTransitionInstance(String transitionInstanceId) Submits the instruction:
void	execute() Execute all instructions.
void	execute(boolean skipCustomListeners, boolean skipIoMappings)
ProcessInstanceActivityInstantiationBuilder	setVariable(String name, Object value) Adds a variable to be set when the current instruction is executed.
ProcessInstanceActivityInstantiationBuilder	setVariableLocal(String name, Object value) Adds a local variable to be set when the current instruction is executed.
ProcessInstanceActivityInstantiationBuilder	setVariables(Map<String,Object> variables) Adds all variables to be set when the current instruction is executed
ProcessInstanceActivityInstantiationBuilder	setVariablesLocal(Map<String,Object> variables) Adds all local variables to be set when the current instruction is executed
ProcessInstanceActivityInstantiationBuilder	startAfterActivity(String activityId) Submits an instruction that behaves like ProcessInstanceModificationBuilder.startTransition(String) and always instantiates the single outgoing sequence flow of the given activity.
ProcessInstanceActivityInstantiationBuilder	startAfterActivity(String activityId, String ancestorActivityInstanceId) Submits an instruction that behaves like ProcessInstanceModificationBuilder.startTransition(String,String) and always instantiates the single outgoing sequence flow of the given activity.
ProcessInstanceActivityInstantiationBuilder	startBeforeActivity(String activityId) Submits the instruction:
ProcessInstanceActivityInstantiationBuilder	startBeforeActivity(String activityId, String ancestorActivityInstanceId) Submits the instruction:
ProcessInstanceActivityInstantiationBuilder	startTransition(String transitionId) Submits the instruction:
ProcessInstanceActivityInstantiationBuilder	startTransition(String transitionId, String ancestorActivityInstanceId) Submits the instruction:

Methods inherited from class java.lang.Object

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

Field Detail

builder

protected ProcessInstanceModificationBuilderImpl builder

currentInstantiation

protected AbstractInstantiationCmd currentInstantiation

Constructor Detail

ProcessInstanceActivityInstantiationBuilderImpl

public ProcessInstanceActivityInstantiationBuilderImpl(ProcessInstanceModificationBuilderImpl builder,
                                                       AbstractInstantiationCmd currentInstantiation)

Method Detail

setVariable

public ProcessInstanceActivityInstantiationBuilder setVariable(String name,
                                                               Object value)

Description copied from interface: ProcessInstanceActivityInstantiationBuilder

Adds a variable to be set when the current instruction is executed.

Specified by:

setVariable in interface ProcessInstanceActivityInstantiationBuilder

setVariableLocal

public ProcessInstanceActivityInstantiationBuilder setVariableLocal(String name,
                                                                    Object value)

Description copied from interface: ProcessInstanceActivityInstantiationBuilder

Adds a local variable to be set when the current instruction is executed.

Specified by:

setVariableLocal in interface ProcessInstanceActivityInstantiationBuilder

setVariables

public ProcessInstanceActivityInstantiationBuilder setVariables(Map<String,Object> variables)

Description copied from interface: ProcessInstanceActivityInstantiationBuilder

Adds all variables to be set when the current instruction is executed

Specified by:

setVariables in interface ProcessInstanceActivityInstantiationBuilder

setVariablesLocal

public ProcessInstanceActivityInstantiationBuilder setVariablesLocal(Map<String,Object> variables)

Description copied from interface: ProcessInstanceActivityInstantiationBuilder

Adds all local variables to be set when the current instruction is executed

Specified by:

setVariablesLocal in interface ProcessInstanceActivityInstantiationBuilder

cancelActivityInstance

public ProcessInstanceModificationBuilder cancelActivityInstance(String activityInstanceId)

Description copied from interface: ProcessInstanceModificationBuilder

Submits the instruction:

Cancel an activity instance in a process. If this instance has child activity instances (e.g. in a subprocess instance), these children, their grandchildren, etc. are cancelled as well.

Specified by:

cancelActivityInstance in interface ProcessInstanceModificationBuilder

Parameters:

activityInstanceId - the id of the activity instance to cancel

cancelTransitionInstance

public ProcessInstanceModificationBuilder cancelTransitionInstance(String transitionInstanceId)

Description copied from interface: ProcessInstanceModificationBuilder

Submits the instruction:

Cancel a transition instance (i.e. an async continuation) in a process.

Specified by:

cancelTransitionInstance in interface ProcessInstanceModificationBuilder

Parameters:

transitionInstanceId - the id of the transition instance to cancel

cancelAllForActivity

public ProcessInstanceModificationBuilder cancelAllForActivity(String activityId)

Description copied from interface: ProcessInstanceModificationBuilder

Submits the instruction:

Cancel all instances of the given activity in an arbitrary order, which are:

• activity instances of that activity
• transition instances entering or leaving that activity

Therefore behaves like ProcessInstanceModificationBuilder.cancelActivityInstance(String) for each individual activity instance and like ProcessInstanceModificationBuilder.cancelTransitionInstance(String) for each individual transition instance.

The cancellation order of the instances is arbitrary

Specified by:

cancelAllForActivity in interface ProcessInstanceModificationBuilder

Parameters:

activityId - the activity for which all instances should be cancelled

startBeforeActivity

public ProcessInstanceActivityInstantiationBuilder startBeforeActivity(String activityId)

Description copied from interface: ProcessInstanceModificationBuilder

Submits the instruction:

Start before the specified activity.

In particular:

• In the parent activity hierarchy, determine the closest existing ancestor activity instance
• Instantiate all parent activities up to the ancestor's activity
• Instantiate and execute the given activity (respects the asyncBefore attribute of the activity)

Specified by:

startBeforeActivity in interface ProcessInstanceModificationBuilder

Parameters:

activityId - the activity to instantiate

startBeforeActivity

public ProcessInstanceActivityInstantiationBuilder startBeforeActivity(String activityId,
                                                                       String ancestorActivityInstanceId)

Description copied from interface: ProcessInstanceModificationBuilder

Submits the instruction:

Start before the specified activity. Instantiate the given activity as a descendant of the given ancestor activity instance.

In particular:

• Instantiate all activities between the ancestor activity and the activity to execute
• Instantiate and execute the given activity (respects the asyncBefore attribute of the activity)

Specified by:

startBeforeActivity in interface ProcessInstanceModificationBuilder

Parameters:

activityId - the activity to instantiate

ancestorActivityInstanceId - the ID of an existing activity instance under which the new activity instance should be created

startAfterActivity

public ProcessInstanceActivityInstantiationBuilder startAfterActivity(String activityId)

Description copied from interface: ProcessInstanceModificationBuilder

Submits an instruction that behaves like ProcessInstanceModificationBuilder.startTransition(String) and always instantiates the single outgoing sequence flow of the given activity. Does not consider asyncAfter.

Specified by:

startAfterActivity in interface ProcessInstanceModificationBuilder

Parameters:

activityId - the activity for which the outgoing flow should be executed

startAfterActivity

public ProcessInstanceActivityInstantiationBuilder startAfterActivity(String activityId,
                                                                      String ancestorActivityInstanceId)

Description copied from interface: ProcessInstanceModificationBuilder

Submits an instruction that behaves like ProcessInstanceModificationBuilder.startTransition(String,String) and always instantiates the single outgoing sequence flow of the given activity. Does not consider asyncAfter.

Specified by:

startAfterActivity in interface ProcessInstanceModificationBuilder

Parameters:

activityId - the activity for which the outgoing flow should be executed

startTransition

public ProcessInstanceActivityInstantiationBuilder startTransition(String transitionId)

Description copied from interface: ProcessInstanceModificationBuilder

Submits the instruction:

Start a sequence flow.

In particular:

• In the parent activity hierarchy, determine the closest existing ancestor activity instance
• Instantiate all parent activities up to the ancestor's activity
• Execute the given transition (does not consider sequence flow conditions)

Specified by:

startTransition in interface ProcessInstanceModificationBuilder

Parameters:

transitionId - the sequence flow to execute

startTransition

public ProcessInstanceActivityInstantiationBuilder startTransition(String transitionId,
                                                                   String ancestorActivityInstanceId)

Description copied from interface: ProcessInstanceModificationBuilder

Submits the instruction:

Start the specified sequence flow. Instantiate the given sequence flow as a descendant of the given ancestor activity instance.

In particular:

• Instantiate all activities between the ancestor activity and the activity to execute
• Execute the given transition (does not consider sequence flow conditions)

Specified by:

startTransition in interface ProcessInstanceModificationBuilder

Parameters:

transitionId - the sequence flow to execute

ancestorActivityInstanceId - the ID of an existing activity instance under which the new transition should be executed

execute

public void execute()

Description copied from interface: ProcessInstanceModificationBuilder

Execute all instructions. Custom execution and task listeners, as well as task input output mappings are executed.

Specified by:

execute in interface ProcessInstanceModificationBuilder

execute

public void execute(boolean skipCustomListeners,
                    boolean skipIoMappings)

Specified by:

execute in interface ProcessInstanceModificationBuilder

Parameters:

skipCustomListeners - specifies whether custom listeners (task and execution) should be invoked when executing the instructions

skipIoMappings - specifies whether input/output mappings for tasks should be invoked throughout the transaction when executing the instructions