作者：后端小肥肠

创作不易，未经允许严禁转载。

姊妹篇：独辟蹊径：我是如何用Java自创一套工作流引擎的（上）_java工作流引擎-CSDN博客

1. 前言

在上一篇博客中，我们详细介绍了如何利用Java语言从零开始打造一套工作流引擎的基础架构。通过设计核心表结构和实现基础代码框架，我们建立了一个坚实的理论基础。今天，我们迈入《独辟蹊径：我是如何用Java自创一套工作流引擎的（下）》，将深入探讨这一引擎在实际项目中的应用和效果。

2. 项目场景模拟

本章我们将以实际项目场景来模拟自研工作流引擎的使用，分别是申请数据资源的流程和请假申请流程。

2.1. 申请数据资源流程

2.1.1. 技术流程

假设申请数据的审批级数为2级。申请数据资源的流程图如下：

在上述流程图中，从普通用户，一级审批人员，二级审批人员视角呈现了申请数据资源的整体流程；

1. 用户提交审批数据表单，填入申请人信息（姓名、电话），申请理由和需要申请的数资源；

2. 一级审批人员收到用户提交的申请后进行审批，如果驳回则整个流程结束，如果通过则进入下一审批环节；

3. 一级审批通过后二级审批人员可进行审批，如果驳回则整个流程结束，如何通过则开放数据下载链接，用户可根据链接下载申请的数据。

2.2. 请假申请流程

2.2.1. 技术流程

请假流程如下：

在上述流程中，从用户和一级审批人员的角度呈现了整个请假流程：

1. 用户提交审批数据表单，填入申请人信息（姓名、电话）、申请理由、请假天数；

2. 一级审批人员收到用户提交的申请后进行审批，如果驳回则整个流程结束，同时通知用户流程未通过，如果通过则结束流程。

2.3. 技术实现

要在工作流中集成以上两套流程，需要基于一下几个步骤实现：

1. 设计流程定义，在business_approval_workflow新建数据审批流程和请假流程。

2. 设计流程细节，设计数据审批流程和请假流程的节点细节。

上图中，申请业务数据包含两个流程节点，第一个节点审批人为admin，第二个节点审批人为super；请假流程包含一个流程节点，审批人为admin。

3. 编写提交申请接口。

提交申请业务数据流程接口直接使用《独辟蹊径：我是如何用Java自创一套工作流引擎的（上）》中提交申请接口就行：

<code> public Boolean addRequest(RequestDTO requestDTO) {

Request request= BeanCopyUtils.copyBean(requestDTO,Request.class);

request.setStatus("1");//设置整个流程状态为正在审核

// 1. 插入数据到 request 表

baseMapper.insert(request);

// 2. 根据 workflow_id 查询业务流程的节点信息，找到 serial_number 为 1 的节点,即流程开始时的第一个节点

BusinessApprovalWorkflowDetail firstNode = workflowDetaiSlService.findFirstNodeByWorkflowId(request.getWorkflowId());

//获取下一级节点 填充下级节点审批人

BusinessApprovalWorkflowDetail nextNode=workflowDetaiSlService.getNextNodeByPreNode(firstNode);

if (firstNode != null) {

// 创建一个 approval_detail 记录示例，需要根据具体情况设置字段值

ApprovalDetail approvalDetail = new ApprovalDetail();

approvalDetail.setRequestId(request.getId()); // 假设设置关联的 request_id

approvalDetail.setApproverUsername(firstNode.getNodeUsername()); // 设置首次节点的审批人用户名

approvalDetail.setApprovalTime(new Date());

approvalDetail.setNextApproverUsername(nextNode.getNodeUsername());//设置下游节点的审批人用户名

approvalDetail.setStatus("1"); // 设置初始状态为待审批

approvalDetail.setWorkflowId(request.getWorkflowId());

approvalDetail.setNodeName(firstNode.getNodeName());

approvalDetail.setNextNodeName(nextNode.getNodeName());

// 插入数据到 approval_detail 表

approvalDetailService.save(approvalDetail);

} else {

// 如果未找到对应的节点，根据实际需求进行错误处理或日志记录

throw new RuntimeException("Unable to find the first node for workflow id: " + request.getWorkflowId());

}

return true;

}

提交请假流程接口，在编写提交请假流程接口前，需要先明确请假申请表的表结构：

CREATE TABLE "public"."leave_request" (

"id" varchar(32) COLLATE "pg_catalog"."default" NOT NULL,

"workflow_id" varchar(32) COLLATE "pg_catalog"."default" NOT NULL,

"purpose" varchar(900) COLLATE "pg_catalog"."default" NOT NULL,

"leave_days" int2 NOT NULL,

"applicant_name" varchar(50) COLLATE "pg_catalog"."default",

"applicat_username" varchar(50) COLLATE "pg_catalog"."default",

"applicant_phone" varchar(11) COLLATE "pg_catalog"."default",

"version" int4 DEFAULT 1,

"is_deleted" int4 DEFAULT 0,

"create_time" timestamp(6) NOT NULL,

"update_time" timestamp(6)

)

;

ALTER TABLE "public"."leave_request"

OWNER TO "postgres";

COMMENT ON COLUMN "public"."leave_request"."workflow_id" IS '业务流程id';

COMMENT ON COLUMN "public"."leave_request"."purpose" IS '请假理由';

COMMENT ON COLUMN "public"."leave_request"."leave_days" IS '请假天数';

COMMENT ON COLUMN "public"."leave_request"."applicant_name" IS '申请人姓名';

COMMENT ON COLUMN "public"."leave_request"."applicat_username" IS '申请人用户名';

COMMENT ON COLUMN "public"."leave_request"."applicant_phone" IS '申请人电话';

编写controller层：

@GetMapping("")

public Boolean addRequest(@Validated @RequestBody LeaveRequestDTO leaveRequestDTO){

return leaveRequestService.addRequest(leaveRequestDTO);

}

编写LeaveRequestDTO：

@Data

@AllArgsConstructor

@NoArgsConstructor

public class LeaveRequestDTO {

private String workflowId;

private String purpose;

private Integer leaveDays;

private String applicantName;

private String applicantPhone;

private String applicatUsername;

}

编写service层：

public Boolean addRequest(LeaveRequestDTO leaveRequestDTO) {

LeaveRequest leaveRequest= BeanCopyUtils.copyBean(leaveRequestDTO,LeaveRequest.class);

// 1. 插入数据到 request 表

baseMapper.insert(leaveRequest);

// 2. 根据 workflow_id 查询业务流程的节点信息，找到 serial_number 为 1 的节点,即流程开始时的第一个节点

BusinessApprovalWorkflowDetail firstNode = workflowDetaiSlService.findFirstNodeByWorkflowId(leaveRequest.getWorkflowId());

//获取下一级节点 填充下级节点审批人

BusinessApprovalWorkflowDetail nextNode=workflowDetaiSlService.getNextNodeByPreNode(firstNode);

if (firstNode != null) {

// 创建一个 approval_detail 记录示例，需要根据具体情况设置字段值

ApprovalDetail approvalDetail = new ApprovalDetail();

approvalDetail.setRequestId(leaveRequest.getId()); // 假设设置关联的 request_id

approvalDetail.setApproverUsername(firstNode.getNodeUsername()); // 设置首次节点的审批人用户名

approvalDetail.setApprovalTime(new Date());

approvalDetail.setNextApproverUsername(nextNode.getNodeUsername());//设置下游节点的审批人用户名

approvalDetail.setStatus("1"); // 设置初始状态为待审批

approvalDetail.setWorkflowId(leaveRequest.getWorkflowId());

approvalDetail.setNodeName(firstNode.getNodeName());

approvalDetail.setNextNodeName(nextNode.getNodeName());

// 插入数据到 approval_detail 表

approvalDetailService.save(approvalDetail);

} else {

// 如果未找到对应的节点，根据实际需求进行错误处理或日志记录

throw new RuntimeException("Unable to find the first node for workflow id: " + leaveRequest.getWorkflowId());

}

return true;

}

上述代码实现了提交请假申请的功能：首先将从DTO转换后的请假请求数据插入数据库，然后根据流程ID查询流程的第一个节点信息，设置首次节点的审批人并插入到审批详情表中，状态设置为待审批。 

4. 基于策略模式优化审批接口。

审批申请方法在上篇中如下：

@Transactional

@Override

public Boolean approvalApplication(ApprovalDTO approvalDTO) {

// 这里我写死了，实际获取应该走权限框架获取当前在线用户 username

String username = "xfc";

// 审批人姓名，从用户表中获取

String name="小肥肠";code>

//查询出当前任务节点

ApprovalDetail approvalDetail = baseMapper.selectById(approvalDTO.getId());

//获取当前审批的申请信息

Request request = requestMapper.selectById(approvalDetail.getRequestId());

if(request==null){

throw new RuntimeException("申请id有误");

}

// 审批通过

if (approvalDTO.getStatus().equals("2")) {

// 根据 workflow_id 和 node_name 联查 business_approval_workflow_detail 表，获取当前流程是否为最后节点即 is_final=1

BusinessApprovalWorkflowDetail currentWorkflowDetail = businessApprovalWorkflowDetailService.findByWorkflowIdAndNodeName(approvalDTO.getWorkflowId(), approvalDetail.getNodeName());

if (currentWorkflowDetail != null && currentWorkflowDetail.getIsFinal().equals("1")) {

// 如果是最后节点，则删除该条数据，填充 approval_history 表，根据 request 表修改 request 数据的 status 为 2

baseMapper.deleteById(approvalDetail.getId()); // 删除当前审批记录

// 更新 request 表中的状态为 2（通过）

request.setStatus("2");

requestMapper.updateById(request);

} else {

// 如果不是最后节点，则更新 business_approval_workflow_detail 为下一个节点审批信息

BusinessApprovalWorkflowDetail nextNode = businessApprovalWorkflowDetailService.getNextNodeByPreNode(currentWorkflowDetail);

// 获取下一级节点的更下一级

BusinessApprovalWorkflowDetail nextNextNode= businessApprovalWorkflowDetailService.getNextNodeByPreNode(nextNode);

// 更新当前 approval_detail 表中的审批人和下一个审批人信息

approvalDetail.setApproverUsername(nextNode.getNodeUsername());

approvalDetail.setNodeName(nextNextNode.getNodeName());

approvalDetail.setNextApproverUsername(nextNextNode!=null?nextNextNode.getNodeUsername():"");

approvalDetail.setNextNodeName(nextNextNode!=null?nextNextNode.getNodeName():"");

approvalDetail.setApprovalTime(new Date());

approvalDetail.setStatus("1"); // 设置为待审批状态

baseMapper.updateById(approvalDetail);

}

// 填充 approval_history 表

ApprovalHistory approvalHistory = new ApprovalHistory();

approvalHistory.setRequestId(request.getId());

approvalHistory.setApproverName(name); // 设置审批人姓名，或者从用户表中获取

approvalHistory.setApprovalTime(new Date());

approvalHistory.setStatus("2"); // 通过

approvalHistory.setRemark(approvalDTO.getRemark());

approvalHistory.setWorkflowId(approvalDTO.getWorkflowId());

approvalHistory.setApplicantPhone(request.getApplicantPhone());

approvalHistory.setPurpose(request.getPurpose());

approvalHistory.setApplicantName(request.getApplicantName());

approvalHistory.setApproverUsername(username); // 设置审批人用户名，或者从用户表中获取

approvalHistoryMapper.insert(approvalHistory); // 插入审批历史记录

} else if (approvalDTO.getStatus().equals("3")) {

// 审批驳回

baseMapper.deleteById(approvalDetail.getId()); // 删除当前审批记录

// 填充 approval_history 表

ApprovalHistory approvalHistory = new ApprovalHistory();

approvalHistory.setRequestId(request.getId());

approvalHistory.setApproverName(name); // 设置审批人姓名，或者从用户表中获取

approvalHistory.setApprovalTime(new Date());

approvalHistory.setStatus("3"); // 驳回

approvalHistory.setRemark(approvalDTO.getRemark());

approvalHistory.setWorkflowId(approvalDTO.getWorkflowId());

approvalHistory.setApplicantPhone(request.getApplicantPhone());

approvalHistory.setPurpose(request.getPurpose());

approvalHistory.setApplicantName(request.getApplicantName());

approvalHistory.setApproverUsername(username); // 设置审批人用户名，或者从用户表中获取

approvalHistoryMapper.insert(approvalHistory); // 插入审批历史记录

// 更新 request 表中的状态为 3（驳回）

request.setStatus("3");

requestMapper.updateById(request);

}

return true; // 或者根据实际需求返回其他业务逻辑

}

上述代码其实是针对申请数据资源流程的审批操作，那如果要申请别的流程该怎么做呢？常规操作应该是在上述代码中增加if-else判断操作，根据不通业务进行士审批操作，但是随着业务流程增加，就会新增许多if-else操作，代码会十分雍总，代码可读性较差，可以通过引入策略工厂来解决上述问题。步骤如下：

1.新增审批策略工厂

@Service

public class ApprovalFactory {

@Autowired

ApprovalDataRequestService approvalDataRequestService;

@Autowired

ApprovalLeaveRequestService approvalLeaveRequestService;

private static Map<String, Function<ApprovalDTO,Boolean>> approvalMap = null;

@PostConstruct

public void init(){

approvalMap=new HashMap<>();

approvalMap.put("2",approvalDTO->approvalDataRequestService.approvalApplication(approvalDTO));

approvalMap.put("1",approvalDTO ->approvalLeaveRequestService.approvalApplication(approvalDTO));

}

public Boolean approvalApplication(ApprovalDTO approvalDTO) {

return approvalMap.get(approvalDTO.getWorkflowId()).apply(approvalDTO);

}

}

上述代码为针对审批操作的策略工厂，在类初始化过程中（使用 @PostConstruct 注解的 init() 方法），通过静态的 approvalMap 对象将审批动作和对应的处理函数关联起来。具体来说：

当 workflowId 为 "2" 时，映射到 approvalDataRequestService 的 approvalApplication 方法处理数据请求的审批逻辑。当 workflowId 为 "1" 时，映射到 approvalLeaveRequestService 的 approvalApplication 方法处理请假请求的审批逻辑。

最后，approvalApplication(ApprovalDTO approvalDTO) 方法根据传入的 approvalDTO 中的 workflowId 从 approvalMap 中获取相应的处理函数，并执行该函数来完成审批操作，返回处理结果，controller层直接调用策略工厂即可：

@PostMapping("/approval")

public Boolean approvalApplication(@Validated @RequestBody ApprovalDTO approvalDTO) {

return approvalFactory.approvalApplication(approvalDTO);

}

2. 新增数据资源审批类

@Service

@Slf4j

public class ApprovalDataRequestService {

@Autowired

IBusinessApprovalWorkflowDetailService businessApprovalWorkflowDetailService;

@Autowired

RequestMapper requestMapper;

@Autowired

ApprovalHistoryMapper approvalHistoryMapper;

@Autowired

ApprovalDetailMapper approvalDetailMapper;

@Transactional

public Boolean approvalApplication(ApprovalDTO approvalDTO) {

// 这里我写死了，实际获取应该走权限框架获取当前在线用户 username

String username = "xfc";

// 审批人姓名，从用户表中获取

String name="小肥肠";code>

//查询出当前任务节点

ApprovalDetail approvalDetail = approvalDetailMapper.selectById(approvalDTO.getId());

//获取当前审批的申请信息

Request request = requestMapper.selectById(approvalDetail.getRequestId());

if(request==null){

throw new RuntimeException("申请id有误");

}

// 审批通过

if (approvalDTO.getStatus().equals("2")) {

// 根据 workflow_id 和 node_name 联查 business_approval_workflow_detail 表，获取当前流程是否为最后节点即 is_final=1

BusinessApprovalWorkflowDetail currentWorkflowDetail = businessApprovalWorkflowDetailService.findByWorkflowIdAndNodeName(approvalDTO.getWorkflowId(), approvalDetail.getNodeName());

if (currentWorkflowDetail != null && currentWorkflowDetail.getIsFinal().equals("1")) {

// 如果是最后节点，则删除该条数据，填充 approval_history 表，根据 request 表修改 request 数据的 status 为 2

approvalDetailMapper.deleteById(approvalDetail.getId()); // 删除当前审批记录

// 更新 request 表中的状态为 2（通过）

request.setStatus("2");

requestMapper.updateById(request);

} else {

// 如果不是最后节点，则更新 business_approval_workflow_detail 为下一个节点审批信息

BusinessApprovalWorkflowDetail nextNode = businessApprovalWorkflowDetailService.getNextNodeByPreNode(currentWorkflowDetail);

// 获取下一级节点的更下一级

BusinessApprovalWorkflowDetail nextNextNode= businessApprovalWorkflowDetailService.getNextNodeByPreNode(nextNode);

// 更新当前 approval_detail 表中的审批人和下一个审批人信息

approvalDetail.setApproverUsername(nextNode.getNodeUsername());

approvalDetail.setNodeName(nextNextNode.getNodeName());

approvalDetail.setNextApproverUsername(nextNextNode!=null?nextNextNode.getNodeUsername():"");

approvalDetail.setNextNodeName(nextNextNode!=null?nextNextNode.getNodeName():"");

approvalDetail.setApprovalTime(new Date());

approvalDetail.setStatus("1"); // 设置为待审批状态

approvalDetailMapper.updateById(approvalDetail);

}

// 填充 approval_history 表

ApprovalHistory approvalHistory = new ApprovalHistory();

approvalHistory.setRequestId(request.getId());

approvalHistory.setApproverName(name); // 设置审批人姓名，或者从用户表中获取

approvalHistory.setApprovalTime(new Date());

approvalHistory.setStatus("2"); // 通过

approvalHistory.setRemark(approvalDTO.getRemark());

approvalHistory.setWorkflowId(approvalDTO.getWorkflowId());

approvalHistory.setApplicantPhone(request.getApplicantPhone());

approvalHistory.setPurpose(request.getPurpose());

approvalHistory.setApplicantName(request.getApplicantName());

approvalHistory.setApproverUsername(username); // 设置审批人用户名，或者从用户表中获取

approvalHistoryMapper.insert(approvalHistory); // 插入审批历史记录

} else if (approvalDTO.getStatus().equals("3")) {

// 审批驳回

approvalDetailMapper.deleteById(approvalDetail.getId()); // 删除当前审批记录

// 填充 approval_history 表

ApprovalHistory approvalHistory = new ApprovalHistory();

approvalHistory.setRequestId(request.getId());

approvalHistory.setApproverName(name); // 设置审批人姓名，或者从用户表中获取

approvalHistory.setApprovalTime(new Date());

approvalHistory.setStatus("3"); // 驳回

approvalHistory.setRemark(approvalDTO.getRemark());

approvalHistory.setWorkflowId(approvalDTO.getWorkflowId());

approvalHistory.setApplicantPhone(request.getApplicantPhone());

approvalHistory.setPurpose(request.getPurpose());

approvalHistory.setApplicantName(request.getApplicantName());

approvalHistory.setApproverUsername(username); // 设置审批人用户名，或者从用户表中获取

approvalHistoryMapper.insert(approvalHistory); // 插入审批历史记录

// 更新 request 表中的状态为 3（驳回）

request.setStatus("3");

requestMapper.updateById(request);

}

return true; // 或者根据实际需求返回其他业务逻辑

}

}

3.新增请假审批类

@Service

public class ApprovalLeaveRequestService {

public Boolean approvalApplication(ApprovalDTO approvalDTO) {

/**

* 一样的逻辑，把对request表的操作改为leave_request

*/

return true;

}

}

3. 结语