程序员是块砖,哪里需要哪里搬
公司内部的OA系统最近要升级改造,由于人手不够就把我借调过去了,但说真的我还没做过这方面的功能,第一次接触工作流的开发,还是有点好奇是个怎样的流程。
项目主要用 Springboot + Flowable 重构原有的工作流程,Flowable 是个用 Java语言写的轻量级工作流引擎,上手比较简单开发效率也挺高的,一起学习下这个框架。
官方地址:https://www.flowable.org/docs/userguide/index.html,分享的只是简单应用,深入研究还得看官方文档。
Flowable 核心依赖
org.flowable flowable-spring-boot-starter 6.3.0 org.springframework.boot spring-boot-starter-jdbc org.springframework.boot spring-boot-starter-web org.mybatis.spring.boot mybatis-spring-boot-starter 1.3.2 mysql mysql-connector-java runtime
流程设计
工作流开发的核心是任务流程的设计,Flowable 官方建议采用业界标准BPMN2.0的 XML来描述需要定义的工作流。
我们需要在 resource 目录下创建 processes路径,存放相关的 XML流程配置文件。Flowable 框架会默认加载此目录下的工作流文件并解析 XML,并将解析后的流程配置信息持久化到数据库。
![04b4e322f96beeb50038c9b98e92537b.png](https://i-blog.csdnimg.cn/blog_migrate/6f77705f3af6a09d782f034cd20649e0.jpeg)
Flowable 是依赖于数据库的,但它并不需要我们手动的创建表,而是在程序第一次启动时,自动的向MySQL 中创建它所需要的一系列表。
spring: datasource: url: jdbc:mysql://47.93.6.5:3306/order?serverTimezone=UTC username: root password: 123455
![84abd88f2cc6efcc63b1a749e79eee79.png](https://i-blog.csdnimg.cn/blog_migrate/294d1fd6c23fb09aee16cf474a113236.jpeg)
看到项目启动成功一共生成了60个表,数量还是比较多的,建议使用专门的数据库存在这些工作流表。
![75d775cd309030c5b1f1843fd9a287f6.png](https://i-blog.csdnimg.cn/blog_migrate/9a9a72e2c519df6e6fc53c4f6bbc3a87.jpeg)
举个栗子:假如一个请假流程,需要经理审核通过,请假才能生效,如果他驳回流程结束。
![a0118ba2730cccf5df55c082def6c319.png](https://i-blog.csdnimg.cn/blog_migrate/8a716ba096221e075e9c08df8b1fb19c.jpeg)
接下来我们用 XML 翻译下上边的请假流程图,整体非常简单只要够细心就行了,一起看看每个标签都是什么含义。
<?xml version="1.0" encoding="UTF-8"?>
其实就是把流程图的各种线条逻辑,用不同的XML标签描绘出来了。
: 表示一个完整的工作流
: 对工作流的描述
: 工作流中起点位置(开始)
: 工作流中结束位置(结束)
: 代表一个任务审核节点(组长、经理等角色)
: 逻辑判断节点,相当于流程图中的菱形框
:链接各个节点的线条,sourceRef 属性表示线的起始节点,targetRef 属性表示线指向的节点。
上边这一大坨XML是不是看着超级麻烦,要是有自动生成工具就好了,我发现IDEA自带设计工具,但实在是太难用了。
![e7592553caab76bfbfbb72f71d719fc0.png](https://i-blog.csdnimg.cn/blog_migrate/94a395843c898ac55f030082e1ac43b3.jpeg)
作为一个面向百度编程的程序员,别的不行上网找答案的能力还是可以的,既然我都觉得写XML麻烦,那么想来官方肯定也想到了,说不定有现成的工具,逛了一圈官网https://www.flowable.org/downloads.html ,居然真的找到了。
github下载地址:https://github.com/flowable/flowable-engine/releases/download/flowable-6.4.0/flowable-6.4.0.zip,下载速度那是相当感人,而且这个工具需要自己安装.......
![ad3ac2c10402028eaf6ee2be52f87222.png](https://i-blog.csdnimg.cn/blog_migrate/1b48506bf1018f766c65d7e060d944cf.jpeg)
又找了个在线编辑的工具: http://www.learun.cn:8090/home_online.htm,各种折腾~,设计完流程后,直接复制自动生成的代码即可。
![4586a8256122c5667a76fa8f4d54eb38.png](https://i-blog.csdnimg.cn/blog_migrate/15a75bcc94b4a6e23084824a01f7d4d7.jpeg)
流程审批
流程设计完后剩下的就是对工作流的审批和生成流程图。
首先启动一个请假的流程,以员工ID staffId 作为唯一标识,XML文件中会接收变量 leaveTask,Flowable内部会进行数据库持久化,并返回一个流程Id processId ,用它可以查询工作流的整体情况,任务Id task为员工具体的请假任务。
注意:一个请假流程 processId中可以包含多个请假任务 taskId。
/** * @author xiaofu * @description 启动流程 * @date 2020/8/26 17:36 */ @RequestMapping(value = "startLeaveProcess") @ResponseBody public String startLeaveProcess(String staffId) { HashMap map = new HashMap<>(); map.put("leaveTask", staffId); ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("Leave", map); StringBuilder sb = new StringBuilder(); sb.append("创建请假流程 processId:" + processInstance.getId()); List tasks = taskService.createTaskQuery().taskAssignee(staffId).orderByTaskCreateTime().desc().list(); for (Task task : tasks) { sb.append("任务taskId:" + task.getId()); } return sb.toString(); }
用启动流程时返回的 processId 看一下一下当前的流程图
http://localhost:4000/leave/createProcessDiagramPic?processId=37513
![4653d9a8e7b846d5829c8b0dcb1d3802.png](https://i-blog.csdnimg.cn/blog_migrate/3e1d5e572ddb9420d3915bed659937a4.jpeg)
接下来将请假申请进行驳回 ,传入相应的 taskId 后执行驳回,再看看整个工作流的效果。
http://localhost:4000/leave/rejectTask?taskId=10086
/** * @param taskId * @author xinzhifu * @description 驳回 * @date 2020/8/27 14:30 */ @ResponseBody @RequestMapping(value = "rejectTask") public String rejectTask(String taskId) { HashMap map = new HashMap<>(); map.put("checkResult", "驳回"); taskService.complete(taskId, map); return "申请审核驳回~"; }
看到整个请假流程在经理审核这成功阻断了。
http://localhost:4000/leave/createProcessDiagramPic?processId=37513
![a265799a1db8427bc88e91fa2913c485.png](https://i-blog.csdnimg.cn/blog_migrate/1920586e2bcb8dfefdebe1f3e87d24d5.jpeg)
总结
开发工作流一般多用在OA系统等传统项目中,我也是第一次尝试做此类功能,收获还是蛮多的,技术栈又压进了一个知识点。今天分享的是个超级简单的demo,因为也是刚开始接触,等我用的贼溜的时候,再给小伙伴们做更成熟更深入的分享。
demo的github 地址:https://github.com/chengxy-nds/Springboot-Notebook/tree/master/springboot-work-flowable
原创不易,燃烧秀发输出内容,如果有一丢丢收获,点个赞鼓励一下吧!
整理了几百本各类技术电子书相送 ,嘘~,「免费」 送给小伙伴们,私信或者评论【666】自行领取。和一些小伙伴们建了一个技术交流群,一起探讨技术、分享技术资料,旨在共同学习进步。
![53c7f9a9c5fdfbbfa3e2b632e8aaae34.png](https://i-blog.csdnimg.cn/blog_migrate/2863e61ff48a85a79e11a99025e74cc7.jpeg)