工作流入门教程（flowable框架）

2022-08-31 11:11:37 浏览数 (1)

大家好，又见面了，我是你们的朋友全栈君。

最近有一段时间没写博客了，本来打算写写对于工作流的心得，但是工作时间比较饱和只好延后。最初接触工作流是上一家公司工作，具体我不透露哪家公司，只是感受到人情冷暖，或许公司都是这样，当你的价值被用完了也就是你走人的时候。好了，废话不多说，我们直接进入主题。

前言

对于框架的选型，我推荐使用flowable框架，在最初的项目选型是选择activiti的,但是深入去了解框架的时候发现activiti还是有一些坑的，而flowable正是activiti框架的修正版，据了解flowable的背景是activiti原班人马开发出来的框架，而主导这个框架上更是得心应手，也修复了activiti的诸多bug。可能很多开发人员在框架选型上比较困扰，一方面出于对学习成本的考虑，一方面对框架性能、稳定性的考虑。在这里，我认为一个框架是否优秀的评判标准，不能取决于用的人多，而在于它的功能是否丰富，性能是否优越，后期扩展是否灵活等等，综合考虑下去选择。

入门详解

考虑到读者会先了解一下flowable框架是否满足自身的项目需求，所以我会先入门讲解一下flowable框架的大致功能，后续再进行框架搭建。

flowable官方手册

对于flowable的了解也是来源于flowable的中文版手册，里面介绍得很详细，而我下面对一些常用的功能进行归纳总结。

应用
  • 那么在什么场景下可以使用工作流呢？

比如，你实际的业务需求比较流程化，可能每一个步骤都需要有相关的人进行审批，直到最后结束，就像一条生产线一样，那么你就要考虑应用工作流框架了。举个例子：请假审批流程、财务审批流程、入职流程等等。

  • 使用这个工作流有什么好处（优势）？

其实工作流框架在功能的应用上可能看不出来有什么明显的变化，但是对于内部代码上却可以很好的解耦，使得业务代码只需要关心当前的业务，而不需要进行流程的逻辑判断，一切交由工作流框架进行流转。除此之外，如果项目的流程化业务多那么接入工作流的好处就是可以将多个流程归结起来统一管理进行监控、性能分析等等。

举个例子：某业务上有三个步骤，每个步骤需要有相关人员进行审核，才能流转到下一步骤，每个步骤都有自己的业务逻辑。遇到上面的情况，第一种不整合工作流的做法就是三个步骤连在一起写，包括流转到下一步骤的判断，审核人员也需要根据在哪一步骤去判断获取相关人员，那么这种做法可行吗？可行，但是写起来代码臃肿，在代码上我们可以想办法把每个步骤抽离出来，但是如果步骤很多而且很多都是相同的逻辑，那这个代码看起来就不优雅了。有没有更加优雅的做法？有的，那就是使用工作流。

代码语言：javascript复制
工作流的做法如下：
1. 流程画图，主要是通过可视化工具进行画图生成一个xml。
2. 流程部署，将流程图部署起来，写入到数据库中
3. 编写每个步骤的业务逻辑，如果多个步骤中的业务逻辑有相同的，则只写一个就可以了
4. 将写好的业务逻辑挂在在流程节点上
5. 启动项目，执行相关业务功能

对于上面两种做法，你可以理解为第一种做法有点类似于面向过程，就是事无大小都是自己亲力亲为去执行，第二种做法有点类似于面向对象，工作流充当指挥者，指挥着每个碎片化的业务逻辑，孰优孰略显而易见。

  • 接入工作流难吗？

不难，建议多参考官方手册，后面会说说搭建的问题，还有一些需要注意的点。

  • 如何画流程图？

首先你需要下载一个flowable的插件，画图也容易，都是组件式拖拽完成画图，然后在里面配置参数。

功能

我先大体介绍一下flowable里面到底有哪些功能，后面再去详细地整合flowable框架，下面就先看看功能点欣赏一下就好～

  • 流程部署
代码语言：javascript复制
Deployment deployment = repositoryService.createDeployment()
                .name(process_name)
                .addClasspathResource(resource_path)
                .deploy();
  • process_name 传入一个流程定义名称，这个名称代表着这个流程定义模版的唯一命名，在发起流程需要根据唯一命名进行关联。
  • resource_path 传入部署流程图的路径，该文件是一个流程定义的xml文件
  • 上述代码是一个部署流程图的代码片段，主要作用是将画好的流程图写入到数据库中，一切的流程运行都是在读取数据库中进行操作
  • 启动流程
代码语言：javascript复制
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(process_name, map);
  • process_name 流程定义名称
  • map 流程变量，根据这些变量实现流程节点的流转，如金额达到10000，才可以给财务人员审批，那么这个金额就是流程变量。
  • 上述代码作用是启动一个流程实例，也就是说一个流程定义的模版可以启动多个流程实例。举个例子：如果一个请假流程有大概步骤：写请假条–>找上级领导申请 –> 经理审批 –> 结束。 那么，这个流程我们称为流程定义模版，而张三实际发起的一个流程，称为流程实例。
  • 流程从当前节点跳转下一节点
代码语言：javascript复制
taskService.complete(taskId, map);

假设你现在的节点走错了想要退回去上一个节点，或者这个节点你想走到某一个节点，你可以调用一个跳转任意节点的方式实现。

代码语言：javascript复制
runtimeService.createChangeActivityStateBuilder().processInstanceId(task.getProcessInstanceId()).moveActivityIdTo("approve1", "apply").changeState();
  • processInstanceId(processId) 根据流程实例ID去定位到该流程上实现节点跳转
  • moveActivityIdTo(“approve1”, “apply”) 传入两个节点ID，节点ID在流程画图的时候设置好
  • 显示流程图
代码语言：javascript复制
 BpmnModel bpmnModel = repositoryService.getBpmnModel(pi.getProcessDefinitionId());
 ProcessEngineConfiguration engconf = processEngine.getProcessEngineConfiguration();
 ProcessDiagramGenerator diagramGenerator = engconf.getProcessDiagramGenerator();
 InputStream in = diagramGenerator.generateDiagram(bpmnModel,"bmp", activityIds,flows,"宋体","宋体","宋体",null,1.0);

流程图部分代码片段，flowable框架自带的根据流程定义图生成的流程实例图，对当前正在进行的节点标红，可以很好的嵌入到前端给用户展示。

搭建flowable

flowable搭建整理

角色权限

接上述待办列表提及到的角色绑定关系，这里来详细介绍如何做到查询待办可以只让当前操作人看到。

工作流的流程节点上是有用户和用户组的概念的，那么我们在流程画图的时候需要先提前指定该节点是由用户组操作还是由用户操作，这里的用户组其实说的就是“一群人“可以完成这个节点的操作，如何代表”一群人“，那么你需要有一个key值去映射多用户的关系。而在节点指定的是用户，那么就只有这个用户可以操作。

在实际的项目中，我们会有自己的一套<用户-角色-权限>体系,那么我们可以根据这套体系去对接工作流中的节点权限，所谓节点权限就是指这个节点处于当前操作的情况下有哪些用户可以去操作。

  • 那么怎么在节点上指定一个权限呢？

首先，如果你实际的项目中是有一套权限体系的，那么需要看你是根据权限来还是根据角色来，因为一个权限可以对应多个用户，一个角色也可以对应多个用户。本人当时是根据角色code去对接的，你可以理解为一个角色的一个唯一标识。 示例：

代码语言：javascript复制
<userTask id="approve1" name="AP Settlement Leader" activiti:category="FINANCE-BOOKING-REPORT-AUDIT-1" xmlns:flowable="http://flowable.org/bpmn" flowable:candidateGroups="FINANCE-BOOKING-REPORT-AUDIT-1"></userTask>
  • FINANCE-BOOKING-REPORT-AUDIT-1 上面是一个流程图xml文件里的一个流程节点，而这个“FINANCE-BOOKING-REPORT-AUDIT-1”就是我们业务的角色code.
  • 如果我们想指定一个用户，但是这个用户事先不知道是谁，一般应用在流程发起人，那么怎么指定呢？ 这里有个配置的示例：
代码语言：javascript复制
<userTask id="apply" name="Settlement Operator" xmlns:flowable="http://flowable.org/bpmn" flowable:assignee="${user_account}"></userTask>

这里的“user_account”是一个流程变量的一个key，只要在调用流程发起的时候传入一个map映射一个用户名,那么流程在运行的时候就可以根据流程变量解析出用户，动态地将用户指定到节点上。当然，flowable:assignee这里也可以直接指定一个写死的用户名，那么这个节点就只有这个用户能够操作了

总结

有几个地方需要注意，也是我自身亲身经历总结出来的：

  1. 在整合工作流框架上你需要考虑一下自己是否也需要有一套持久层去记录一下节点的流转，如果你的流程设计较为复杂，对于数据存取现有的flowable的api不能很好的支持操作，那么你需要另外建立几个数据表去记录节点的流转，方便数据存取；如果你的流程本身就依照flowable的规范去设计，那么你大可使用flowable的api去操作数据。 我结合以前的事例谈谈我的看法，当时的业务还没整合工作流的时候，我们是有一些数据表去记录流程的流转的，但是这些表对业务的粘合性太强，举个例子，就是对账单审核流程这些表上都是对账单的业务，当初设计的数据表完全不通用。所以在建表的时候是建议考虑通用的方式去建表，而不是针对某一个业务上的流程就建立某一业务的流程表，这样可以对多个不同类型的流程归集在一起统一管理，方便想要做流程监控，日志采集什么的都很方便。 如果是在原有功能上整合加上工作流，在这种尴尬的场景下，应该也是多数人遇到的情况，那么长痛不如短痛，将数据迁移，数据表的设计上保持通用，考虑多个流程的记录。你可能需要建立两张主要的表，一张记录每个流程实例，一张记录流程流转节点。 其次，我也遇到过比较特殊的场景，就是要根据业务条件去搜索查询待办任务，既然是根据业务条件去查询待办，那么单纯去工作流服务查询获取数据那是不可能的，工作流服务里面存放的都是流程信息，很少存放一些业务信息，除非是控制流程流转条件的业务数据才存放进去。 那么怎么做到可以在业务服务上查询待办信息呢？ 首先，会有人说可以把业务数据都放在工作流服务上呀，这样不就可以根据条件去查询待办信息。这样做是可以，但是成本很高，假设你的项目有几十个流程，每个流程的业务数据很多，那么流程变量的创建就很多，表与表之间的关联就非常复杂了，关键是每个流程的业务本身就不是相互通用的，所以这无疑就增加了实现的复杂度。那么，我当时的做法是，在业务服务上针对这一个业务建立一个存放该业务的流程实例的表（因为只有这个业务有这种需求去根据条件查询待办信息），这个表里面会记录当前流转到哪个节点ID,在查询待办信息的时候根据用户角色，获取对应可以审核的节点，从而过滤出需要待办的列表。
  2. 需要实现一套在产线执行错误的情况下可以回滚节点的机制 比如，产线上执行金额审批上出错了，造成这一笔资金迟迟不能运作，这是个很严重的问题，如果没有一套回滚的策略，那么你的功能在用户体验上大打折扣。结合我本身的经历，需要提供一套在节点出错的情况下可以回滚的接口进行人工操作回退，又或者第二种，当业务上发生错误的情况，流程审核也要保持一致进行回滚。 前者是人为操作，一般出现这种情况都是由于业务服务上出错了，但是继续调用执行了工作流服务，这种是分布式事务的问题。那么你可以在界面上提供一个人工修复流程节点的功能，方便用户操作。后者是自动操作，一般用户没有察觉流程上出错了，而是业务提示报错，流程操作跟着业务一起回滚，后者是完全实现了分布式事务的回滚。实现分布式事务的回滚，可以采用TCC机制，也可以通过可靠消息实现最终一致性。具体看场景应用来选择。
  3. 记录流程实例在数据量大的情况下要考虑数据备份 我说一个例子，我们有个业务订单流程，每个订单都会对应一个流程实例，每天都有很多订单，不到几个月就有几百万的订单，数据量是会很多的，如果双十一那数据会更加恐怖，那么有两种做法，如果这些单都是走完流程的，也无需进行统计，那么就不需要进行记录，直接物理删除，及时削减数据量，防止数据量过大影响数据读写。如果业务本身记录这些数据是有意义的，需要用来做统计，那么那些流程数据已经走完成为历史的需要进行迁移，可以建立一套数据仓库方便后期数据统计。后者对于设备有一定要求，需要搭建一套数据仓库来存储，然后进行数据分析。

发布者：全栈程序员栈长，转载请注明出处：https://javaforall.cn/143440.html原文链接：https://javaforall.cn

api activiti key map 工作流

0 人点赞