流程引擎之Activiti简介

背景

Activiti 是一个开源架构的工作流引擎，基于 bpmn2.0 标准进行流程定义，其前身是 jBPM，Activiti 相对于 jBPM 更轻量，更易上手，且天然集成了 Spring。2010年 jBPM 创始人 Tom Baeyens 离开 JBoss，随之加入 Alfresco 后很快推出了新的基于 jBPM4 的开源工作流系统 Activiti5 ：

附 Activiti 官方地址：

• Activiti 官方主页：https://www.activiti.org/

• Activiti github 代码：https://github.com/Activiti/Activiti

• Activiti 官方文档：https://www.activiti.org/userguide/#_introduction

Activiti 使用

1）Activiti 官方 demo 使用

Activiti 官方提供了 demo 供初学者入门使用，使用流程如下（尽量参考官方文档）：

Step 1：下载 activiti-6.0.0.zip，并解压，找到 activiti-admin.war、activiti-app.war、activiti-rest.war 所在目录

activiti-admin.war、activiti-app.war 和 activiti-rest.war 是 Activiti 官方提供的 demo 应用（详细使用可参考官方文档：https://www.activiti.org/userguide/）：

• activiti-admin.war：连接好 Activiti endpoint 后，可通过该模块查看流程定义、发起的流程实例、任务等

• activiti-app.war：核心 Activiti demo，提供在线流程设计器、表单管理、应用管理、用户管理等功能

• activiti-rest.war：提供 Restful 风格的服务

附 activiti-6.0.0.zip 下载地址：https://www.activiti.org/get-started

Step 2：将上述三个 war 包放到 tomact webapps 目录中，启动 tomcat

注意，tomcat 版本使用 Tomcat 9.0.0 以下，否则无法启动。

Step 3：activiti-admin 示例。访问 http://localhost:8080/activiti-admin，并账密（admin/admin）登录

activiti-admin 主要提供数据监控，访问时需要提前连接 Activiti endpoint，否则没有任何数据，这里配置了 activiti-app（主核心demo）的端口，即在 activiti-app demo 中操作的流程任务数据在这里都可以查看到。

Step 4：activiti-app 示例。访问 http://localhost:8080/activiti-app，并账密（admin/test）登录

activiti-app 是 Activiti 官方提供的核心 activiti demo，也可称为 Activiti UI，提供了在线流程设计器、任务管理和用户管理模块，运行时数据默认存储在 H2（也可修改配置来替换数据库），下图为示例页面：

Step 5：activiti-rest 示例。访问 http://127.0.0.1:8080/activiti-rest/docs/，并账密（kermit/kermit）登录

Activiti 包含一个连接到 Activiti engine 的 rest api，可以通过将 activiti-rest.war 文件部署到 servlet 容器（如Apache Tomcat）来安装该 API。默认情况下，Activiti engine 将连接到内存 H2 数据库（可以更改 WEB-INF/classes 文件夹中 db.properties 文件配置来修改数据库，Activiti 启动后会自动初始化 23 张数据表）。另外，可通过引入 rest api 依赖将 rest api 集成到项目中，不再详述。

• 更多详细有关 Activiti rest api 说明参考：https://www.activiti.org/userguide/#_rest_api

2）Activiti 请假 demo 示例

以请假流程作为 Activiti 基本使用示例（流程示例同上述 acitiviti-app 应用流程文件示例），员工发起请假，然后项目经理审批，再HR审批，最后CEO审批，若其中任意一个人拒绝，员工则需要重新提交流程。

其中 demo 示例如下，完整源码参考：https://download.csdn.net/download/zhuqiuhui/87462382

3）Activiti 与 Spring Boot 集成

Activiti 与 Spring Boot 集成比较简单，只需要要引入以下依赖即可（不再示例），详细参考 Activiti 官方文档与 Spring 集成章节：https://www.activiti.org/userguide/#springintegration

<dependency>
	<groupId>org.activiti</groupId>
	<artifactId>activiti-spring-boot-starter-basic</artifactId>
	<version>${activiti.version}</version>
</dependency>

4）Activiti 与 jBPM 对比

Activiti 与 Spring 天然集成，同时有基于 Web 的 Activiti 流程设计器（详细参考上述官方 demo 中的 activiti-app.war 使用），另外，Activiti 在表结构设计上遵循运行时与历史数据的分离，可以快速读取运行时数据，仅当需要查询历史数据时再从专门的历史数据表中读取，这样大大的提高了数据的存取效率。

另外，相对于 jBPM，jBPM 与 jBoss 技术栈耦合太过紧密，国内社区不如 Activiti 活跃。

Activiti5 整体架构及相关核心类

Activiti5 整体架构

Activiti 工作流程如下：

• Step 1：通过入口配置文件 activiti.cfg.xml 或者自定义 ProcessEngineConfiguration 实例，得到流程引擎配置

• Step 2：由 ProcessEngineConfiguration实例得到 ProcessEngine 实例

• Step 3：通过 ProcessEngine 实例得到 Activiti 提供所有接口服务

• Step 4：执行流程引擎

使用示例：

ProcessEngineConfiguration cfg = new StandaloneProcessEngineConfiguration().....;
ProcessEngine processEngine = cfg.buildProcessEngine();
RepositoryService repositoryService = processEngine.getRepositoryService();
//......

另外，Activiti 使用命令模式作为基础开发模式，流程引擎服务类（如TaskService等）中定义的各个方法都有对应用的命令对象（如开启流程命令：StartProcessInstanceCmd 等)， 流程引擎服务类把各种请求委托成 xxCmd 交给 CommandExecutor 来执行，CommandExecutor 进一步交付给 CommandInterceptor 责任链来执行，xxCmd 来决定命令的接收者（参考 CommandContext），接收者执行后返回结果（参考下述 UML 图）。

Activiti5 核心类

1）EngineServices

该接口中定义了获取各种服务类实例对象的方法。

2）ProcessEngine 及默认实现类 ProcessEngineImpl

ProcessEngine 继承 EngineServices 接口，并增加了对流程引擎名称的获取以及关闭流程引擎的支持。ProcessEngineImpl 是 ProcessEngine 引擎的默认实现类，实际上是由 ProcessEngineConfigurationImpl 构造的，即 ProcessEngineImpl 调用 ProcessEngineConfigurationImpl 的方法获得服务。

3）ProcessEngineConfiguration 及默认实现 ProcessEngineConfigurationImpl

ProcessEngineConfiguration 是流程引擎配置类，ProcessEngineConfigurationImpl 继承 ProcessEngineConfiguration，负责创建一系列服务类实例对象、流程引擎实例对象以及ProcessEngineImpl 类实例对象，该类可以通过流程配置文件交给Spring容器管理或者使用编程方式动态构建。

常用的流程配置类如下：

• StandaloneProcessEngineConfiguration：标准的流程引擎配置类

• StandaloneInMemProcessEngineConfiguration：开发环境中自测使用，默认采用H2数据库存储数据。

• .......

4）ProcessEngines

该类负责管理所有的流程引擎 ProcessEngine 集合，并负责流程引擎实例对象的注册、获取、注销等操作。

5）流程引擎服务类

RepositoryService

RepositoryService 是 Activiti 的资源管理类，提供流程定义和部署相关的存储服务。

RepositoryService repositoryService = processEngine.getRepositoryService();

// 获取流程部署
Deployment deployment = repositoryService.createDeployment().addClasspathResource("MultiTask.bpmn")
                .name("流程测试")
                .category("")
                .deploy();
// 获取流程定义
ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery()
                .deploymentId(deployment.getId()).singleResult();

RuntimeService

RuntimeService 是 Activiti 的流程运行管理类，提供流程运行时相关的服务，如启动流程。

RuntimeService runtimeService = processEngine.getRuntimeService();

// 启动流程
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("myProcess", "Key001", vars);

TaskService

TaskService 是 Activiti 的任务管理类，提供任务节点的操作接口（如complete、delete、delegate等）

TaskService taskService = processEngine.getTaskService();
// 获取任务列表
List<Task> taskList = taskService.createTaskQuery().taskAssignee("mary").orderByTaskCreateTime().desc().list();

HistoryService

HistoryService 是 Activiti 的历史管理类，示例：

List<HistoricActivityInstance> historicActivityInstances = processEngine.getHistoryService()
                // 创建历史活动实例查询
                .createHistoricActivityInstanceQuery()
                //.finished() // 查询已经完成的任务
                .orderByHistoricActivityInstanceEndTime()
                .asc()
                .list();

IdentityService

IdentityService 是 Activiti 的认证管理类，用于管理和查询用户、组之间的关系。

IdentityService identityService = processEngine.getIdentityService();
identityService.setAuthenticatedUserId("createUserId");

......

6）JavaDelegate

作为 Activiti 的 ServiceTask 的实现，必须实现 JavaDelegate 接口，但是不需要实现序列化接口，Activiti 会使用反射机制将类初始化，因此在实现 JavaDelegate 接口的时候需要提供一个无参数的构造器，否则会抛出异常。

流程引擎系列文章

• 流程引擎之发展史及对比总结：https://blog.csdn.net/zhuqiuhui/article/details/128986403

• 流程引擎之KIE项目简介：https://blog.csdn.net/zhuqiuhui/article/details/129035796

• 流程引擎之jBPM简介：https://blog.csdn.net/zhuqiuhui/article/details/129052162

• 流程引擎之Activiti简介：https://blog.csdn.net/zhuqiuhui/article/details/129107741

• 流程引擎之Camunda简介：https://blog.csdn.net/zhuqiuhui/article/details/129107897

• 流程引擎之Flowable简介：https://blog.csdn.net/zhuqiuhui/article/details/129109273

• 流程引擎之compileflow简介：https://blog.csdn.net/zhuqiuhui/article/details/129109391