说说如何使用 Activiti 创建并运行第一个流程

1 第一个流程定义

首先，我们定义一个只包含开始与结束节点的流程：

流程定义描述文件：

<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:activiti="http://activiti.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="http://www.activiti.org/test">
  <process id="firstProcess" name="firstProcess" isExecutable="true">
    <startEvent id="startevent1" name="startevent1"></startEvent>
    <endEvent id="endevent1" name="End"></endEvent>
    <sequenceFlow id="flow1" sourceRef="startevent1" targetRef="endevent1"></sequenceFlow>
  </process>
  <bpmndi:BPMNDiagram id="BPMNDiagram_firstProcess">
    <bpmndi:BPMNPlane bpmnElement="firstProcess" id="BPMNPlane_firstProcess">
      <bpmndi:BPMNShape bpmnElement="startevent1" id="BPMNShape_startevent1">
        <omgdc:Bounds height="35.0" width="35.0" x="270.0" y="200.0"></omgdc:Bounds>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape bpmnElement="endevent1" id="BPMNShape_endevent1">
        <omgdc:Bounds height="35.0" width="35.0" x="350.0" y="200.0"></omgdc:Bounds>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNEdge bpmnElement="flow1" id="BPMNEdge_flow1">
        <omgdi:waypoint x="305.0" y="217.0"></omgdi:waypoint>
        <omgdi:waypoint x="350.0" y="217.0"></omgdi:waypoint>
      </bpmndi:BPMNEdge>
    </bpmndi:BPMNPlane>
  </bpmndi:BPMNDiagram>
</definitions>

分析如下：

• 流程定义描述文件符合 BPMN 2.0 规范。
• definitions 标签表示定义开始，内部可以包含多个 process 标签。
• definitions 标签定义了 XMLSchema 内容规范以及命名空间。
• process 标签表示流程定义。
• startEvent 标签表示流程启动事件。
• endEvent 标签表示流程结束事件。
• sequenceFlow 标签表示流程节点之间的关系；sourceRef 定义了源节点；targetRef 定义了目标节点。
• bpmndi:BPMNDiagram 标签是流程的图形定义。

2 单元测试

@Test
public void test() {
    //使用内存数据库，创建流程引擎
    ProcessEngine engine = ProcessEngineConfiguration
            .createStandaloneInMemProcessEngineConfiguration().buildProcessEngine();

    //部署
    RepositoryService repositoryService = engine.getRepositoryService();
    repositoryService.createDeployment().addClasspathResource
            ("workflow/diagrams/xx.bpmn")
            .deploy();

    //验证
    ProcessDefinition definition = repositoryService.createProcessDefinitionQuery()
            .singleResult();
    final String key = "firstProcess";
    assertEquals(key, definition.getKey());

    //启动流程并返回实例
    RuntimeService runtimeService = engine.getRuntimeService();
    ProcessInstance instance = runtimeService.startProcessInstanceByKey(key);
    assertNotNull(instance);
    System.out.println("id=" + instance.getId() + ",definitionId=" + instance
            .getProcessDefinitionId());

}

• 首先创建流程引擎实例，这里我们使用了 createStandaloneInMemProcessEngineConfiguration() 方法，创建了一个使用 H2 内存数据库的流程引擎实例（默认 JdbcUrl 为 jdbc:h2:mem:activiti）。此外，还有多种创建流程引擎实例的方法：
  
• 得到 ProcessEngine 实例之后，就可以获取 Activiti 定义的各个 Service 接口啦：

• 使用 RuntimeService 启动流程并返回实例，它提供了多种启动流程的方法：

运行结果：

id=5,definitionId=firstProcess:1:4

• id：指的是流程实例 ID。
• definitionId：流程定义 ID，是以冒号分隔的参数组合，格式为 Key:版本号:流程定义库表 ID。