Activiti 学习（二）—— Activiti 流程定义和部署

概述

在这一节，我们将创建一个 Activit 工作流，并启动这个流程，主要包含以下几个步骤：

定义流程，按照 BPMN 的规范，使用流程定义工具，用流程符号把整个流程描述出来
部署流程，把画好的流程定义文件，加载到数据库中，生成表的数据

流程设计器的使用

在 resources 目录下创建一个 bpmn 目录，用来存放流程定义文件。选中 bpmn 目录，点击菜单 New -> New Activity 6.x BPMN 2.x file，创建一个 *.bpmn20.xml。选中该文件，右键 view BPMN(Activity ) Diagram，可以看到 BPMN-Activiti-Diagram 流程设计页面。在该页面右键，可以在菜单选择图形，拖拽图形，连线，即可完成流程设计图

连线的时候，要选中图形，这时在图形的右上角会出现一个箭头符号。双击选中箭头符号，右键按住不放即可拉长完成连线

选中一个图形，下方会出现一个属性栏，以创建出差申请为例，这里只填任务名称和负责人

流程部署

流程部署就是将在设计器中定义的流程部署到 activiti 数据库中，Activiti 提供了多种部署流程的方式，包括自动部署、classpath 部署、输入流部署、zip/bar 部署和上传部署等方式，下面分别进行介绍：

1. 自动部署

Activiti7 可以自动部署流程，前提是在 resources 目录下，创建一个新的目录 processes，用来放置 bpmn 文件

2. classpath 部署

classpath 部署方式为采用代码进行部署，使用 Java 代码实现如下：

public class ActivitDemo {

    @Test

    public void testDeployment() {

        // 1. 创建 ProcessEngine

        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

        // 2. 获取 RepositoryService

        RepositoryService repositoryService = processEngine.getRepositoryService();

        // 3. 使用 service 进行流程部署，即把 bpmn 部署到数据库，并定义流程的名称

        Deployment deploy = repositoryService.createDeployment()

            	// 定义流程资源名称

                .name("出差申请流程")

            	// 加载待部署的资源，可以多次引用

                .addClasspathResource("bpmn/evection.bpmn20.xml")

            	// 完成部署

                .deploy();

    }

}

3. 输入流部署

Activiti 提供了按输入流（InputStream）方式部署资源，输入流的来源可以有多种，例如本地计算机、classpath 读取、网络读取方式等，下面是读取本地计算机方式进行部署方式的示例代码

public class ActivitDemo {

    @Test

    public void testDeployment() {

        // 1. 创建 ProcessEngine

        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

        // 2. 获取 RepositoryService

        RepositoryService repositoryService = processEngine.getRepositoryService();

        // 3. 获取输入流

        String filePath = "D:/workflow/bpmn/evection.bpmn20.xml";

        FileInputStream fileIns = new FileInputStream(filePath);

        // 4. 使用 service 进行流程部署

        Deployment deploy = repositoryService.createDeployment()

                .name("出差申请流程")

                .addInputStream("bpmn/evection.bpmn20.xml", fileIns)

                .deploy();

    }

}

4. zip/bar 部署

将流程资源文件压缩成 zip 包进行部署，同样采用流的方式

public void deployProcessByZip() {

    // 1. 获取流程引擎

    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

    // 2. 获取 RepositoryService

    RepositoryService repositoryService = processEngine.getRepositoryService();

    // 3. 流程部署

    InputStream inputStream = this.getClass()

        .getClassLoader()

        .getResourceAsStream("bpmn/evection.zip");

    ZipInputStream zipInputStream = new ZipInputStream(inputStream);

    repositoryService.createDeployment()

        .addZipInputStream(zipInputStream)

        .deploy();

}

5. 按字符串方式部署

采用字符串方式进行部署，实际是把一个字符串转换为字节流后进行部署，也为开发人员提供了多一种部署方式

public void deployProcessByStr() {

    // 1. 获取流程引擎

    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

    // 2. 获取 RepositoryService

    RepositoryService repositoryService = processEngine.getRepositoryService();

    // 3. 构建字符串

    String str = "<?xml version=\"1.0\" encoding=\"UTF-8\"?><definitions>...</definitions>"

    // 4. 流程部署

    repositoryService.createDeployment()

        .name("出差申请流程")

        .addStr("bpmn/evection.bpmn20.xml", str)

        .deploy();

}

采用字符串进行部署的优点是可以通过用户界面定义一个流程，然后进行部署，或者在测试时，直接将流程代码写入程序，进行流程部署

6. 动态 BPMN 模型部署

通过在程序中动态生成流程模型方式进行部署，动态创建 BPMN，需要在程序中指定每一个元素，并给出元素间的关系，最后将这些元素整合为一个完整的 BPMN

public void testDeploymentByBPMN() {

    // 1. 创建 BPMN 模型实例

    BpmnModel bpmnModel = new BpmnModel();

    // 2. 创建开始事件

    StartEvent startEvent = new StartEvent();

    startEvent.setId("startEvent");

    startEvent.setName("动态创建开始节点");

    // 3. 创建用户任务

    UserTask userTask = new UserTask();

    userTask.setId("userTask1");

    userTask.setName("用户任务节点1");

    // 4. 创建结束事件

    EndEvent endEvent = new EndEvent();

    endEvent.setId("endEvent");

    endEvent.setName("动态创建结束节点");

    // 5. 定义连接

    ArrayList<SequenceFlow> sequenceFlows = new ArrayList<>();

    ArrayList<SequenceFlow> toEnd = new ArrayList<>();

    SequenceFlow s1 = new SequenceFlow();

    s1.setId("sequenceFlow1");

    s1.setName("开始节点指向用户任务节点");

    s1.setSourceRef("startEvent");

    s1.setTargetRef("userTask1");

    sequenceFlows.add(s1);

    SequenceFlow s2 = new SequenceFlow();

    s2.setId("sequenceFlow2");

    s2.setName("用户任务节点指向结束节点");

    s2.setSourceRef("userTask1");

    s2.setTargetRef("endEvent");

    toEnd.add(s2);

    startEvent.setOutgoingFlows(sequenceFlows);

    userTask.setOutgoingFlows(toEnd);

    userTask.setIncomingFlows(sequenceFlows);

    endEvent.setIncomingFlows(toEnd);

    Process process = new Process();

    process.setId("process1");

    process.setName("test");

    process.addFlowElement(startEvent);

    process.addFlowElement(s1);

    process.addFlowElement(userTask);

    process.addFlowElement(s2);

    process.addFlowElement(endEvent);

    bpmnModel.addProcess(process);

    new BpmnAutoLayout(bpmnModel).execute();

    // 6. 部署

    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

    RepositoryService repositoryService = processEngine.getRepositoryService();

    Deployment deploy = repositoryService.createDeployment()

        .name("出差申请流程")

        .addBpmnModel("evection.bpmn20.xml", bpmnModel)

        .deploy();

}

7. 相关数据表分析

流程部署后，流程相关的资源全部以数据流的形式存储到数据表中，实际运行中，流程的处理都是通过调用数据表中的相关资源进行处理，下面介绍流程相关的数据表：

act_re_deployment

流程部署表，用于存放流程定义的部署信息，部署一个流程就会增加一条记录
act_re_procdef

流程定义表，用于存放流程定义的属性信息，和 act_re_deployment 是一对多的关系，act_re_procdef 表可以有多条记录，每条记录对应 act_re_deployment 中的一条记录
act_ge_bytearray

资源文件表，部署流程时，会将 BPMN 流程定义文件保存为一条记录，如果部署的流程还包括其他资源，也会增加相应的记录，例如 png 图片文件