mirror of
https://gitee.com/huangge1199_admin/vue-pro.git
synced 2024-11-22 15:21:53 +08:00
code review：【工作流】—— 加签的实现
This commit is contained in:
zhijiantianya@gmail.com
parent
45a2cd70f0
commit
6388950ab2
@ -1,5 +1,6 @@
|
||||
package cn.iocoder.yudao.framework.common.enums;
|
||||
|
||||
// TODO 这种简单的，暂时不用枚举哈，直接代码里写死就好啦；
|
||||
/**
|
||||
* 符号常量
|
||||
*/
|
||||
|
||||
@ -54,6 +54,7 @@ public interface ErrorCodeConstants {
|
||||
ErrorCode TASK_ADD_SIGN_TYPE_ERROR = new ErrorCode(1_009_005_010, "任务加签：当前任务已经{}，不能{}");
|
||||
ErrorCode TASK_ADD_SIGN_USER_REPEAT = new ErrorCode(1_009_005_011, "任务加签失败，加签人与现有审批人[{}]重复");
|
||||
ErrorCode TASK_SUB_SIGN_NO_PARENT = new ErrorCode(1_009_005_011, "任务减签失败，被减签的任务必须是通过加签生成的任务");
|
||||
|
||||
// ========== 流程任务分配规则 1-009-006-000 ==========
|
||||
ErrorCode TASK_ASSIGN_RULE_EXISTS = new ErrorCode(1_009_006_000, "流程({}) 的任务({}) 已经存在分配规则");
|
||||
ErrorCode TASK_ASSIGN_RULE_NOT_EXISTS = new ErrorCode(1_009_006_001, "流程任务分配规则不存在");
|
||||
|
||||
@ -14,6 +14,7 @@ public enum BpmCommentTypeEnum {
|
||||
REJECT(2, "不通过"),
|
||||
CANCEL(3, "已取消"),
|
||||
|
||||
// TODO @海：18 行可以去掉哈；这个是之前为了 status 隔离用的；
|
||||
// ========== 流程任务独有的状态 ==========
|
||||
|
||||
BACK(4, "退回"), // 退回
|
||||
@ -22,6 +23,7 @@ public enum BpmCommentTypeEnum {
|
||||
SUB_SIGN(7,"减签"),
|
||||
;
|
||||
|
||||
// TODO @海：字段叫 type 更合适噢
|
||||
/**
|
||||
* 结果
|
||||
*/
|
||||
|
||||
@ -26,20 +26,20 @@ public enum BpmProcessInstanceResultEnum {
|
||||
BACK(5, "驳回"), // 退回
|
||||
DELEGATE(6, "委派"),
|
||||
/**
|
||||
* 源任务已经审批完成，但是它使用了后加签，后加签的任务未完成，源任务就会是这个状态
|
||||
* 例如：A审批， A 后加签了 B ，并且审批通过了任务，但是 B 还未审批，则当前任务状态为 待后加签任务完成
|
||||
* 【加签】源任务已经审批完成，但是它使用了后加签，后加签的任务未完成，源任务就会是这个状态
|
||||
* 例如：A审批， A 后加签了 B，并且审批通过了任务，但是 B 还未审批，则当前任务状态为“待后加签任务完成”
|
||||
*/
|
||||
ADD_SIGN_AFTER(7, "待后加签任务完成"),
|
||||
ADD_SIGN_AFTER(7, "待后加签任务完成"), // TODO @海：这个定义，是不是 通过（待后加签任务完成），相当于是 APPROVE 的特殊状态
|
||||
/**
|
||||
* 源任务未审批，但是向前加签了，所以源任务状态变为 待前加签任务完成
|
||||
* 【加签】源任务未审批，但是向前加签了，所以源任务状态变为“待前加签任务完成”
|
||||
* 例如：A 审批， A 前加签了 B，B 还未审核
|
||||
*/
|
||||
ADD_SIGN_BEFORE(8, "待前加签任务完成"),
|
||||
ADD_SIGN_BEFORE(8, "待前加签任务完成"), // TODO @海：这个定义，是不是 处理中（待前加签任务审批），相当于是 PROCESS 的特殊状态
|
||||
/**
|
||||
* 后加签任务被创建时的初始状态
|
||||
* 【加签】后加签任务被创建时的初始状态
|
||||
* 因为需要源任务先完成，才能到后加签的人来审批，所以加了一个状态区分
|
||||
*/
|
||||
WAIT_BEFORE_TASK(9, "待前置任务完成");
|
||||
WAIT_BEFORE_TASK(9, "待前置任务完成"); // TODO @海：这个定义，是不是 处理中（待前置任务审批），相当于是 PROCESS 的特殊状态
|
||||
|
||||
/**
|
||||
* 结果
|
||||
@ -66,6 +66,7 @@ public enum BpmProcessInstanceResultEnum {
|
||||
ADD_SIGN_AFTER.getResult());
|
||||
}
|
||||
|
||||
// TODO @海：静态变量，需要放到成员变量前面；另外，如果是复数，可以加 S(ES) 或者 LIST
|
||||
/**
|
||||
* 能被减签的状态
|
||||
*/
|
||||
|
||||
@ -36,5 +36,6 @@ public enum BpmTaskAddSignTypeEnum {
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
@ -100,23 +100,29 @@ public class BpmTaskController {
|
||||
return success(true);
|
||||
}
|
||||
|
||||
// TODO @海：权限统一使用 bpm:task:update；是否可以加减签，可以交给后续的权限配置实现；
|
||||
@PutMapping("/add-sign")
|
||||
@Operation(summary = "加签", description = "before, after为前加签后加签")
|
||||
@Operation(summary = "加签", description = "before 前加签，after 后加签")
|
||||
@PreAuthorize("@ss.hasPermission('bpm:task:add-sign')")
|
||||
public CommonResult<Boolean> addSign(@Valid @RequestBody BpmTaskAddSignReqVO reqVO) {
|
||||
// TODO @海：userId 建议作为第一个参数；一般是，谁做了什么操作；另外，addSignTask，保持风格统一哈；
|
||||
taskService.addSign(reqVO,getLoginUserId());
|
||||
return success(true);
|
||||
}
|
||||
|
||||
// TODO @海：权限统一使用 bpm:task:update；是否可以加减签，可以交给后续的权限配置实现；
|
||||
@PutMapping("/sub-sign")
|
||||
@Operation(summary = "减签", description = "")
|
||||
@Operation(summary = "减签")
|
||||
@PreAuthorize("@ss.hasPermission('bpm:task:sub-sign')")
|
||||
// TODO @海： @RequestBody BpmTaskSubSignReqVO 应该是一个空格；然后参数名可以简写成 reqVO；
|
||||
public CommonResult<Boolean> subSign(@Valid @RequestBody BpmTaskSubSignReqVO bpmTaskSubSignReqVO) {
|
||||
taskService.subSign(bpmTaskSubSignReqVO,getLoginUserId());
|
||||
return success(true);
|
||||
}
|
||||
|
||||
// TODO @海：是不是 url 和方法名，叫 get-child-task-list，更抽象和复用一些？
|
||||
@GetMapping("/get-sub-sign")
|
||||
@Operation(summary = "获取能被减签的任务", description = "")
|
||||
@Operation(summary = "获取能被减签的任务")
|
||||
@PreAuthorize("@ss.hasPermission('bpm:task:sub-sign')")
|
||||
public CommonResult<List<BpmTaskSubSignRespVO>> getChildrenTaskList(@RequestParam("taskId") String taskId) {
|
||||
return success(taskService.getChildrenTaskList(taskId));
|
||||
|
||||
@ -23,7 +23,9 @@ public class BpmTaskAddSignReqVO {
|
||||
@NotEmpty(message = "加签原因不能为空")
|
||||
private String reason;
|
||||
|
||||
// TODO @海：重要参数，可以放到最前面哈；
|
||||
@Schema(description = "需要加签的任务 ID")
|
||||
@NotEmpty(message = "任务编号不能为空")
|
||||
private String id;
|
||||
|
||||
}
|
||||
@ -147,6 +147,7 @@ public interface BpmTaskConvert {
|
||||
.setDefinitionKey(element.getId()));
|
||||
}
|
||||
|
||||
// TODO @海：可以使用 mapstruct 映射么？
|
||||
default TaskEntityImpl convert(TaskEntityImpl task,TaskEntityImpl parentTask){
|
||||
task.setCategory(parentTask.getCategory());
|
||||
task.setDescription(parentTask.getDescription());
|
||||
|
||||
@ -32,7 +32,8 @@ public interface BpmTaskExtMapper extends BaseMapperX<BpmTaskExtDO> {
|
||||
return selectOne(BpmTaskExtDO::getTaskId, taskId);
|
||||
}
|
||||
|
||||
default void updateBatchByTaskIdList(List<String> taskIdList, BpmTaskExtDO entity){
|
||||
update(entity,new LambdaQueryWrapper<BpmTaskExtDO>().in(BpmTaskExtDO::getTaskId, taskIdList));
|
||||
default void updateBatchByTaskIdList(List<String> taskIdList, BpmTaskExtDO updateObj) {
|
||||
update(updateObj, new LambdaQueryWrapper<BpmTaskExtDO>().in(BpmTaskExtDO::getTaskId, taskIdList));
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
@ -65,8 +65,8 @@ public interface BpmTaskService {
|
||||
|
||||
|
||||
/**
|
||||
* 通过任务 ID 集合，获取任务扩展表信息集合
|
||||
* @param taskIdList 任务 ID
|
||||
* 通过任务 ID 集合，获取任务扩展表信息集合 // TODO @海洋：方法注释，和下面的参数，需要空一行
|
||||
* @param taskIdList 任务 ID 集合
|
||||
* @return 任务列表
|
||||
*/
|
||||
List<BpmTaskExtDO> getTaskListByTaskIdList(List<String> taskIdList);
|
||||
@ -158,13 +158,15 @@ public interface BpmTaskService {
|
||||
|
||||
/**
|
||||
* 任务加签
|
||||
*
|
||||
* @param reqVO 被加签的用户和任务 ID，加签类型
|
||||
* @param userId 当前用户 ID
|
||||
*/
|
||||
void addSign(BpmTaskAddSignReqVO reqVO, Long userId);
|
||||
|
||||
/**
|
||||
* 减签
|
||||
* 任务减签名
|
||||
*
|
||||
* @param bpmTaskSubSignReqVO 被减签的任务 ID，理由
|
||||
* @param loginUserId 当前用户ID
|
||||
*/
|
||||
@ -172,8 +174,10 @@ public interface BpmTaskService {
|
||||
|
||||
/**
|
||||
* 获取指定任务的子任务和审批人信息
|
||||
*
|
||||
* @param taskId 指定任务ID
|
||||
* @return 子任务列表
|
||||
*/
|
||||
List<BpmTaskSubSignRespVO> getChildrenTaskList(String taskId);
|
||||
|
||||
}
|
||||
|
||||
@ -218,12 +218,15 @@ public class BpmTaskServiceImpl implements BpmTaskService {
|
||||
approveDelegateTask(reqVO, task);
|
||||
return;
|
||||
}
|
||||
|
||||
// 情况二：后加签的任务
|
||||
if (BpmTaskAddSignTypeEnum.AFTER.getType().equals(task.getScopeType())) {
|
||||
// 后加签处理
|
||||
// TODO @海洋：这个是不是 approveAfterSignTask
|
||||
handleAfterSignTask(task, reqVO);
|
||||
return;
|
||||
}
|
||||
|
||||
// 情况三：自己审批的任务，调用 complete 去完成任务
|
||||
// 完成任务，审批通过
|
||||
taskService.complete(task.getId(), instance.getProcessVariables());
|
||||
@ -232,19 +235,23 @@ public class BpmTaskServiceImpl implements BpmTaskService {
|
||||
new BpmTaskExtDO().setTaskId(task.getId()).setResult(BpmProcessInstanceResultEnum.APPROVE.getResult())
|
||||
.setReason(reqVO.getReason()));
|
||||
// 处理加签任务
|
||||
this.handleParentTask(task);
|
||||
handleParentTask(task);
|
||||
}
|
||||
|
||||
/**
|
||||
* 当前任务存在后加签任务，则不能马上完成，需要一个中间状态，并激活剩余所有子任务
|
||||
* 审批通过存在“后加签”的任务。
|
||||
*
|
||||
* 注意：该任务不能马上完成，需要一个中间状态（ADD_SIGN_AFTER），并激活剩余所有子任务（PROCESS）为可审批处理
|
||||
*
|
||||
* @param task 当前任务
|
||||
* @param reqVO 前端请求参数
|
||||
*/
|
||||
private void handleAfterSignTask(Task task,BpmTaskApproveReqVO reqVO){
|
||||
//1.有向后加签，则该任务状态临时设置为 等待后加签任务完成 状态
|
||||
// 1. 有向后加签，则该任务状态临时设置为 ADD_SIGN_AFTER 状态
|
||||
taskExtMapper.updateByTaskId(
|
||||
new BpmTaskExtDO().setTaskId(task.getId()).setResult(BpmProcessInstanceResultEnum.ADD_SIGN_AFTER.getResult())
|
||||
.setReason(reqVO.getReason()).setEndTime(LocalDateTime.now()));
|
||||
|
||||
// 2. 激活子任务
|
||||
List<String> childrenTaskIdList = getChildrenTaskIdList(task.getId());
|
||||
for (String childrenTaskId : childrenTaskIdList) {
|
||||
@ -255,7 +262,6 @@ public class BpmTaskServiceImpl implements BpmTaskService {
|
||||
new BpmTaskExtDO().setResult(BpmProcessInstanceResultEnum.PROCESS.getResult()));
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* 处理当前任务的父任务
|
||||
*
|
||||
@ -263,14 +269,17 @@ public class BpmTaskServiceImpl implements BpmTaskService {
|
||||
*/
|
||||
private void handleParentTask(Task task) {
|
||||
String parentTaskId = task.getParentTaskId();
|
||||
// TODO @ 海：if return 原则
|
||||
if (StrUtil.isNotBlank(parentTaskId)) {
|
||||
// 1. 判断当前任务的父任务是否还有子任务
|
||||
long subTaskCount = getSubTaskCount(parentTaskId);
|
||||
// TODO @ 海：if >= 0 return；这样括号又可以少一层；
|
||||
if (subTaskCount == 0) {
|
||||
// 2. 获取父任务
|
||||
Task parentTask = validateTaskExist(parentTaskId);
|
||||
|
||||
// 3. 情况一：处理向前加签
|
||||
String scopeType = parentTask.getScopeType();
|
||||
//3. 处理向前加签
|
||||
if (BpmTaskAddSignTypeEnum.BEFORE.getType().equals(scopeType)) {
|
||||
// 3.1 如果是向前加签的任务，则调用 resolveTask 指派父任务，将 owner 重新赋值给父任务的 assignee
|
||||
taskService.resolveTask(parentTaskId);
|
||||
@ -278,28 +287,31 @@ public class BpmTaskServiceImpl implements BpmTaskService {
|
||||
taskExtMapper.updateByTaskId(
|
||||
new BpmTaskExtDO().setTaskId(parentTask.getId()).setResult(BpmProcessInstanceResultEnum.PROCESS.getResult()));
|
||||
} else if (BpmTaskAddSignTypeEnum.AFTER.getType().equals(scopeType)) {
|
||||
//4. 处理向后加签
|
||||
// 3. 情况二：处理向后加签
|
||||
handleAfterSign(parentTask);
|
||||
}
|
||||
//5. 子任务已处理完成，清空 scopeType 字段，修改 parentTask 信息，方便后续可以继续向前后向后加签
|
||||
|
||||
// 4. 子任务已处理完成，清空 scopeType 字段，修改 parentTask 信息，方便后续可以继续向前后向后加签
|
||||
// 再查询一次的原因是避免报错：Task was updated by another transaction concurrently
|
||||
// 因为前面处理后可能会导致 parentTask rev 字段被修改，需要重新获取最新的
|
||||
parentTask = getTask(parentTaskId);
|
||||
// TODO @ 海：if return 原则；
|
||||
if (parentTask != null) {
|
||||
// 为空的情况是：已经通过 handleAfterSign 方法将任务完成了，所以 ru_task 表会查不到数据
|
||||
clearTaskScopeTypeAndSave(parentTask);
|
||||
}
|
||||
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// TODO @海：这个方法的 4.1 从 1 开始计数哈；另外；看看能不能用 if return 进一步简化代码的层级；
|
||||
/**
|
||||
* 处理后加签任务
|
||||
*
|
||||
* @param parentTask 当前审批任务的父任务
|
||||
*/
|
||||
private void handleAfterSign(Task parentTask) {
|
||||
// TODO @海：这个方法在注释下。感觉整体是，先完成自己；然后递归处理父节点；但是完成机子被放到了 5.1，就感觉上有点割裂；
|
||||
String parentTaskId = parentTask.getId();
|
||||
//4.1 更新 parentTask 的任务拓展表为通过
|
||||
BpmTaskExtDO currentTaskExt = taskExtMapper.selectByTaskId(parentTask.getId());
|
||||
@ -311,14 +323,16 @@ public class BpmTaskServiceImpl implements BpmTaskService {
|
||||
currentTaskUpdateEntity.setEndTime(LocalDateTime.now());
|
||||
}
|
||||
taskExtMapper.updateByTaskId(currentTaskUpdateEntity);
|
||||
|
||||
// 5. 继续往上处理，父任务继续往上查询
|
||||
// 5.1 先完成自己
|
||||
taskService.complete(parentTaskId);
|
||||
if (StrUtil.isNotEmpty(parentTask.getParentTaskId())) {
|
||||
// 5.2 如果有父级，递归查询上级任务是否都已经完成
|
||||
// TODO @海：这块待讨论，脑子略乱；感觉 handleAfterSign 的后半段，和 handleParentTask 有点重叠？？？
|
||||
if (StrUtil.isNotEmpty(parentTask.getParentTaskId())) {
|
||||
// 判断整条链路的任务是否完成
|
||||
// 例如从 A 任务加签了一个 B 任务，B 任务又加签了一个 C 任务，C 任务加签了 D 任务
|
||||
//此时，D 任务完成，要一直往上找到祖先任务 A ，调用 complete 方法完成 A 任务
|
||||
// 此时，D 任务完成，要一直往上找到祖先任务 A调用 complete 方法完成 A 任务
|
||||
boolean allChildrenTaskFinish = true;
|
||||
while (StrUtil.isNotBlank(parentTask.getParentTaskId())) {
|
||||
parentTask = validateTaskExist(parentTask.getParentTaskId());
|
||||
@ -369,15 +383,16 @@ public class BpmTaskServiceImpl implements BpmTaskService {
|
||||
taskService.saveTask(task);
|
||||
}
|
||||
|
||||
// TODO @海：Sub 还有 Child 感觉整体用词不是很统一；是不是要统一下；然后 Sub 还可以指的减签；看看是不是名词确实得一致哈；
|
||||
/**
|
||||
* 获取子任务个数
|
||||
*
|
||||
* @param parentTaskId 父类ID
|
||||
* @param parentTaskId 父任务 ID
|
||||
* @return 剩余子任务个数
|
||||
*/
|
||||
private Long getSubTaskCount(String parentTaskId) {
|
||||
String tableName = managementService.getTableName(TaskEntity.class);
|
||||
String sql = "select count(1) from " + tableName + " where PARENT_TASK_ID_=#{parentTaskId}";
|
||||
String sql = "SELECT COUNT(1) from " + tableName + " WHERE PARENT_TASK_ID_=#{parentTaskId}";
|
||||
return taskService.createNativeTaskQuery().sql(sql).parameter("parentTaskId", parentTaskId).count();
|
||||
}
|
||||
|
||||
@ -454,8 +469,8 @@ public class BpmTaskServiceImpl implements BpmTaskService {
|
||||
|
||||
@Override
|
||||
public void createTaskExt(Task task) {
|
||||
BpmTaskExtDO taskExtDO =
|
||||
BpmTaskConvert.INSTANCE.convert2TaskExt(task).setResult(BpmProcessInstanceResultEnum.PROCESS.getResult());
|
||||
BpmTaskExtDO taskExtDO = BpmTaskConvert.INSTANCE.convert2TaskExt(task)
|
||||
.setResult(BpmProcessInstanceResultEnum.PROCESS.getResult());
|
||||
// 向后加签生成的任务，状态不能为进行中，需要等前面父任务完成
|
||||
if (BpmTaskAddSignTypeEnum.AFTER_CHILDREN_TASK.getType().equals(task.getScopeType())) {
|
||||
taskExtDO.setResult(BpmProcessInstanceResultEnum.WAIT_BEFORE_TASK.getResult());
|
||||
@ -691,19 +706,23 @@ public class BpmTaskServiceImpl implements BpmTaskService {
|
||||
@Override
|
||||
@Transactional(rollbackFor = Exception.class)
|
||||
public void addSign(BpmTaskAddSignReqVO reqVO, Long userId) {
|
||||
// TODO @海：// 后面要有个空格；中英文之间，也要有空格；例如说：// 1. 获取和校验任务
|
||||
//1.获取和校验任务
|
||||
TaskEntityImpl taskEntity = validateAddSign(userId, reqVO);
|
||||
// TODO @海：每个变量，以及相关逻辑，一定要和自己的逻辑块呆在一起。例如说这里的 currentUser 获取，应该在 4. 那块
|
||||
AdminUserRespDTO currentUser = adminUserApi.getUser(userId);
|
||||
List<AdminUserRespDTO> userList = adminUserApi.getUserList(reqVO.getUserIdList());
|
||||
if (CollUtil.isEmpty(userList)) {
|
||||
throw exception(TASK_ADD_SIGN_USER_NOT_EXIST);
|
||||
}
|
||||
// TODO @海：大的逻辑块之间，最好有一个空格。这样的目的，是避免逻辑堆砌在一起，方便流量；
|
||||
// 2.处理当前任务
|
||||
//2.1 开启计数功能
|
||||
// 2.1 开启计数功能 // TODO @海：这个目的可以写下；
|
||||
taskEntity.setCountEnabled(true);
|
||||
// TODO @海：可以直接 if，不搞一个变量哈
|
||||
boolean addSignToBefore = reqVO.getType().equals(BpmTaskAddSignTypeEnum.BEFORE.getType());
|
||||
if (addSignToBefore) {
|
||||
//2.2 向前加签，设置 owner ，置空 assign ,等子任务都完成后，再调用 resolveTask 重新将 owner 设置为 assign
|
||||
// 2.2 向前加签，设置 owner，置空 assign。等子任务都完成后，再调用 resolveTask 重新将 owner 设置为 assign
|
||||
// 原因是：不能和向前加签的子任务一起审批，需要等前面的子任务都完成才能审批
|
||||
taskEntity.setOwner(taskEntity.getAssignee());
|
||||
taskEntity.setAssignee(null);
|
||||
@ -718,10 +737,12 @@ public class BpmTaskServiceImpl implements BpmTaskService {
|
||||
// 2.5 保存当前任务修改后的值
|
||||
taskService.saveTask(taskEntity);
|
||||
|
||||
//3. 处理加签任务
|
||||
this.createSignSubTasks(convertList(reqVO.getUserIdList(), String::valueOf), taskEntity);
|
||||
//4. 记录加签 comment，拼接结果为： [当前用户]向前加签/向后加签给了[多个用户],理由为：reason
|
||||
String comment = StrUtil.format("[{}]{}给了[{}],理由为：{}", currentUser.getNickname(), BpmTaskAddSignTypeEnum.formatDesc(reqVO.getType()),
|
||||
// 3. 创建加签任务
|
||||
createSignSubTasks(convertList(reqVO.getUserIdList(), String::valueOf), taskEntity);
|
||||
|
||||
// 4. 记录加签 comment，拼接结果为： [当前用户]向前加签/向后加签给了[多个用户]，理由为：reason
|
||||
// TODO @海：BpmCommentTypeEnum 可以加一个 comment 字段，作为评论模版，统一管理；
|
||||
String comment = StrUtil.format("[{}]{}给了[{}]，理由为：{}", currentUser.getNickname(), BpmTaskAddSignTypeEnum.formatDesc(reqVO.getType()),
|
||||
String.join(SymbolConstant.D, convertList(userList, AdminUserRespDTO::getNickname)), reqVO.getReason());
|
||||
taskService.addComment(reqVO.getId(), taskEntity.getProcessInstanceId(),
|
||||
BpmCommentTypeEnum.ADD_SIGN.getResult().toString(), comment);
|
||||
@ -729,7 +750,10 @@ public class BpmTaskServiceImpl implements BpmTaskService {
|
||||
|
||||
|
||||
/**
|
||||
* 校验任务存在和 存在 向前加签 的任务，则不能 向后加签，存在 向后加签 则不能 向前加签
|
||||
* 校验任务的加签是否一致
|
||||
*
|
||||
* 1. 如果存在“向前加签”的任务，则不能“向后加签”
|
||||
* 2. 如果存在“向后加签”的任务，则不能“向前加签”
|
||||
*
|
||||
* @param userId 当前用户 ID
|
||||
* @param reqVO 请求参数，包含任务 ID 和加签类型
|
||||
@ -740,6 +764,8 @@ public class BpmTaskServiceImpl implements BpmTaskService {
|
||||
// 向前加签和向后加签不能同时存在
|
||||
if (StrUtil.isNotBlank(taskEntity.getScopeType())
|
||||
&& !BpmTaskAddSignTypeEnum.AFTER_CHILDREN_TASK.getDesc().equals(taskEntity.getScopeType())) {
|
||||
// TODO @海：下面这个判断，是不是可以写上面这个判断后面？
|
||||
// TODO @海：一个小技巧，如果写不等于的时候，一般可以用 ObjectUtil.notEquals，这样少一层取反，理解起来简单点；
|
||||
if (!taskEntity.getScopeType().equals(reqVO.getType())) {
|
||||
throw exception(TASK_ADD_SIGN_TYPE_ERROR,
|
||||
BpmTaskAddSignTypeEnum.formatDesc(taskEntity.getScopeType()), BpmTaskAddSignTypeEnum.formatDesc(reqVO.getType()));
|
||||
@ -748,7 +774,9 @@ public class BpmTaskServiceImpl implements BpmTaskService {
|
||||
// 同一个 key 的任务，审批人不重复
|
||||
List<Task> taskList = taskService.createTaskQuery().processInstanceId(taskEntity.getProcessInstanceId())
|
||||
.taskDefinitionKey(taskEntity.getTaskDefinitionKey()).list();
|
||||
// TODO @海：这里是不是 Task::getAssignee 解析成 List<Long> 下面会更简洁一点？
|
||||
List<String> currentAssigneeList = convertList(taskList, Task::getAssignee);
|
||||
// TODO @海：frontAssigneeList 改成 addAssigneeList，新增的；避免和 front 前端这样界面耦合的名词哈；
|
||||
List<String> frontAssigneeList = convertList(reqVO.getUserIdList(), String::valueOf);
|
||||
currentAssigneeList.retainAll(frontAssigneeList);
|
||||
if (CollUtil.isNotEmpty(currentAssigneeList)) {
|
||||
@ -765,16 +793,18 @@ public class BpmTaskServiceImpl implements BpmTaskService {
|
||||
* @param taskEntity 被加签的任务
|
||||
*/
|
||||
private void createSignSubTasks(List<String> addSingUserIdList, TaskEntityImpl taskEntity) {
|
||||
// TODO @海：可以 if return；这样括号层级少一点；下面的 if (StrUtil.isNotBlank(addSignId)) { 也是类似；
|
||||
if (CollUtil.isNotEmpty(addSingUserIdList)) {
|
||||
// 创建加签人的新任务,全部基于 taskEntity 为父任务来创建
|
||||
// 创建加签人的新任务，全部基于 taskEntity 为父任务来创建
|
||||
addSingUserIdList.forEach(addSignId -> {
|
||||
if (StrUtil.isNotBlank(addSignId)) {
|
||||
this.createSubTask(taskEntity, addSignId);
|
||||
createSubTask(taskEntity, addSignId);
|
||||
}
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
// TODO @海：这个是不是命名上，要和 createSignSubTasks 保持一致？
|
||||
/**
|
||||
* 创建子任务
|
||||
*
|
||||
@ -787,14 +817,15 @@ public class BpmTaskServiceImpl implements BpmTaskService {
|
||||
TaskEntityImpl task = (TaskEntityImpl) taskService.newTask(IdUtil.fastSimpleUUID());
|
||||
task = BpmTaskConvert.INSTANCE.convert(task,parentTask);
|
||||
if (BpmTaskAddSignTypeEnum.BEFORE.getType().equals(parentTask.getScopeType())) {
|
||||
// 2. 前加签，才设置审批人，否则设置 owner
|
||||
// 2.1 前加签，才设置审批人，否则设置 owner
|
||||
task.setAssignee(assignee);
|
||||
} else {
|
||||
//2.2 设置 owner 不设置 assignee 是因为不能同时审批，需要等父任务完成
|
||||
// 2.2.1 设置 owner 不设置 assignee 是因为不能同时审批，需要等父任务完成
|
||||
task.setOwner(assignee);
|
||||
//2.3 设置向后加签任务的 scopeType 为 afterChildrenTask，用于设置任务扩展表的状态
|
||||
// 2.2.2 设置向后加签任务的 scopeType 为 afterChildrenTask，用于设置任务扩展表的状态
|
||||
task.setScopeType(BpmTaskAddSignTypeEnum.AFTER_CHILDREN_TASK.getType());
|
||||
}
|
||||
// 2. 保存子任务
|
||||
taskService.saveTask(task);
|
||||
}
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user