/* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.camunda.bpm.engine.impl.bpmn.behavior;
import org.camunda.bpm.engine.impl.bpmn.helper.ScopeUtil;
import org.camunda.bpm.engine.impl.bpmn.parser.BpmnParse;
import org.camunda.bpm.engine.impl.persistence.entity.CompensateEventSubscriptionEntity;
import org.camunda.bpm.engine.impl.persistence.entity.ExecutionEntity;
import org.camunda.bpm.engine.impl.pvm.PvmScope;
import org.camunda.bpm.engine.impl.pvm.delegate.ActivityExecution;
import org.camunda.bpm.engine.impl.pvm.process.ActivityImpl;
/**
* Denotes an 'activity' in the sense of BPMN 2.0:
* a parent class for all tasks, subprocess and callActivity.
*
* @author Joram Barrez
*/
public class AbstractBpmnActivityBehavior extends FlowNodeActivityBehavior {
protected MultiInstanceActivityBehavior multiInstanceActivityBehavior;
/**
* Subclasses that call leave() will first pass through this method, before
* the regular {@link FlowNodeActivityBehavior#leave(ActivityExecution)} is
* called. This way, we can check if the activity has loop characteristics,
* and delegate to the behavior if this is the case.
*/
protected void leave(ActivityExecution execution) {
if(hasCompensationHandler(execution)) {
createCompensateEventSubscription(execution);
}
if (!hasLoopCharacteristics()) {
super.leave(execution);
} else if (hasMultiInstanceCharacteristics()){
multiInstanceActivityBehavior.leave(execution);
}
}
protected boolean hasCompensationHandler(ActivityExecution execution) {
return execution.getActivity().getProperty(BpmnParse.PROPERTYNAME_COMPENSATION_HANDLER_ID) != null;
}
protected void createCompensateEventSubscription(ActivityExecution execution) {
String compensationHandlerId = (String) execution.getActivity().getProperty(BpmnParse.PROPERTYNAME_COMPENSATION_HANDLER_ID);
ExecutionEntity executionEntity = (ExecutionEntity) execution;
ActivityImpl compensationHandlder = executionEntity.getProcessDefinition().findActivity(compensationHandlerId);
PvmScope scopeActivitiy = compensationHandlder.getParent();
ExecutionEntity scopeExecution = ScopeUtil.findScopeExecutionForScope(executionEntity, scopeActivitiy);
CompensateEventSubscriptionEntity compensateEventSubscriptionEntity = CompensateEventSubscriptionEntity.createAndInsert(scopeExecution);
compensateEventSubscriptionEntity.setActivity(compensationHandlder);
}
protected boolean hasLoopCharacteristics() {
return hasMultiInstanceCharacteristics();
}
protected boolean hasMultiInstanceCharacteristics() {
return multiInstanceActivityBehavior != null;
}
public MultiInstanceActivityBehavior getMultiInstanceActivityBehavior() {
return multiInstanceActivityBehavior;
}
public void setMultiInstanceActivityBehavior(MultiInstanceActivityBehavior multiInstanceActivityBehavior) {
this.multiInstanceActivityBehavior = multiInstanceActivityBehavior;
}
@Override
public void signal(ActivityExecution execution, String signalName, Object signalData) throws Exception {
if("compensationDone".equals(signalName)) {
signalCompensationDone(execution, signalData);
} else {
super.signal(execution, signalName, signalData);
}
}
protected void signalCompensationDone(ActivityExecution execution, Object signalData) {
// default behavior is to join compensating executions and propagate the signal if all executions
// have compensated
// join compensating executions
if(execution.getExecutions().isEmpty()) {
if(execution.getParent() != null) {
ActivityExecution parent = execution.getParent();
execution.remove();
parent.signal("compensationDone", signalData);
}
} else {
((ExecutionEntity)execution).forceUpdate();
}
}
}