Activiti 介绍
Activiti 是一个开源架构的工作流引擎,基于bpmn2.0 标准进行流程定义。其前身是JBPM,Activiti 通过嵌入到业务系统开发中进行使用。
官方是这样介绍 activiti的:
Activiti 是领先的轻量级、以 Java 为中心的开源 BPMN 引擎,支持现实世界的流程自动化需求。Activiti Cloud现在是新一代业务自动化平台,提供一组旨在在分布式基础架构上运行的云原生构建块。
Activiti的服务接口
Activiti 提供了 7 个服务接口,都通过 ProcessEngine 来获取,并且支持链式编程风格:
服务接口 | 说明 |
RepositoryService | 提供一系列管理流程部署和流程定义的API。 |
RuntimeService | 在流程运行时对流程实例进行管理与控制 |
TaskService | 对流程任务进行管理,例如任务提醒、任务完成和创建任务等 |
IdentityService | 提供对流程角色数据进行管理的API,这些角色数据包括用户组、用户及它们之间的关系。 |
ManagementService | 提供对流程引擎进行管理和维护的服务。 |
HistoryService | 对流程的历史数据进行操作,包括查询、删除这些历史数据。 |
FormService | 表单服务,管理流程和任务相关的表单 |
Activiti 实战
该次的目的,主要是完成一个请假流程,请假流程如图所示:
引入依赖
因为5.x版本和7.x版本相差较大,这次分享的是5.x版本,其次因为5.x版本简单点
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-spring-boot-starter-basic</artifactId>
<version>5.23.0</version>
</dependency>
1 2 3 4 5
配置文件
注意两个配置项:database-schema-update、check-process-definitions
数据库表的更新或创建
database-schema-update 设置为TRUE,将会创建所需要的数据库表,首次建议设置为TRUE
生成的数据库表总共有28张,分为了5类
数据表 | 说明 |
act_ge_ 通用数据表 | ge是general的缩写 |
act_hi_ 历史数据表 | hi是history的缩写,对应HistoryService接口 |
act_id_ 身份数据表 | id是identity的缩写,对应IdentityService接口 |
act_re_ 流程存储表 | re是repository的缩写,对应RepositoryService接口,存储流程部署和流程定义等静态数据 |
act_ru_ 运行时数据表 | ru是runtime的缩写,对应RuntimeService接口和TaskService接口,存储流程实例和用户任务等动态数据 |
流程的部署
自动部署
check-process-definitions: 设置为true,将会部署process/下所有流程,首次建议设置为TRUE
手动部署
需要自己写代码实现,通过读取资源文件进行部署:
- png文件和bpmn文件
- 通过 inputstream完成部署
- 通过读取zip文件流进行部署
- 通过读取bytes进行部署
整体的配置以及说明
activiti:
# flase: 默认值。activiti在启动时,会对比数据库表中保存的版本,如果没有表或者版本不匹配,将抛出异常。(生产环境常用)
# true: activiti会对数据库中所有表进行更新操作。如果表不存在,则自动创建。(开发时常用)
# create_drop: 在activiti启动时创建表,在关闭时删除表(必须手动关闭引擎,才能删除表)。(单元测试常用)
# drop-create: 在activiti启动时删除原来的旧表,然后在创建新表(不需要手动关闭引擎)。
# todo 首次设置为true,将会创建所需要的表
database-schema-update: false #数据库更新策略
# 自动部署验证设置:true-开启(默认)、false-关闭
# todo 首次设置为true,将会部署process/下所有流程
check-process-definitions: false
# 指定activiti流程描述文件的前缀(即路径)
process-definition-location-prefix: classpath*:process/
# suffix 是一个String数组,表示描述文件的默认后缀名,默认以上两种。
# process-definition-location-suffixes:
# - **.bpmn
# - **.bpmn20.xml
#保存历史数据级别设置为full最高级别,便于历史数据的追溯
# none:不保存任何的历史数据,因此,在流程执行过程中,这是最高效的。
# activity:级别高于none,保存流程实例与流程行为,其他数据不保存。
# audit:除activity级别会保存的数据外,还会保存全部的流程任务及其属性。audit为history的默认值。
# full:保存历史数据的最高级别,除了会保存audit级别的数据外,还会保存其他全部流程相关的细节数据,包括一些流程参数等。
history-level: full
idea 使用 BPMN 流程图
下载插件
命名格式为 xxx.bpmn20.xml 即可在idea查看编辑流程
比较容易混淆的ID
ID | 说明 |
processDefinitionId | 是流程定义Id,在部署完成之后会产生; |
processInstanceId | 是流程实例Id,启动流程的时候生成,可以通过流程定义Id来启动流程实例; |
executionId | 当流程中没有分支时,Execution等同于ProcessInstance,甚至连ID也相同; 当流程中存在分支(fork, parallel gateway),则在分支口会形成子Execution,在下一个gateway才会合并(joined) |
activityId | 当前运行活动标识ID |
学习案例:RuoYi-activiti: 基于Activiti6.0,集流程设计、流程部署、流程执行、任务办理、流程监控于一体的开源工作流开发平台。
实践案例:
swagger路径:
http://localhost.huawei.com:8080/doc.html#/home
postman 调用接口图片返回流展示
postman 验证码 图片返回流 stream 如何展示?_postman stream-CSDN博客