camunda_04_quickstart
原创
©著作权归作者所有:来自51CTO博客作者HarryChinese的原创作品,请联系作者获取转载授权,否则将追究法律责任
目标
- 设计和部署第一个简单流程
- 使用Java实现流程处理
- 完成流程启动测试
设计第一个流程
建模注意事项
- 模型文件和部署名其实并不重要,最重要是流程的
Id
, ProcessEngine是按照这个Id管理流程. - 流程要设定为
Executable
.
步骤
- 使用Model新建一个 camunda 7的模型文件, 命名为payment.bpm , 流程Id 设定为
payment-retrieval
, 并完成部署.
- 在流程中增加一个Service task, 类型选
External
,Topic设定为charge-card
- BPMN xml 代码
<?xml version="1.0" encoding="UTF-8"?>
<bpmn:definitions xmlns:bpmn="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:dc="http://www.omg.org/spec/DD/20100524/DC" xmlns:camunda="http://camunda.org/schema/1.0/bpmn" xmlns:di="http://www.omg.org/spec/DD/20100524/DI" xmlns:modeler="http://camunda.org/schema/modeler/1.0" id="Definitions_1xvrd7w" targetNamespace="http://bpmn.io/schema/bpmn" exporter="Camunda Modeler" exporterVersion="5.2.0" modeler:executionPlatform="Camunda Platform" modeler:executionPlatformVersion="7.17.0">
<bpmn:process id="payment-retrieval" name="付款流程" isExecutable="true">
<bpmn:startEvent id="StartEvent_1" name="付款请求">
<bpmn:outgoing>Flow_0mcdkpl</bpmn:outgoing>
</bpmn:startEvent>
<bpmn:sequenceFlow id="Flow_0mcdkpl" sourceRef="StartEvent_1" targetRef="Activity_Charge" />
<bpmn:serviceTask id="Activity_Charge" name="刷卡付款" camunda:type="external" camunda:topic="charge-card">
<bpmn:incoming>Flow_0mcdkpl</bpmn:incoming>
<bpmn:outgoing>Flow_16yugnw</bpmn:outgoing>
</bpmn:serviceTask>
<bpmn:endEvent id="EndEvent_1" name="付款完成">
<bpmn:incoming>Flow_16yugnw</bpmn:incoming>
</bpmn:endEvent>
<bpmn:sequenceFlow id="Flow_16yugnw" sourceRef="Activity_Charge" targetRef="EndEvent_1" />
</bpmn:process>
<bpmndi:BPMNDiagram id="BPMNDiagram_1">
<bpmndi:BPMNPlane id="BPMNPlane_1" bpmnElement="payment-retrieval">
<bpmndi:BPMNEdge id="Flow_0mcdkpl_di" bpmnElement="Flow_0mcdkpl">
<di:waypoint x="215" y="117" />
<di:waypoint x="270" y="117" />
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge id="Flow_16yugnw_di" bpmnElement="Flow_16yugnw">
<di:waypoint x="370" y="117" />
<di:waypoint x="432" y="117" />
</bpmndi:BPMNEdge>
<bpmndi:BPMNShape id="_BPMNShape_StartEvent_2" bpmnElement="StartEvent_1">
<dc:Bounds x="179" y="99" width="36" height="36" />
<bpmndi:BPMNLabel>
<dc:Bounds x="175" y="142" width="45" height="14" />
</bpmndi:BPMNLabel>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape id="Activity_1dxqxj0_di" bpmnElement="Activity_Charge">
<dc:Bounds x="270" y="77" width="100" height="80" />
<bpmndi:BPMNLabel />
</bpmndi:BPMNShape>
<bpmndi:BPMNShape id="Event_0qnrvvd_di" bpmnElement="EndEvent_1">
<dc:Bounds x="432" y="99" width="36" height="36" />
<bpmndi:BPMNLabel>
<dc:Bounds x="428" y="142" width="45" height="14" />
</bpmndi:BPMNLabel>
</bpmndi:BPMNShape>
</bpmndi:BPMNPlane>
</bpmndi:BPMNDiagram>
</bpmn:definitions>
开发Java实现刷卡付款业务
maven 国内源
maven 配置文件设置国内源, 文件:conf\settings.xml
<mirrors>
<mirror>
<id>aliyun</id>
<name>mirror from maven aliyun</name>
<url>https://maven.aliyun.com/repository/central</url>
<mirrorOf>central</mirrorOf>
</mirror>
</mirrors>
pom.xml
</dependency>
<dependency>
<groupId>org.camunda.bpm</groupId>
<artifactId>camunda-external-task-client</artifactId>
<version>7.17.0</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-simple</artifactId>
<version>1.6.1</version>
</dependency>
<dependency>
<groupId>javax.xml.bind</groupId>
<artifactId>jaxb-api</artifactId>
<version>2.3.1</version>
</dependency>
</dependencies>
java 业务代码
camunda 的 ExternalTaskClient 是一个Listener类, 我们程序使用 ExternalTaskClient 就可以成为一个后台daemon程序, 后面再专门写个博客分析一下 camunda-external-task-client jar.
在我们的程序中, 使用ExternalTaskClient可以非常方便监听流程中的External Task Service设定的 topic, 完成业务处理, 并标记该Task为结束.
package javatest;
import java.text.MessageFormat;
import java.util.logging.Logger;
import org.camunda.bpm.client.ExternalTaskClient;
public class ChargeCardWorker {
private final static Logger logger = Logger.getLogger(ChargeCardWorker.class.getName());
public static void main(String[] args) {
logger.info("ExternalTaskClient setup");
ExternalTaskClient client = ExternalTaskClient.create().baseUrl("http://localhost:8080/engine-rest")
.asyncResponseTimeout(10000).build();
// 订阅并处理第1个ExternalTask的topic
client.subscribe("charge-card").lockDuration(1000).handler((externalTask, externalTaskService) -> {
// 获取流程信息
String item = (String) externalTask.getVariable("item");
Long amount = (Long) externalTask.getVariable("amount");
// 业务逻辑
logger.info(
MessageFormat.format("Charging credit card with an amount of {0} for the item {1}", amount, item));
// 完成 Task
externalTaskService.complete(externalTask);
}).open();
// 订阅并处理第2个ExternalTask的topic
// 省略
logger.info("Listening topics...");
}
}
启动流程
确保java程序提前运行, 然后使用VS code+Rest Client 发起一个启动流程命令:
POST http://localhost:8080/engine-rest/process-definition/key/payment-retrieval/start HTTP/1.1
Content-Type: application/json
{
"variables": {
"amount": {
"value":555,
"type":"long"
},
"item": {
"value": "item-xyz"
}
}
}
Rest API的返回信息:
Java程序端的输出: