Package org.flowable.engine.impl.bpmn.behavior

Class MultiInstanceActivityBehavior

java.lang.Object

org.flowable.engine.impl.bpmn.behavior.FlowNodeActivityBehavior

org.flowable.engine.impl.bpmn.behavior.MultiInstanceActivityBehavior

All Implemented Interfaces:

Serializable, ActivityBehavior, InterruptibleActivityBehaviour, SubProcessActivityBehavior, TriggerableActivityBehavior

Direct Known Subclasses:

ParallelMultiInstanceBehavior, SequentialMultiInstanceBehavior

public abstract class MultiInstanceActivityBehavior
extends FlowNodeActivityBehavior
implements SubProcessActivityBehavior, InterruptibleActivityBehaviour

Implementation of the multi-instance functionality as described in the BPMN 2.0 spec. Multi instance functionality is implemented as an ActivityBehavior that wraps the original ActivityBehavior of the activity. Only subclasses of AbstractBpmnActivityBehavior can have multi-instance behavior. As such, special logic is contained in the AbstractBpmnActivityBehavior to delegate to the MultiInstanceActivityBehavior if needed.

Author:

Joram Barrez, Tijs Rademakers, Filip Hrisafov

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected Activity	activity
protected VariableAggregationDefinitions	aggregations
protected String	collectionElementIndexVariable
protected String	collectionElementVariable
protected Expression	collectionExpression
protected CollectionHandler	collectionHandler
protected String	collectionString
protected String	collectionVariable
protected String	completionCondition
protected static final String	DELETE_REASON_END
protected AbstractBpmnActivityBehavior	innerActivityBehavior
protected static final org.slf4j.Logger	LOGGER
protected Expression	loopCardinalityExpression
protected static final String	NUMBER_OF_ACTIVE_INSTANCES
protected static final String	NUMBER_OF_COMPLETED_INSTANCES
protected static final String	NUMBER_OF_INSTANCES

Fields inherited from class org.flowable.engine.impl.bpmn.behavior.FlowNodeActivityBehavior

bpmnActivityBehavior

Constructor Summary

Constructors

Constructor	Description
MultiInstanceActivityBehavior(Activity activity, AbstractBpmnActivityBehavior innerActivityBehavior)

Method Summary

Modifier and Type	Method	Description
protected void	aggregateVariablesForChildExecution(DelegateExecution childExecution, DelegateExecution miRootExecution)	Aggregated the variables for the finished child multi instance execution
protected void	aggregateVariablesOfAllInstances(DelegateExecution multiInstanceRootExecution)	Aggregates all variables that were stored before for each child instance
protected FlowableMultiInstanceActivityCompletedEvent	buildCompletedEvent(DelegateExecution execution, FlowableEngineEventType eventType)
protected String	buildUnresolvedCollectionExceptionMessage()
protected void	callActivityEndListeners(DelegateExecution execution)	Since no transitions are followed when leaving the inner activity, it is needed to call the end listeners yourself.
protected void	cleanupMiRoot(DelegateExecution execution)
void	completed(DelegateExecution execution)	called after the process instance is destroyed for this activity to perform its outgoing control flow logic.
void	completing(DelegateExecution execution, DelegateExecution subProcessInstance)	called before the process instance is destroyed to allow this activity to extract data from the sub process instance.
boolean	completionConditionSatisfied(DelegateExecution execution)
protected FlowableCollectionHandler	createFlowableCollectionHandler(CollectionHandler handler, DelegateExecution execution)
protected abstract int	createInstances(DelegateExecution execution)
void	execute(DelegateExecution delegateExecution)	Default behaviour: just leave the activity with no extra functionality.
protected void	executeCompensationBoundaryEvents(FlowElement flowElement, DelegateExecution execution)
protected void	executeOriginalBehavior(DelegateExecution execution, ExecutionEntity multiInstanceRootExecution, int loopCounter)
protected Collection<BoundaryEvent>	findBoundaryEventsForFlowNode(String processDefinitionId, FlowElement flowElement)
protected String	getActiveValue(String originalValue, String propertyName, com.fasterxml.jackson.databind.node.ObjectNode taskElementProperties)
VariableAggregationDefinitions	getAggregations()
String	getCollectionElementIndexVariable()
String	getCollectionElementVariable()
Expression	getCollectionExpression()
String	getCollectionString()
String	getCollectionVariable()
String	getCompletionCondition()
CollectionHandler	getHandler()
AbstractBpmnActivityBehavior	getInnerActivityBehavior()
protected DelegateExecution	getInstanceExecution(DelegateExecution execution)
protected Integer	getLocalLoopVariable(DelegateExecution execution, String variableName)
Expression	getLoopCardinalityExpression()
Integer	getLoopVariable(DelegateExecution execution, String variableName)
VariableInstance	getLoopVariableInstance(DelegateExecution execution, String variableName)
protected DelegateExecution	getMultiInstanceRootExecution(DelegateExecution execution)
protected Process	getProcessDefinition(String processDefinitionId)
protected boolean	hasVariableAggregationDefinitions(DelegateExecution execution)
protected void	internalInterrupted(DelegateExecution execution)
void	interrupted(DelegateExecution execution)
protected boolean	isExtraScopeNeeded(FlowNode flowNode)
protected Collection	iterableToCollection(Iterable iterable)
void	lastExecutionEnded(DelegateExecution execution)
void	leave(DelegateExecution execution)	Default way of leaving a BPMN 2.0 activity: evaluate the conditions on the outgoing sequence flow and take those that evaluate to true.
protected void	logLoopDetails(DelegateExecution execution, String custom, int loopCounter, int nrOfCompletedInstances, int nrOfActiveInstances, int nrOfInstances)
protected Collection	resolveAndValidateCollection(DelegateExecution execution)
protected Object	resolveCollection(DelegateExecution execution)
protected int	resolveLoopCardinality(DelegateExecution execution)
protected int	resolveNrOfInstances(DelegateExecution execution)
protected void	sendCompletedEvent(DelegateExecution execution)
protected void	sendCompletedWithConditionEvent(DelegateExecution execution)
void	setAggregations(VariableAggregationDefinitions aggregations)
void	setCollectionElementIndexVariable(String collectionElementIndexVariable)
void	setCollectionElementVariable(String collectionElementVariable)
void	setCollectionExpression(Expression collectionExpression)
void	setCollectionString(String collectionString)
void	setCollectionVariable(String collectionVariable)
void	setCompletionCondition(String completionCondition)
void	setHandler(CollectionHandler collectionHandler)
void	setInnerActivityBehavior(AbstractBpmnActivityBehavior innerActivityBehavior)
void	setLoopCardinalityExpression(Expression loopCardinalityExpression)
protected void	setLoopVariable(DelegateExecution execution, String variableName, Object value)
void	trigger(DelegateExecution execution, String signalName, Object signalData)
protected boolean	usesCollection()

Methods inherited from class org.flowable.engine.impl.bpmn.behavior.FlowNodeActivityBehavior

leaveIgnoreConditions, parseActivityType

Methods inherited from class java.lang.Object

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

Field Details

LOGGER

protected static final org.slf4j.Logger LOGGER

DELETE_REASON_END

protected static final String DELETE_REASON_END

See Also:

• Constant Field Values

NUMBER_OF_INSTANCES

protected static final String NUMBER_OF_INSTANCES

See Also:

• Constant Field Values

NUMBER_OF_ACTIVE_INSTANCES

protected static final String NUMBER_OF_ACTIVE_INSTANCES

See Also:

• Constant Field Values

NUMBER_OF_COMPLETED_INSTANCES

protected static final String NUMBER_OF_COMPLETED_INSTANCES

See Also:

• Constant Field Values

activity

protected Activity activity

innerActivityBehavior

protected AbstractBpmnActivityBehavior innerActivityBehavior

loopCardinalityExpression

protected Expression loopCardinalityExpression

completionCondition

protected String completionCondition

collectionExpression

protected Expression collectionExpression

collectionVariable

protected String collectionVariable

collectionElementVariable

protected String collectionElementVariable

collectionString

protected String collectionString

collectionHandler

protected CollectionHandler collectionHandler

aggregations

protected VariableAggregationDefinitions aggregations

collectionElementIndexVariable

protected String collectionElementIndexVariable

Constructor Details

MultiInstanceActivityBehavior

public MultiInstanceActivityBehavior(Activity activity,
 AbstractBpmnActivityBehavior innerActivityBehavior)

Parameters:

innerActivityBehavior - The original ActivityBehavior of the activity that will be wrapped inside this behavior.

Method Details

execute

public void execute(DelegateExecution delegateExecution)

Description copied from class: FlowNodeActivityBehavior

Default behaviour: just leave the activity with no extra functionality.

Specified by:

execute in interface ActivityBehavior

Overrides:

execute in class FlowNodeActivityBehavior

createInstances

protected abstract int createInstances(DelegateExecution execution)

leave

public void leave(DelegateExecution execution)

Description copied from class: FlowNodeActivityBehavior

Default way of leaving a BPMN 2.0 activity: evaluate the conditions on the outgoing sequence flow and take those that evaluate to true.

Overrides:

leave in class FlowNodeActivityBehavior

hasVariableAggregationDefinitions

protected boolean hasVariableAggregationDefinitions(DelegateExecution execution)

aggregateVariablesForChildExecution

protected void aggregateVariablesForChildExecution(DelegateExecution childExecution,
 DelegateExecution miRootExecution)

Aggregated the variables for the finished child multi instance execution

Parameters:

childExecution - the child execution

miRootExecution - the multi instance root execution

aggregateVariablesOfAllInstances

protected void aggregateVariablesOfAllInstances(DelegateExecution multiInstanceRootExecution)

Aggregates all variables that were stored before for each child instance

cleanupMiRoot

protected void cleanupMiRoot(DelegateExecution execution)

executeCompensationBoundaryEvents

protected void executeCompensationBoundaryEvents(FlowElement flowElement,
 DelegateExecution execution)

findBoundaryEventsForFlowNode

protected Collection<BoundaryEvent> findBoundaryEventsForFlowNode(String processDefinitionId,
 FlowElement flowElement)

getProcessDefinition

protected Process getProcessDefinition(String processDefinitionId)

trigger

public void trigger(DelegateExecution execution,
 String signalName,
 Object signalData)

Specified by:

trigger in interface TriggerableActivityBehavior

Overrides:

trigger in class FlowNodeActivityBehavior

lastExecutionEnded

public void lastExecutionEnded(DelegateExecution execution)

completing

public void completing(DelegateExecution execution,
 DelegateExecution subProcessInstance)
                throws Exception

Description copied from interface: SubProcessActivityBehavior

called before the process instance is destroyed to allow this activity to extract data from the sub process instance. No control flow should be done on the execution yet.

Specified by:

completing in interface SubProcessActivityBehavior

Throws:

Exception

completed

public void completed(DelegateExecution execution)
               throws Exception

Description copied from interface: SubProcessActivityBehavior

called after the process instance is destroyed for this activity to perform its outgoing control flow logic.

Specified by:

completed in interface SubProcessActivityBehavior

Throws:

Exception

interrupted

public void interrupted(DelegateExecution execution)

Specified by:

interrupted in interface InterruptibleActivityBehaviour

internalInterrupted

protected void internalInterrupted(DelegateExecution execution)

completionConditionSatisfied

public boolean completionConditionSatisfied(DelegateExecution execution)

getLoopVariable

public Integer getLoopVariable(DelegateExecution execution,
 String variableName)

getLoopVariableInstance

public VariableInstance getLoopVariableInstance(DelegateExecution execution,
 String variableName)

sendCompletedWithConditionEvent

protected void sendCompletedWithConditionEvent(DelegateExecution execution)

sendCompletedEvent

protected void sendCompletedEvent(DelegateExecution execution)

buildCompletedEvent

protected FlowableMultiInstanceActivityCompletedEvent buildCompletedEvent(DelegateExecution execution,
 FlowableEngineEventType eventType)

resolveNrOfInstances

protected int resolveNrOfInstances(DelegateExecution execution)

executeOriginalBehavior

protected void executeOriginalBehavior(DelegateExecution execution,
 ExecutionEntity multiInstanceRootExecution,
 int loopCounter)

resolveAndValidateCollection

protected Collection resolveAndValidateCollection(DelegateExecution execution)

buildUnresolvedCollectionExceptionMessage

protected String buildUnresolvedCollectionExceptionMessage()

iterableToCollection

protected Collection iterableToCollection(Iterable iterable)

resolveCollection

protected Object resolveCollection(DelegateExecution execution)

usesCollection

protected boolean usesCollection()

isExtraScopeNeeded

protected boolean isExtraScopeNeeded(FlowNode flowNode)

resolveLoopCardinality

protected int resolveLoopCardinality(DelegateExecution execution)

setLoopVariable

protected void setLoopVariable(DelegateExecution execution,
 String variableName,
 Object value)

getLocalLoopVariable

protected Integer getLocalLoopVariable(DelegateExecution execution,
 String variableName)

callActivityEndListeners

protected void callActivityEndListeners(DelegateExecution execution)

Since no transitions are followed when leaving the inner activity, it is needed to call the end listeners yourself.

logLoopDetails

protected void logLoopDetails(DelegateExecution execution,
 String custom,
 int loopCounter,
 int nrOfCompletedInstances,
 int nrOfActiveInstances,
 int nrOfInstances)

getMultiInstanceRootExecution

protected DelegateExecution getMultiInstanceRootExecution(DelegateExecution execution)

getInstanceExecution

protected DelegateExecution getInstanceExecution(DelegateExecution execution)

getActiveValue

protected String getActiveValue(String originalValue,
 String propertyName,
 com.fasterxml.jackson.databind.node.ObjectNode taskElementProperties)

createFlowableCollectionHandler

protected FlowableCollectionHandler createFlowableCollectionHandler(CollectionHandler handler,
 DelegateExecution execution)

getLoopCardinalityExpression

public Expression getLoopCardinalityExpression()

setLoopCardinalityExpression

public void setLoopCardinalityExpression(Expression loopCardinalityExpression)

getCompletionCondition

public String getCompletionCondition()

setCompletionCondition

public void setCompletionCondition(String completionCondition)

getCollectionExpression

public Expression getCollectionExpression()

setCollectionExpression

public void setCollectionExpression(Expression collectionExpression)

getCollectionVariable

public String getCollectionVariable()

setCollectionVariable

public void setCollectionVariable(String collectionVariable)

getCollectionElementVariable

public String getCollectionElementVariable()

setCollectionElementVariable

public void setCollectionElementVariable(String collectionElementVariable)

getCollectionString

public String getCollectionString()

setCollectionString

public void setCollectionString(String collectionString)

getHandler

public CollectionHandler getHandler()

setHandler

public void setHandler(CollectionHandler collectionHandler)

getAggregations

public VariableAggregationDefinitions getAggregations()

setAggregations

public void setAggregations(VariableAggregationDefinitions aggregations)

getCollectionElementIndexVariable

public String getCollectionElementIndexVariable()

setCollectionElementIndexVariable

public void setCollectionElementIndexVariable(String collectionElementIndexVariable)

setInnerActivityBehavior

public void setInnerActivityBehavior(AbstractBpmnActivityBehavior innerActivityBehavior)

getInnerActivityBehavior

public AbstractBpmnActivityBehavior getInnerActivityBehavior()