引言
工作偶尔会遇到需要审批相关的系统,对于流程步骤相对固定的,一般会采取某些第三方的工作流来做对应的系统。目前唯一用过的就是activiti工作流。对它进行了简单的研究学习。参考以前入门的文章,发现它大概会生成二十多表,但是很多表基本没有使用。由于对于其源码没有进入深层次的研究,所以一旦遇到流程错乱就容易找不到问题。基于此,尝试写一个简单的关于自定义流程的设计,多一个备选方案。
实现
1.设计基于需求,经典图
image.png
从这张图我抽出了四个对象:事件、节点、网关、流程线。
为什么这么抽取对象???
看前言寻找答案,找不到那就是因为经验!!!
为什么一根线走组长审批了还走经理,另外一根线直接走经理???
需求如此。。。。
2.贴代码的时候到了
2.1.整体目录设计
image.png
2.2.事件类
package com.example.customprocessengine.model;
import lombok.Getter;
import lombok.Setter;
import javax.persistence.Entity;
import javax.persistence.Id;
@Entity
@Getter
@Setter
public class Event {
@Id
private Long id;
private String eventId;
private String eventName;
}
2.3.网关
package com.example.customprocessengine.model;
import lombok.Getter;
import lombok.Setter;
import javax.persistence.Entity;
import javax.persistence.Id;
@Entity
@Getter
@Setter
public class ExclusiveGateway {
@Id
private Long id;
private String gatewayId;
private String name;
}
2.4.节点
package com.example.customprocessengine.model;
import lombok.Getter;
import lombok.Setter;
import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.OneToOne;
@Entity
@Getter
@Setter
public class UserTask {
@Id
private Long id;
private String taskId;
// private String taskname;
/*@ElementCollection
private List username;*/
@OneToOne
private Parameter parameter;
@OneToOne
PassCondition passCondition;
}
2.5.流程线
package com.example.customprocessengine.model;
import lombok.Getter;
import lombok.Setter;
import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.OneToOne;
@Getter
@Setter
@Entity
public class SequenceFlow {
@Id
private Long id;
private String sourceRef;
private String targetRef;
private String conditionExpression;
@OneToOne
private Parameter parameter;
}
2.6.延伸重要类-进行中的任务
package com.example.customprocessengine.model;
import lombok.Getter;
import lombok.Setter;
import javax.persistence.*;
import java.time.LocalDateTime;
import java.util.List;
@Entity
@Getter
@Setter
public class Tasking {
@Id
@GeneratedValue(strategy = GenerationType.AUTO)
private Long id;
private LocalDateTime operateTime;
private String username;
/*@OneToOne
private UserTask userTask;*/
@OneToOne
private SequenceFlow sequenceFlow;
@OneToOne
private ProcessInstance processInstance;
@ElementCollection(fetch = FetchType.EAGER)
List usernames;
}
2.7.延伸重要类-历史任务
package com.example.customprocessengine.model;
import lombok.Getter;
import lombok.Setter;
import javax.persistence.*;
import java.time.LocalDateTime;
@Entity
@Getter
@Setter
public class TaskHistory {
@Id
@GeneratedValue(strategy = GenerationType.AUTO)
private Long id;
private LocalDateTime operateTime;
private String username;
/*@OneToOne
private UserTask userTask;*/
@OneToOne
private SequenceFlow sequenceFlow;
@OneToOne
private ProcessInstance processInstance;
@OneToOne
private UserTask userTask;
}
代码一贴字数瞬间翻两番
3.对比流程图,当前设计表能否放下页面上的东西
tips:所谓工作流,简单点就是把规则定好,存在某个地方(可以是txt文件,xml文件,或者数据库)
event表
对应标红
task表
对应标红
gateway表
对应标红
SequenceFlow表.png
对应标红
结论-----》表设计基本能放下所有。
4.代码控制流程
流程服务类
package com.example.customprocessengine.service;
import java.util.Map;
public interface Customprocessengine {
Long startProcess(String processKey, Map variavle);
void completeTask(Long ProcessInstanceId,Map variavle);
}
目前提供两个方法:
1.开启流程
2.完成任务
后续接口还未完成。
5.单元测试
@Test
@Transactional
@Rollback(value = false)
public void test2() {
Map params = new HashMap<>();
List zzspr = new ArrayList<>();
zzspr.add("ysh员工");
params.put("fqr",zzspr);
System.out.println(customprocessengine.startProcess("1",params));
}
// 257 260 263
@Test
@Transactional
@Rollback(value = false)
public void tets(){
Map params = new HashMap<>();
List zzspr = new ArrayList<>();
zzspr.add("ysh组长1");
zzspr.add("ysh组长2");
params.put("zzspr",zzspr);
params.put("days", 3);
// params.put("jlspr", "ysh");
customprocessengine.completeTask(279l,params);
}
@Test
@Transactional
@Rollback(value = false)
public void tets3(){
Map params = new HashMap<>();
List zzspr = new ArrayList<>();
zzspr.add("ysh经理");
params.put("jlspr",zzspr);
params.put("dealpeople", "ysh组长1");
// params.put("days", 3);
// params.put("jlspr", "ysh");
// params.put("dealMan")
customprocessengine.completeTask(279l,params);
}
@Test
@Transactional
@Rollback(value = false)
public void tets41(){
Map params = new HashMap<>();
List zzspr = new ArrayList<>();
zzspr.add("ysh经理");
params.put("jlspr",zzspr);
params.put("dealpeople", "ysh组长2");
// params.put("days", 3);
// params.put("jlspr", "ysh");
// params.put("dealMan")
customprocessengine.completeTask(279l,params);
}
@Test
@Transactional
@Rollback(value = false)
public void tets4(){
Map params = new HashMap<>();
// List zzspr = new ArrayList<>();
// zzspr.add("yshjl");
// params.put("jlspr",zzspr);
// params.put("days", 3);
// params.put("jlspr", "ysh");
customprocessengine.completeTask(279l,params);
}
5.1.开启流程
历史任务表
进行中的任务表
5.2员工完成任务
进行中的任务表
历史任务表
这儿设置的多人会签,所以当员工提交任务后,会有两个组长收到任务。通过条件是两人都通过。
5.3组长1通过
进行中的任务表
历史任务表
组长1完成,进行中任务少了一条数据,历史中多了一条数据,且未跳转至下一流程,完成会签功能设计。
5.4组长2通过
进行中的任务表
历史任务表
两个组长审批通过后顺利跳转经理审批,满足预期设计。
5.5经理审批通过
进行中的任务表
历史任务表
经理审批通过后,进行中的任务清空,流程结束。满足设计预期要求。
6.难点
字符串转执行代码
package com.example.customprocessengine.util;
import org.apache.commons.jexl3.JexlContext;
import org.apache.commons.jexl3.JexlEngine;
import org.apache.commons.jexl3.JexlExpression;
import org.apache.commons.jexl3.MapContext;
import org.apache.commons.jexl3.internal.Engine;
import java.util.Map;
public class ReflectUtils {
private static JexlEngine jexlEngine = new Engine();
public static boolean executeExpression(String jexlExpression, Map map) {
JexlExpression expression = jexlEngine.createExpression(jexlExpression);
JexlContext context = new MapContext();
if (null != map && map.size() > 0) {
map.forEach(context::set);
}
return (boolean) expression.evaluate(context);
}
}
7.不足
- 流程服务类api未提供任务查询方法
- 错误提示待完成
- 任意流程跳转未实现
8.结语
作为自定义流程引擎初版,后续会继续完善,基本功能完成后将上传github。喜欢的朋友可以持续关注,评论区留下邮箱可私发未完成的代码。