--- theme: cyanosis --- 工作流审批功能是办公OA系统核心能力，如果让你设计一个工作流审批系统，你会吗？千万不要小瞧OA内部系统的复杂性，大家可以头脑风暴思考一下实现方案。要明白工作流审批涉及多个用户的任务流转，多个流程分支跳转，虽然是办公内部系统，但是这个系统并不简单如果没有强大的工作流引擎，难以高效扩展旧流程，难以增加新流程，工作流审批将成为公司所有人的噩梦但是在使用 activiti开源工作流引擎后，一切痛苦与噩梦均烟消云散\~ **activiti 支持新增流程非常简单，只需要两步1）画个流程图 2）搭配前端页面** ## 首先画一个流程图将文章开头的需求，转化为 activiti 流程图，使用Idea 安装 actiBPM 插件，创建该流程图，文件命名apply.mpmn，实现请假流程的二级审批能力 1. 一级主管审批 2. 超过3天，二级主管审批。 ![image.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/1766d036ca44486699557c44f51d11cc~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5LqU6Ziz:q75.awebp?rk3s=f64ab15b&x-expires=1758101975&x-signature=7yFmTmSpDWSg%2FI2cxiRpJzD7RsM%3D) ## 测试流程图 ### 首先创建工作流引擎，部署流程图 ```Java //创建工作流引擎 ProcessEngine engine = ProcessEngines.getDefaultProcessEngine(); //RepositoryService用于部署流程图 RepositoryService repositoryService = engine.getRepositoryService(); //部署请假流程图 repositoryService.createDeployment().addClasspathResource("processes/apply.bpmn").deploy(); ``` 部署流程图，这部分工作一般放在工作流的后台系统，**开发创建好流程图以后，上传部署到系统中。无需开发修改代码** `repositoryService.createDeployment().addClasspathResource("processes/apply.bpmn").deploy();` 这行代码负责部署流程图到流程引擎。工作流引擎会解析该流程图文件，创建流程模版，接下来就可以在使用该流程模版，发起流程实例了。 ### 员工zhang3，发起新流程，设置审批人 ```Java Map variableMap = new HashMap<>(); variableMap.put("applyUser", "zhang3"); variableMap.put("supervisor", "li4"); variableMap.put("upperSupervisor", "wang5"); ``` 员工zhang3 提出请假申请，在发起新流程时，通过OA其他系统，查到zhang3的一级主管是li4，二级主管是wang5，于是设置上审批人。有人疑问，以下变量`applyUser`等，是系统默认的，还是在哪里指定的？在创建主管审批节点时，指定审批人变量` ${applyUser}` ![image.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/23315cc05ac34d21a5fb569f2a889bd3~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5LqU6Ziz:q75.awebp?rk3s=f64ab15b&x-expires=1758101975&x-signature=7EcV4UzUj3si%2FSlNeu2Tlw81UIg%3D) 想象一下，如果请假类的流程均可能需要一二级主管审批，是不是可以在发起流程时，统一填充一二级主管审批人变量。这部分代码是不是就是通用的，新增流程时无需二次修改了。 ### 发起一个新流程 `ProcessInstance instance = runtimeService.startProcessInstanceByKey("apply_processor_1", variableMap);` 如上代码指定了全流程审批人，发起了一个新流程。有人会疑问`apply_processor_1` 是什么？在哪里指定的，这是流程模版的 Key，在使用Idea插件画流程图时，需要指定流程图的Key ![image.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/4d8604c910fa46e4a21c48ac41e8f3d4~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5LqU6Ziz:q75.awebp?rk3s=f64ab15b&x-expires=1758101975&x-signature=lbpGnePvlchzmSxSGxeWikHZnBY%3D) ### 申请人设置请假天数 ```Java TaskService taskService = engine.getTaskService(); Task firstTask = taskService.createTaskQuery().taskAssignee("zhang3").singleResult(); taskService.complete(firstTask.getId(), Maps.newHashMap("day", 4)); ``` 创建并开启流程实例后，工作流引擎相当于帮你执行了流程图的开始节点，然后流程执行到请假申请节点，此时通过 taskService 查询 zhang3的处理任务。TaskService是通过第一步ProcessEngine 获取到的，主要用于任务查询。有人会疑问，为什么要区分创建流程、处理申请人审批任务两个步骤，我们在提请假申请时，只需要提申请一步就完成了。实际上提请假申请时，系统会帮你创建好流程，然后自动替你完成审批。为什么工作流引擎要区分为两步呢？所有的流程图都需要经过开始节点，也都需要结束节点，如此设计方式，可以让工作流引擎的抽象层次更高。它可以在开始和结束时点建立事件通知，维护流程状态的完整性。接下来，zhang3 通过 taskService完成该任务，并且设置变量 day=4，即请假天数是4天。 ### 一级主管审批任务 ```Java Task secondTask = taskService.createTaskQuery().taskAssignee("li4").singleResult(); taskService.setVariable(secondTask.getId(), "result1", true); ``` 接下来，zhang3和领导li4 说，”我家里有事要请假，辛苦4哥审批一下“，领导在自己的审批后台查询审批任务，查到后，通过了审批任务。有人会疑问，怎么标识审批通过和不通过呢？ result1 是什么东西？系统默认的，还是在何处甚至的变量? 在流程图上配置的 ![image.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/a27d486a02e941639f213bcf1483d7f5~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5LqU6Ziz:q75.awebp?rk3s=f64ab15b&x-expires=1758101975&x-signature=xT%2B6GMH8t3sJ50e6pUv9eppJ3FU%3D) 工作流引擎没有审批通过不通过的概念。当流程上存在 A 和 B 两个分支时，流程图上可以使用排他网关进行分支判定。如请假流程图中，一级审批结果就是一个排他网关。在网关的下游分支上配置如果要走A分支，应该满足哪些条件；走B分支，要满足哪个条件；而排他网关上并没有配置路由条件。例如在一级主管审批后，流程上设置新的变量 result1，经过排他网关时，A分支是 `#{result1==true}` 判定通过，于是走了A分支。**工作流引擎负责检查网关的下级分支的条件是否满足，哪个条件满足走哪个分支。** 也就是说上一个任务在处理时，并不知道接下来走哪个分支，也没有指定走哪个分支，而是将自己的处理结果放到流程变量中，在排他网关的下游分支条件上根据流程变量进行判断，接下来走哪个分支，这就是工作流引擎对于流程的抽象。 **工作流引擎负责驱动流程到排他网关，至于走哪个分支，由分支上的条件决定！** 这个思维一定要记住哦\~ ### 继续剩余的流程一级主管审批通过后，需要判断是否需要二级审批，这时又有一个排他网关，使用的条件就是` #{day>3}`，或者 `#{day<=3}` 在第2步中，zhang3 申请了 4天的假期，于是走到了二级主管审批页面。二级主管wang5 在审批任务列表中，找到了zhang3的请假申请，然后点击了通过。 ```Java Task thirdTask = taskService.createTaskQuery().taskAssignee("wang5").singleResult(); if (thirdTask != null) { taskService.setVariable(thirdTask.getId(), "result2", true); log.warn("用户任务完成，流程ID:{}, 任务名称:{}, id:{}, assignee:{}", thirdTask.getProcessInstanceId(), thirdTask.getName(), thirdTask.getId(), thirdTask.getAssignee(), thirdTask.getDelegationState()); taskService.complete(thirdTask.getId()); } else { log.warn("没有查到二级主管审批任务"); } ``` 接下来流程上没有其他审批任务，但是引擎依然会继续驱动流程，如下图中二级主管审批结果通过或拒绝，分别进入到两个不同的终点。 ![image.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/d83073f3e6194d3e9bdb6d753463a811~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5LqU6Ziz:q75.awebp?rk3s=f64ab15b&x-expires=1758101975&x-signature=0M6X4y5dHYXQG9LtWfVgfMTgXb4%3D) 值得一提的是，上面的代码仅仅是各个审批人在处理审批任务时，必要的代码、通用的代码。如审批是否通过这一流程变量，完全可以统一规范，无需二次开发。例如二级主管审批通过设置了 result2，实际上可以使用二级主管审批这个节点的id 后缀，如 result\_10来代表执行结果，规范以后，流程审批代码更为统一。新增流程模版时，在审批任务节点，审批通过或审批拒绝均不需要再次开发代码。惊喜的事情是：我们没有开发任何一行`流程驱动`和`分支判定`相关的代码。但是我们依然需要处理前端页面。因为请假申请页面上，不同的假期类型需要的表单参数不同，需要新增前端页面，新增发起流程的后端接口。相比整体的流程控制代码，这部分开发工作量大大降低，难度更是大大降低。接下来，我提出一个问题，如果新增一个需求，要求请病假的时候，需要HR审批，你知道如何修改流程图，支持新的处理流程吗? 很简单，在审批通过终节点的前面，再加一个排他网关，判断请假类型== ”带薪病假“，如果条件通过则增加HR审批节点，如果条件不通过，则直接走到审批通过的终点。不需要开发一行代码就能支持需求哦\~ **有了工作流引擎 activiti ,新增和修改流程都变得非常简单，它帮我们完成了所有的流程驱动和分支判定工作。** 这就是工作流引擎的价值之一。 ### 如何查看完整的执行流程图通过流程引擎 ProcessEngine获取HistoryService；通过流程实例id，拿到流程执行的所有节点。执行记录如下图，可完整看到流程执行的完整过程。 ```Java List activityInstanceList = historyService.createHistoricActivityInstanceQuery().processInstanceId(instance.getId()).list(); for (HistoricActivityInstance historicActivityInstance : activityInstanceList) { log.warn("activityName:{},activityType:{}, assignee:{}, taskId:{}", historicActivityInstance.getActivityName(), historicActivityInstance.getActivityType(), historicActivityInstance.getAssignee(), historicActivityInstance.getTaskId()); ``` ![image.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/fb229ddf588d415490bd35867d967279~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5LqU6Ziz:q75.awebp?rk3s=f64ab15b&x-expires=1758101975&x-signature=pF53Opz0mx5PFJMIVmKRQUgSFzQ%3D) ## activiti 项目基础配置 ### 首先引入activiti pom ```POM org.activiti activiti-spring-boot-starter-basic 5.23.0 ``` 我使用的是activiti 5.x，配套的 Springboot starter parent是 ```POM org.springframework.boot spring-boot-starter-parent 2.5.4 ``` ### 配置数据源和工作流引擎配置类 activiti 需要使用方提供数据库配置，在项目启动时，activiti 会自动检查数据库是否包含activiti 相关的表，如果不包含，会自动帮你建表。在学习activiti 的过程中，我没有安装MySQL，而是使用H2 内存数据库，该数据库在Java进程中，随JVM同生共死，无需担心重复启动，数据被污染等问题，非常适合学习activiti 的时候使用

H2 需要的POM如下 com.h2database h2 runtime ### 全部示例代码 @SpringBootTest(classes = {ActivitiStartApplication.class}) class ActivitiStartApplicationTests { public static final Logger log = LoggerFactory.getLogger(ActivitiStartApplicationTests.class); @Autowired private ApplyTaskListener applyTaskListener; @Test void contextLoads() { System.out.println("启动成功"); ProcessEngine engine = ProcessEngines.getDefaultProcessEngine(); RepositoryService repositoryService = engine.getRepositoryService(); RuntimeService runtimeService = engine.getRuntimeService(); TaskService taskService = engine.getTaskService(); HistoryService historyService = engine.getHistoryService(); repositoryService.createDeployment().addClasspathResource("processes/apply.bpmn").deploy(); Map variableMap = new HashMap<>(); variableMap.put("applyUser", "zhang3"); variableMap.put("supervisor", "li4"); variableMap.put("upperSupervisor", "wang5"); ProcessInstance instance = runtimeService.startProcessInstanceByKey("apply_processor_1", variableMap); Task firstTask = taskService.createTaskQuery().taskAssignee("zhang3").singleResult(); log.warn("用户任务完成，流程ID:{}, 任务名称 :{}, id:{}, assignee:{}", firstTask.getProcessInstanceId(), firstTask.getName(), firstTask.getId(), firstTask.getAssignee()); taskService.complete(firstTask.getId(), Maps.newHashMap("day", 4)); Task secondTask = taskService.createTaskQuery().taskAssignee("li4").singleResult(); taskService.setVariable(secondTask.getId(), "result1", true); log.warn("用户任务完成流程ID:{}, 任务名称 :{}, id:{}, assignee:{}", secondTask.getProcessInstanceId(), secondTask.getName(), secondTask.getId(), secondTask.getAssignee()); taskService.complete(secondTask.getId()); Task thirdTask = taskService.createTaskQuery().taskAssignee("wang5").singleResult(); if (thirdTask != null) { taskService.setVariable(thirdTask.getId(), "result2", true); log.warn("用户任务完成，流程ID:{}, 任务名称:{}, id:{}, assignee:{}", thirdTask.getProcessInstanceId(), thirdTask.getName(), thirdTask.getId(), thirdTask.getAssignee(), thirdTask.getDelegationState()); taskService.complete(thirdTask.getId()); } else { log.warn("没有查到二级主管审批任务"); } log.warn("流程执行过程如下"); List activityInstanceList = historyService.createHistoricActivityInstanceQuery().processInstanceId(instance.getId()).list(); for (HistoricActivityInstance historicActivityInstance : activityInstanceList) { log.warn("activityName:{},activityType:{}, assignee:{}, taskId:{}", historicActivityInstance.getActivityName(), historicActivityInstance.getActivityType(), historicActivityInstance.getAssignee(), historicActivityInstance.getTaskId()); } } } ## activiti 工作流引擎数据库设计为了保证流程的可靠性和可恢复性，工作流引擎通常会将流程实例的状态和数据持久化存储到中。在流程执行过程中，引擎会不断地更新数据库中的状态数据。，activiti 共包含了一系列用于存储流程定义、运行时数据以及历史记录的表。 ##### 1.流程定义相关表 * ACT\_RE\_\*系列表：主要包括流程定义（Process Definitions）、流程资源（Resources）和其他静态信息的存储。 ##### 2.运行时数据表 * ACT\_RU\_\*系列表：这些表存放了流程实例执行过程中的实时数据，如任务（Tasks）、流程实例（Process Instances）、变量（Variables）、执行对象（Executions）等。 ##### 3. 历史数据表 * ACT\_HI\_\*系列表：当流程实例结束或达到特定条件时，相关的运行时数据会被迁移到历史表中，以供后期审计、报告分析之用。 ##### 4. 身份和权限表 * ACT\_ID\_\*系列表：主要用于存储用户、组以及相关的身份和权限信息。 ##### 5. 其他辅助表 * 包括事件日志表：（Event Log）、作业及定时器表（Job and Timer entities）等，它们服务于调度、异步处理等功能需求。 ## 工作流引擎API 介绍 ![image.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/baca9d118eb14b42badbdd55db1a24bc~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5LqU6Ziz:q75.awebp?rk3s=f64ab15b&x-expires=1758101975&x-signature=giOaYCR59FLQl6Lmpi39exN01Sw%3D) * `ProcessEngine`: 表示Activiti工作流引擎的入口，用于获取各种管理API操作的对象。 * `RepositoryService`: 用于管理流程定义的API，包括流程的部署和删除等操作。 * `RuntimeService`: 用于管理流程实例的API，包括启动、暂停和删除流程实例等操作。 * `TaskService`: 用于管理任务的API，包括创建、完成和查询任务等操作。 * `HistoryService`: 用于查询历史记录的API，包括查询已完成的任务、流程实例和变量等信息。这5个Service我们已经很熟悉了，现在跟大家介绍这部分API，大家应该更容易理解了。其中 ProcessEngine我们用来获取各类Service类，RepositoryService 用来部署流程图，RuntimeService用来创建流程图实例、TaskService用来查询任务和完成任务；HistoryService用来查看流程执行过程。 ## 什么是BPMN流程图 > **BPMN（‌Business Process Modeling Notation）‌是一种流程建模的通用和标准语言，‌用来绘制业务流程图，‌以便更好地让各部门之间理解业务流程和相互关系。‌** BPMN 1.0规范于2004年5月对外发布，‌而BPMN 2.0标准由OMG于2011年推出，‌对BPMN进行了重新定义。‌ Activiti 是由 jBPM 的创建者 Tom Baeyens 离开 JBoss 之后建立的项目，构建在开发 jBPM 版本 1 到 4 时积累的多年经验的基础之上，旨在创建下一代的 BPM 解决方案。同时 Activiti 选择了 Apache 许可，一方面是希望 Activiti 能有更长久的生命力，因为它不受任何个人或是公司的控制而是属于整个社区，另一方面更是希望这个宽松的许可能够让 Activiti BPM 引擎和 BPMN2.0 被更广泛的采纳、使用和商业化。 ### Idea actiBPM 插件如何安装 ### Idea新建的流程图是什么本质是一个XML，可以通过BPMN 可视化工具解析，如下XML代码是请假流程图 #### 创建一个二级主管审批节点。 `` #### 创建一个审批结果的分支分支上包含连接了哪两个节点，以及分支的条件表达式 `#{result2==true}` ```XML ``` #### 请假流程图完整XML ```XML 3}]]> ``` ## 工作流引擎同类对比比较流行的 Camunda 和 Flowable 都是基于activiti 开发的。 ![image.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/089c54ba341346a7bf4f342dd917188d~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5LqU6Ziz:q75.awebp?rk3s=f64ab15b&x-expires=1758101975&x-signature=bCCuWRUkhIbuEyjavKoNTs360Mc%3D) ### 同类框架对比 ![image.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/3654111b3a9e46ea9ef138de727dd4c4~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5LqU6Ziz:q75.awebp?rk3s=f64ab15b&x-expires=1758101975&x-signature=xGJopqEXVwkwsN97HboR%2Bebmxuc%3D) ![image.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/0c90acc59f6845ca992d45d40b6eee4a~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5LqU6Ziz:q75.awebp?rk3s=f64ab15b&x-expires=1758101975&x-signature=hDdcBEOACIDZklbJQ7D1702kNBY%3D) 3个框架的使用流程基本一致 ### 使用流程 5板斧 1. 定义BPMN流程图，使用建模工具设计定义流程图。 2. 部署流程，将BPMN流程图部署到工作流引擎中。 3. 启动流程实例，通过工作流引擎基于流程模版，启动新流程实例。 4. 执行任务，流程执行中，引擎会为任务节点创建任务，分配给对应执行人。 5. 监听事件，开发者可以注册监听器来捕获流程执行过程中的各种事件，例如任务完成、流程结束等。 6. 查询和监控，工作流引擎通常提供了查询和监控功能，允许开发者和管理人员查看流程实例的状态、任务执行情况以及历史数 ## 继续学习方向 * 事件类型和事件监听。 * 任务类型；接受任务、服务任务、脚本任务学习 * 任务监听和执行监听器 * 表单管理 * 顺序流程和网关（并行网关等） * 性能和扩展；ID生成和分库分表 ## 总结 1. **activiti 工作流引擎适用场景，涉及多用户参与的流程管理。** 2. activiti 工作流开发分两步 1）设计流程图 2）部署流程图 3) 发起和驱动流程实例 3. 新增流程模版，无需开发代码驱动流程和分支判定。仅需要适配前端页面和简单的后端交互类接口。 # 我的开源项目最后夹带一点私货，五阳最近花了3个月的时间完成一个开源项目。开源3周以来，已有近 **230** 多个关注和Fork Gitee： GitHub [https://github.com/juejin-wuyang/memberclub](https://gitee.com/link?target=https%3A%2F%2Fgithub.com%2Fjuejin-wuyang%2Fmemberclub) 开源平台上有很多在线商城系统，功能很全，很完善，关注者众多，然而实际业务场景非常复杂和多样化，开源的在线商城系统很难完全匹配实际业务，广泛的痛点是 * 功能堆砌，大部分功能用不上，需要大量裁剪； * 逻辑差异点较多，需要大量修改； * 功能之间耦合，难以独立替换某个功能。由于技术中间件功能诉求较为一致，使用者无需过多定制化，技术中间件开源项目以上的痛点不明显，然而电商交易等业务系统虽然通用性较多，但各行业各产品的业务差异化极大，所以导致以上痛点比较明显所以我在思考，有没有一个开源系统，能提供电商交易的基础能力，能让开发者搭积木的方式，快速搭建一个完全契合自己业务的新系统呢？ * 他们可以通过编排和配置选择自己需要的功能，而无需在一个现成的开源系统上进行裁剪 * 他们可以轻松的新增扩展业务的差异化逻辑，不需要阅读然后修改原有的系统代码！ * 他们可以轻松的替换掉他们认为垃圾的、多余的系统组件，而不需要考虑其他功能是否会收到影响开发者们，可以择需选择需要的能力组件，组件中差异化的部分有插件扩展点能轻松扩展。或者能支持开发者快速的重新写一个完全适合自己的新组件然后编排注册到系统中？ memberclub 就是基于这样的想法而设计的。它的定位是电商类交易系统工具箱，以SDK方式对外提供通用的交易能力，能让开发者像搭积木方式，从0到1，快速构建一个新的电商交易系统！ ![image.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/617c1762a80c46aa99a406569876368f~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg5LqU6Ziz:q75.awebp?rk3s=f64ab15b&x-expires=1758101975&x-signature=%2BWfBuxdm%2BXlHXTvDo8nCBdiCFCY%3D) 具体介绍可参见 **Gitee开源地址**： **GitHub开源地址** : 在这个项目中你可以学习到 SpringBoot 集成以下框架或组件。 1. Mybatis、Mybatis-plus 集成多数据源 2. Sharding-jdbc 多数据源分库分表 3. redis/redisson 缓存 4. Apollo 分布式配置中心 5. Spring Cloud 微服务全家桶 6. RabbitMq 消息队列 7. H2 内存数据库 8. Swagger + Lombok + MapStruct 同时你也可以学习到以下组件的实现原理 1. 流程引擎的实现原理 2. 扩展点引擎实现原理 3. 分布式重试组件实现原理 4. 通用日志组件实现原理参考： 5. 商品库存实现原理：参考： 6. 分布式锁组件：参考： 7. Redis Lua的使用 8. Spring 上下文工具类参考：