Flowable源码地址:https://github.com/flowable/flowable-engine
Flowable-6.7.2 源码注释地址:https://github.com/solojin/flowable-6.7.2-annotated
开始事件和结束事件解析处理类,包路径:org.flowable.engine.impl.bpmn.parser.handler
StartEventParseHandler 开始事件解析处理器
package org.flowable.engine.impl.bpmn.parser.handler;
import java.util.List;
import org.apache.commons.lang3.StringUtils;
import org.flowable.bpmn.constants.BpmnXMLConstants;
import org.flowable.bpmn.model.BaseElement;
import org.flowable.bpmn.model.BpmnModel;
import org.flowable.bpmn.model.ErrorEventDefinition;
import org.flowable.bpmn.model.EscalationEventDefinition;
import org.flowable.bpmn.model.EventDefinition;
import org.flowable.bpmn.model.EventSubProcess;
import org.flowable.bpmn.model.ExtensionElement;
import org.flowable.bpmn.model.Message;
import org.flowable.bpmn.model.MessageEventDefinition;
import org.flowable.bpmn.model.Signal;
import org.flowable.bpmn.model.SignalEventDefinition;
import org.flowable.bpmn.model.StartEvent;
import org.flowable.bpmn.model.TimerEventDefinition;
import org.flowable.bpmn.model.VariableListenerEventDefinition;
import org.flowable.common.engine.impl.util.CollectionUtil;
import org.flowable.engine.impl.bpmn.parser.BpmnParse;
/**
* 开始事件解析处理器
*
* @author Joram Barrez
* @author Tijs Rademakers
*/
public class StartEventParseHandler extends AbstractActivityBpmnParseHandler<StartEvent> {
@Override
public Class<? extends BaseElement> getHandledType() {
return StartEvent.class;
}
@Override
protected void executeParse(BpmnParse bpmnParse, StartEvent element) {
if (element.getSubProcess() != null && element.getSubProcess() instanceof EventSubProcess) {
if (CollectionUtil.isNotEmpty(element.getEventDefinitions())) {
EventDefinition eventDefinition = element.getEventDefinitions().get(0);
if (eventDefinition instanceof MessageEventDefinition) {
MessageEventDefinition messageDefinition = fillMessageRef(bpmnParse, eventDefinition);
element.setBehavior(bpmnParse.getActivityBehaviorFactory().createEventSubProcessMessageStartEventActivityBehavior(element, messageDefinition));
} else if (eventDefinition instanceof SignalEventDefinition) {
SignalEventDefinition signalDefinition = (SignalEventDefinition) eventDefinition;
Signal signal = null;
if (bpmnParse.getBpmnModel().containsSignalId(signalDefinition.getSignalRef())) {
signal = bpmnParse.getBpmnModel().getSignal(signalDefinition.getSignalRef());
}
element.setBehavior(bpmnParse.getActivityBehaviorFactory().createEventSubProcessSignalStartEventActivityBehavior(
element, signalDefinition, signal));
} else if (eventDefinition instanceof TimerEventDefinition) {
TimerEventDefinition timerEventDefinition = (TimerEventDefinition) eventDefinition;
element.setBehavior(bpmnParse.getActivityBehaviorFactory().createEventSubProcessTimerStartEventActivityBehavior(
element, timerEventDefinition));
} else if (eventDefinition instanceof ErrorEventDefinition) {
element.setBehavior(bpmnParse.getActivityBehaviorFactory().createEventSubProcessErrorStartEventActivityBehavior(element));
} else if (eventDefinition instanceof EscalationEventDefinition) {
element.setBehavior(bpmnParse.getActivityBehaviorFactory().createEventSubProcessEscalationStartEventActivityBehavior(element));
} else if (eventDefinition instanceof VariableListenerEventDefinition) {
VariableListenerEventDefinition variableListenerEventDefinition = (VariableListenerEventDefinition) eventDefinition;
element.setBehavior(bpmnParse.getActivityBehaviorFactory().createEventSubProcessVariableListenerlStartEventActivityBehavior(element, variableListenerEventDefinition));
}
} else {
List<ExtensionElement> eventTypeElements = element.getExtensionElements().get(BpmnXMLConstants.ELEMENT_EVENT_TYPE);
if (eventTypeElements != null && !eventTypeElements.isEmpty()) {
String eventType = eventTypeElements.get(0).getElementText();
if (StringUtils.isNotEmpty(eventType)) {
element.setBehavior(bpmnParse.getActivityBehaviorFactory().createEventSubProcessEventRegistryStartEventActivityBehavior(element, eventType));
}
}
}
} else if (CollectionUtil.isEmpty(element.getEventDefinitions())) {
element.setBehavior(bpmnParse.getActivityBehaviorFactory().createNoneStartEventActivityBehavior(element));
} else if (CollectionUtil.isNotEmpty(element.getEventDefinitions())) {
EventDefinition eventDefinition = element.getEventDefinitions().get(0);
if (eventDefinition instanceof MessageEventDefinition) {
fillMessageRef(bpmnParse, eventDefinition);
}
}
if (element.getSubProcess() == null && (CollectionUtil.isEmpty(element.getEventDefinitions()) ||
bpmnParse.getCurrentProcess().getInitialFlowElement() == null)) {
bpmnParse.getCurrentProcess().setInitialFlowElement(element);
}
}
protected MessageEventDefinition fillMessageRef(BpmnParse bpmnParse, EventDefinition eventDefinition) {
MessageEventDefinition messageDefinition = (MessageEventDefinition) eventDefinition;
BpmnModel bpmnModel = bpmnParse.getBpmnModel();
String messageRef = messageDefinition.getMessageRef();
if (bpmnModel.containsMessageId(messageRef)) {
Message message = bpmnModel.getMessage(messageRef);
messageDefinition.setMessageRef(message.getName());
messageDefinition.setExtensionElements(message.getExtensionElements());
}
return messageDefinition;
}
}
EndEventParseHandler 结束事件解析处理器
package org.flowable.engine.impl.bpmn.parser.handler;
import org.apache.commons.lang3.StringUtils;
import org.flowable.bpmn.model.BaseElement;
import org.flowable.bpmn.model.CancelEventDefinition;
import org.flowable.bpmn.model.EndEvent;
import org.flowable.bpmn.model.ErrorEventDefinition;
import org.flowable.bpmn.model.Escalation;
import org.flowable.bpmn.model.EscalationEventDefinition;
import org.flowable.bpmn.model.EventDefinition;
import org.flowable.bpmn.model.TerminateEventDefinition;
import org.flowable.engine.impl.bpmn.parser.BpmnParse;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* 结束事件解析处理器
*
* @author Joram Barrez
* @author Tijs Rademakers
*/
public class EndEventParseHandler extends AbstractActivityBpmnParseHandler<EndEvent> {
private static final Logger LOGGER = LoggerFactory.getLogger(EndEventParseHandler.class);
@Override
public Class<? extends BaseElement> getHandledType() {
return EndEvent.class;
}
@Override
protected void executeParse(BpmnParse bpmnParse, EndEvent endEvent) {
EventDefinition eventDefinition = null;
if (endEvent.getEventDefinitions().size() > 0) {
eventDefinition = endEvent.getEventDefinitions().get(0);
if (eventDefinition instanceof ErrorEventDefinition) {
ErrorEventDefinition errorDefinition = (ErrorEventDefinition) eventDefinition;
if (bpmnParse.getBpmnModel().containsErrorRef(errorDefinition.getErrorCode())) {
String errorCode = bpmnParse.getBpmnModel().getErrors().get(errorDefinition.getErrorCode());
if (StringUtils.isEmpty(errorCode)) {
// 错误事件{}需要错误代码
LOGGER.warn("errorCode is required for an error event {}", endEvent.getId());
}
}
endEvent.setBehavior(bpmnParse.getActivityBehaviorFactory().createErrorEndEventActivityBehavior(endEvent, errorDefinition));
} else if (eventDefinition instanceof EscalationEventDefinition) {
EscalationEventDefinition escalationDefinition = (EscalationEventDefinition) eventDefinition;
Escalation escalation = null;
if (bpmnParse.getBpmnModel().containsEscalationRef(escalationDefinition.getEscalationCode())) {
escalation = bpmnParse.getBpmnModel().getEscalation(escalationDefinition.getEscalationCode());
String escalationCode = escalation.getEscalationCode();
if (StringUtils.isEmpty(escalationCode)) {
// 升级事件{}需要升级代码
LOGGER.warn("escalationCode is required for an escalation event {}", endEvent.getId());
}
}
endEvent.setBehavior(bpmnParse.getActivityBehaviorFactory().createEscalationEndEventActivityBehavior(endEvent, escalationDefinition, escalation));
} else if (eventDefinition instanceof TerminateEventDefinition) {
endEvent.setBehavior(bpmnParse.getActivityBehaviorFactory().createTerminateEndEventActivityBehavior(endEvent));
} else if (eventDefinition instanceof CancelEventDefinition) {
endEvent.setBehavior(bpmnParse.getActivityBehaviorFactory().createCancelEndEventActivityBehavior(endEvent));
} else {
endEvent.setBehavior(bpmnParse.getActivityBehaviorFactory().createNoneEndEventActivityBehavior(endEvent));
}
} else {
endEvent.setBehavior(bpmnParse.getActivityBehaviorFactory().createNoneEndEventActivityBehavior(endEvent));
}
}
}