org.dromara.warm.flow.core.service.impl

Class TaskServiceImpl

java.lang.Object

org.dromara.warm.flow.core.orm.service.impl.WarmServiceImpl<FlowTaskDao<Task>,Task>

org.dromara.warm.flow.core.service.impl.TaskServiceImpl

All Implemented Interfaces:

IWarmService<Task>, TaskService

public class TaskServiceImpl
extends WarmServiceImpl<FlowTaskDao<Task>,Task>
implements TaskService

待办任务Service业务层处理

Since:

2023-03-29

Author:

warm

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	TaskServiceImpl.R

Field Summary

Fields inherited from class org.dromara.warm.flow.core.orm.service.impl.WarmServiceImpl

warmDao

Constructor Summary

Constructors

Constructor and Description
TaskServiceImpl()

Method Summary

Modifier and Type	Method and Description
boolean	addSignature(Long taskId, FlowParams flowParams) 加签，增加办理人
boolean	addSignature(Long taskId, String curUser, List<String> permissionFlag, List<String> addHandlers, String message) 加签，增加办理人
Task	addTask(Node node, Instance instance, Definition definition, FlowParams flowParams) 设置流程待办任务对象
private List<Task>	buildAddTasks(FlowParams flowParams, Task task, Instance instance, List<Node> nextNodes, Node nextNode, Definition definition) 构建增待办任务
private void	checkAuth(Node NowNode, Task task, FlowParams flowParams) 判断当前处理人是否有权限处理
private void	convertHisTask(List<Task> taskList, FlowParams flowParams, String flowStatus) 待办任务转历史任务。
private boolean	cooperate(Node nowNode, Task task, FlowParams flowParams) 会签，票签，协作处理，返回true；或签或者会签、票签结束返回false
boolean	deleteByInsIds(List<Long> instanceIds) 根据instanceIds删除
boolean	depute(Long taskId, FlowParams flowParams) 委派, 默认删除当然办理用户权限，委派后，当前办理不可办理
boolean	depute(Long taskId, String curUser, List<String> permissionFlag, List<String> addHandlers, String message) 委派, 默认删除当然办理用户权限，委派后，当前办理不可办理
private boolean	gateWayParallelIsFinish(Task task, Instance instance, String nextNodeCode) 判断并行网关节点前置任务是否都完成 多条线路汇聚到并行网关，必须所有任务都完成，才能继续。 根据并行网关节点，查询前面的节点是否都完成， 判断规则，获取网关所有前置节点，并且查询是否有历史任务记录，前前置节点完成时间是否早于前置节点
private TaskServiceImpl.R	getAndCheck(Long taskId)
private TaskServiceImpl.R	getAndCheck(Task task)
Task	getNextTask(List<Task> tasks) 并行网关，取结束节点类型，否则随便取id最大的
private boolean	handleDepute(Task task, FlowParams flowParams)
private void	handUndoneTask(Instance instance, FlowParams flowParams) 处理未完成的任务，当流程完成，还存在待办任务未完成，转历史任务，状态完成。
private boolean	judgeActivityStatus(Definition definition, Instance instance)
private boolean	judgeReject(String nextNodeCode, List<Skip> lastSkips, Map<String,List<Skip>> skipMap) 判断是否属于退回指向节点的后置未完成的任务
private void	oneVoteVeto(Task task, FlowParams flowParams, String nextNodeCode) 一票否决（谨慎使用），如果退回，退回指向节点后还存在其他正在执行的待办任务，转历史任务，状态都为退回,重走流程。
boolean	reductionSignature(Long taskId, FlowParams flowParams) 减签，减少办理人
boolean	reductionSignature(Long taskId, String curUser, List<String> permissionFlag, List<String> reductionHandlers, String message) 减签，减少办理人
Instance	retrieve(Long instanceId, FlowParams flowParams) 取回
TaskService	setDao(FlowTaskDao<Task> warmDao)
String	setFlowStatus(Integer nodeType, String skipType) 设置流程实例和代码任务流程状态
private void	setInsFinishInfo(Instance instance, List<Task> addTasks, FlowParams flowParams)
Instance	skip(FlowParams flowParams, Task task) 流程跳转
Instance	skip(Long taskId, FlowParams flowParams) 根据任务id，流程跳转
Instance	termination(Long taskId, FlowParams flowParams) 终止流程，提前结束流程，将所有待办任务转历史
Instance	termination(Task task, FlowParams flowParams) 终止流程，提前结束流程，将所有待办任务转历史
boolean	transfer(Long taskId, FlowParams flowParams) 转办, 默认删除当然办理用户权限，转办后，当前办理不可办理
boolean	transfer(Long taskId, String curUser, List<String> permissionFlag, List<String> addHandlers, String message) 转办, 默认删除当然办理用户权限，转办后，当前办理不可办理
private void	updateFlowInfo(Task task, Instance instance, List<Task> addTasks, FlowParams flowParams, List<Node> nextNodes) 更新流程信息
boolean	updateHandler(Long taskId, FlowParams flowParams) 修改办理人
boolean	updateHandler(ModifyHandler modifyHandler) 修改办理人

Methods inherited from class org.dromara.warm.flow.core.orm.service.impl.WarmServiceImpl

exists, getById, getByIds, getDao, getOne, insertFill, list, list, orderBy, orderByAsc, orderByCreateTime, orderByDesc, orderById, orderByUpdateTime, page, remove, removeById, removeByIds, save, saveBatch, saveBatch, selectCount, updateBatch, updateById, updateFill

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.dromara.warm.flow.core.orm.service.IWarmService

exists, getById, getByIds, getDao, getOne, list, list, orderBy, orderByAsc, orderByCreateTime, orderByDesc, orderById, orderByUpdateTime, page, remove, removeById, removeByIds, save, saveBatch, saveBatch, selectCount, updateBatch, updateById

Constructor Detail

TaskServiceImpl

public TaskServiceImpl()

Method Detail

setDao

public TaskService setDao(FlowTaskDao<Task> warmDao)

Specified by:

setDao in class WarmServiceImpl<FlowTaskDao<Task>,Task>

skip

public Instance skip(Long taskId,
                     FlowParams flowParams)

Description copied from interface: TaskService

根据任务id，流程跳转

Specified by:

skip in interface TaskService

skip

public Instance skip(FlowParams flowParams,
                     Task task)

Description copied from interface: TaskService

流程跳转

Specified by:

skip in interface TaskService

termination

public Instance termination(Long taskId,
                            FlowParams flowParams)

Description copied from interface: TaskService

终止流程，提前结束流程，将所有待办任务转历史

Specified by:

termination in interface TaskService

termination

public Instance termination(Task task,
                            FlowParams flowParams)

Description copied from interface: TaskService

终止流程，提前结束流程，将所有待办任务转历史

Specified by:

termination in interface TaskService

deleteByInsIds

public boolean deleteByInsIds(List<Long> instanceIds)

Description copied from interface: TaskService

根据instanceIds删除

Specified by:

deleteByInsIds in interface TaskService

Parameters:

instanceIds - 流程实例id集合

Returns:

boolean

transfer

public boolean transfer(Long taskId,
                        FlowParams flowParams)

Description copied from interface: TaskService

转办, 默认删除当然办理用户权限，转办后，当前办理不可办理

Specified by:

transfer in interface TaskService

Parameters:

taskId - 修改的任务id [必传]

transfer

public boolean transfer(Long taskId,
                        String curUser,
                        List<String> permissionFlag,
                        List<String> addHandlers,
                        String message)

Description copied from interface: TaskService

转办, 默认删除当然办理用户权限，转办后，当前办理不可办理

Specified by:

transfer in interface TaskService

Parameters:

taskId - 修改的任务id

curUser - 当前办理人唯一标识

permissionFlag - 用户权限标识集合

addHandlers - 增加办理人：加签，转办，委托

message - 审批意见

depute

public boolean depute(Long taskId,
                      FlowParams flowParams)

Description copied from interface: TaskService

委派, 默认删除当然办理用户权限，委派后，当前办理不可办理

Specified by:

depute in interface TaskService

Parameters:

taskId - 修改的任务id [必传]

depute

public boolean depute(Long taskId,
                      String curUser,
                      List<String> permissionFlag,
                      List<String> addHandlers,
                      String message)

Description copied from interface: TaskService

委派, 默认删除当然办理用户权限，委派后，当前办理不可办理

Specified by:

depute in interface TaskService

Parameters:

taskId - 修改的任务id

curUser - 当前办理人唯一标识

permissionFlag - 用户权限标识集合

addHandlers - 增加办理人：加签，转办，委托

message - 审批意见

addSignature

public boolean addSignature(Long taskId,
                            FlowParams flowParams)

Description copied from interface: TaskService

加签，增加办理人

Specified by:

addSignature in interface TaskService

Parameters:

taskId - 修改的任务id [必传]

addSignature

public boolean addSignature(Long taskId,
                            String curUser,
                            List<String> permissionFlag,
                            List<String> addHandlers,
                            String message)

Description copied from interface: TaskService

加签，增加办理人

Specified by:

addSignature in interface TaskService

Parameters:

taskId - 修改的任务id

curUser - 当前办理人唯一标识

permissionFlag - 用户权限标识集合

addHandlers - 增加办理人：加签，转办，委托

message - 审批意见

reductionSignature

public boolean reductionSignature(Long taskId,
                                  FlowParams flowParams)

Description copied from interface: TaskService

减签，减少办理人

Specified by:

reductionSignature in interface TaskService

Parameters:

taskId - 修改的任务id [必传]

reductionSignature

public boolean reductionSignature(Long taskId,
                                  String curUser,
                                  List<String> permissionFlag,
                                  List<String> reductionHandlers,
                                  String message)

Description copied from interface: TaskService

减签，减少办理人

Specified by:

reductionSignature in interface TaskService

Parameters:

taskId - 修改的任务id

curUser - 当前办理人唯一标识

permissionFlag - 用户权限标识集合

reductionHandlers - 减少办理人

message - 审批意见

updateHandler

public boolean updateHandler(Long taskId,
                             FlowParams flowParams)

Description copied from interface: TaskService

修改办理人

Specified by:

updateHandler in interface TaskService

Parameters:

taskId - 修改的任务id [必传]

updateHandler

public boolean updateHandler(ModifyHandler modifyHandler)

Description copied from interface: TaskService

修改办理人

Specified by:

updateHandler in interface TaskService

retrieve

public Instance retrieve(Long instanceId,
                         FlowParams flowParams)

Description copied from interface: TaskService

取回

Specified by:

retrieve in interface TaskService

Parameters:

instanceId - 实例id [必传]

flowParams - handler: 当前处理人 [必传] nodeCode: 取回到的节点编码，如果为空，则默认取回到开始节点 [按需传输] flowStatus: 自定义流程状态 [按需传输] hisStatus: 自定义历史任务状态 [按需传输] hisTaskExt: 业务详情扩展字段 [按需传输] message: 审批意见 [按需传输]

Returns:

Instance 流程实例

addTask

public Task addTask(Node node,
                    Instance instance,
                    Definition definition,
                    FlowParams flowParams)

Description copied from interface: TaskService

设置流程待办任务对象

Specified by:

addTask in interface TaskService

Parameters:

node - 节点

instance - 流程实例

flowParams - 流程参数

Returns:

Task

setFlowStatus

public String setFlowStatus(Integer nodeType,
                            String skipType)

Description copied from interface: TaskService

设置流程实例和代码任务流程状态

Specified by:

setFlowStatus in interface TaskService

Parameters:

nodeType - 节点类型（开始节点、中间节点、结束节点）

skipType - 流程条件

getNextTask

public Task getNextTask(List<Task> tasks)

Description copied from interface: TaskService

并行网关，取结束节点类型，否则随便取id最大的

Specified by:

getNextTask in interface TaskService

Parameters:

tasks - 任务列表

Returns:

Task

getAndCheck

private TaskServiceImpl.R getAndCheck(Long taskId)

getAndCheck

private TaskServiceImpl.R getAndCheck(Task task)

handleDepute

private boolean handleDepute(Task task,
                             FlowParams flowParams)

cooperate

private boolean cooperate(Node nowNode,
                          Task task,
                          FlowParams flowParams)

会签，票签，协作处理，返回true；或签或者会签、票签结束返回false

Parameters:

nowNode - 当前节点

task - 任务

flowParams - 流程参数

Returns:

boolean

buildAddTasks

private List<Task> buildAddTasks(FlowParams flowParams,
                                 Task task,
                                 Instance instance,
                                 List<Node> nextNodes,
                                 Node nextNode,
                                 Definition definition)

构建增待办任务

Parameters:

flowParams - 流程参数

task - 待办任务

instance - 实例

nextNode - 下个节点

Returns:

List

gateWayParallelIsFinish

private boolean gateWayParallelIsFinish(Task task,
                                        Instance instance,
                                        String nextNodeCode)

判断并行网关节点前置任务是否都完成 多条线路汇聚到并行网关，必须所有任务都完成，才能继续。 根据并行网关节点，查询前面的节点是否都完成， 判断规则，获取网关所有前置节点，并且查询是否有历史任务记录，前前置节点完成时间是否早于前置节点

Parameters:

task - 待办任务

instance - 实例

nextNodeCode - 下个节点编码

Returns:

boolean

checkAuth

private void checkAuth(Node NowNode,
                       Task task,
                       FlowParams flowParams)

判断当前处理人是否有权限处理

Parameters:

NowNode - 当前节点权限（动态权限）

task - 当前任务（任务id）

flowParams:包含流程相关参数的对象 -

setInsFinishInfo

private void setInsFinishInfo(Instance instance,
                              List<Task> addTasks,
                              FlowParams flowParams)

oneVoteVeto

private void oneVoteVeto(Task task,
                         FlowParams flowParams,
                         String nextNodeCode)

一票否决（谨慎使用），如果退回，退回指向节点后还存在其他正在执行的待办任务，转历史任务，状态都为退回,重走流程。

Parameters:

task - 当前任务

flowParams - 包含流程相关参数的对象

nextNodeCode - 下一个节点编码

judgeReject

private boolean judgeReject(String nextNodeCode,
                            List<Skip> lastSkips,
                            Map<String,List<Skip>> skipMap)

判断是否属于退回指向节点的后置未完成的任务

Parameters:

nextNodeCode - 下一个节点编码

lastSkips - 上一个跳转集合

skipMap - 跳转map

Returns:

boolean

handUndoneTask

private void handUndoneTask(Instance instance,
                            FlowParams flowParams)

处理未完成的任务，当流程完成，还存在待办任务未完成，转历史任务，状态完成。

Parameters:

instance - 流程实例

convertHisTask

private void convertHisTask(List<Task> taskList,
                            FlowParams flowParams,
                            String flowStatus)

待办任务转历史任务。

updateFlowInfo

private void updateFlowInfo(Task task,
                            Instance instance,
                            List<Task> addTasks,
                            FlowParams flowParams,
                            List<Node> nextNodes)

更新流程信息

Parameters:

task - 当前任务

instance - 流程实例

addTasks - 新增待办任务

flowParams - 包含流程相关参数的对象

nextNodes - 下一个节点集合

judgeActivityStatus

private boolean judgeActivityStatus(Definition definition,
                                    Instance instance)