net.sohelp.boot.engine.workflow

接口 RuntimeService

所有已知实现类:

RuntimeServiceImpl

public interface RuntimeService

流程实例运行业务类

从以下版本开始:

2025/02/03 10:26

方法概要

限定符和类型	方法和说明
default boolean	addVariable(Long instanceId, Map<String,Object> args) 根据 流程实例ID 更新流程实例全局变量
boolean	addVariable(Long instanceId, Map<String,Object> args, Function<FlwInstance,FlwInstance> function) 根据 流程实例ID 更新流程实例全局变量
void	appendNodeModel(Long taskId, NodeModel nodeModel, boolean beforeAfter) 追加节点模型（不执行任务跳转） 执行追加节点模型调用 FlowEngine.executeAppendNodeModel(Long, NodeModel, FlowCreator, boolean)
void	cascadeRemoveByInstanceId(Long instanceId) 级联删除表 flw_his_task_actor, flw_his_task, flw_task_actor, flw_task, flw_instance, flw_his_instance
void	cascadeRemoveByProcessId(Long processId) 级联删除指定流程实例的所有数据
FlwInstance	createInstance(FlwProcess flwProcess, FlowCreator flowCreator, Map<String,Object> args, NodeModel nodeModel, Supplier<FlwInstance> supplier) 根据流程、创建人员、父流程实例ID创建流程实例
boolean	endInstance(Execution execution, Long instanceId, NodeModel endNode) 结束流程实例（审批通过）
ProcessModel	getProcessModelByInstanceId(Long instanceId) 根据流程实例ID获取流程实例模型
boolean	reject(Long instanceId, FlowCreator flowCreator) 流程实例拒绝审批强制终止（用于后续审核人员认为该审批不再需要继续，拒绝审批强行终止）
boolean	revoke(Long instanceId, FlowCreator flowCreator) 流程实例撤销（用于错误发起审批申请，发起人主动撤销）
void	saveInstance(FlwInstance flwInstance, FlwProcess flwProcess, FlowCreator flowCreator) 保存流程实例
boolean	terminate(Long instanceId, FlowCreator flowCreator) 流程实例强制终止
default void	timeout(Long instanceId) 流程实例超时（忽略操作权限）
boolean	timeout(Long instanceId, FlowCreator flowCreator) 流程实例超时（设定审批时间超时，自动结束）
void	updateInstance(FlwInstance flwInstance) 更新流程实例
boolean	updateInstanceModelById(Long instanceId, ProcessModel processModel) 根据 流程实例ID 更新流程实例模型内容

方法详细资料

createInstance

FlwInstance createInstance(FlwProcess flwProcess,
                           FlowCreator flowCreator,
                           Map<String,Object> args,
                           NodeModel nodeModel,
                           Supplier<FlwInstance> supplier)

根据流程、创建人员、父流程实例ID创建流程实例

参数:

flwProcess - 流程定义对象

flowCreator - 流程实例任务创建者

args - 参数列表

nodeModel - 当前所在节点

supplier - 初始化流程实例提供者

返回:

活动流程实例对象

getProcessModelByInstanceId

ProcessModel getProcessModelByInstanceId(Long instanceId)

根据流程实例ID获取流程实例模型

参数:

instanceId - 流程实例ID

返回:

ProcessModel

addVariable

boolean addVariable(Long instanceId,
                    Map<String,Object> args,
                    Function<FlwInstance,FlwInstance> function)

根据 流程实例ID 更新流程实例全局变量

参数:

instanceId - 流程实例ID

args - 流程实例参数

function - 待更新实例回调处理函数

addVariable

default boolean addVariable(Long instanceId,
                            Map<String,Object> args)

根据 流程实例ID 更新流程实例全局变量

参数:

instanceId - 流程实例ID

args - 流程实例参数

endInstance

boolean endInstance(Execution execution,
                    Long instanceId,
                    NodeModel endNode)

结束流程实例（审批通过）

参数:

execution - Execution

instanceId - 流程实例ID

endNode - 结束节点

返回:

true 成功 false 失败

saveInstance

void saveInstance(FlwInstance flwInstance,
                  FlwProcess flwProcess,
                  FlowCreator flowCreator)

保存流程实例

参数:

flwInstance - 流程实例对象

flwProcess - 流程定义对象

flowCreator - 处理人员

reject

boolean reject(Long instanceId,
               FlowCreator flowCreator)

流程实例拒绝审批强制终止（用于后续审核人员认为该审批不再需要继续，拒绝审批强行终止）

参数:

instanceId - 流程实例ID

flowCreator - 处理人员

revoke

boolean revoke(Long instanceId,
               FlowCreator flowCreator)

流程实例撤销（用于错误发起审批申请，发起人主动撤销）

参数:

instanceId - 流程实例ID

flowCreator - 处理人员

timeout

boolean timeout(Long instanceId,
                FlowCreator flowCreator)

流程实例超时（设定审批时间超时，自动结束）

参数:

instanceId - 流程实例ID

flowCreator - 处理人员

timeout

default void timeout(Long instanceId)

流程实例超时（忽略操作权限）

参数:

instanceId - 流程实例ID

terminate

boolean terminate(Long instanceId,
                  FlowCreator flowCreator)

流程实例强制终止

参数:

instanceId - 流程实例ID

flowCreator - 处理人员

updateInstance

void updateInstance(FlwInstance flwInstance)

更新流程实例

参数:

flwInstance - 流程实例对象

updateInstanceModelById

boolean updateInstanceModelById(Long instanceId,
                                ProcessModel processModel)

根据 流程实例ID 更新流程实例模型内容

参数:

instanceId - 流程实例ID

processModel - 流程模型

返回:

true 成功 false 失败

cascadeRemoveByProcessId

void cascadeRemoveByProcessId(Long processId)

级联删除指定流程实例的所有数据

参数:

processId - 流程ID

cascadeRemoveByInstanceId

void cascadeRemoveByInstanceId(Long instanceId)

级联删除表 flw_his_task_actor, flw_his_task, flw_task_actor, flw_task, flw_instance, flw_his_instance

参数:

instanceId - 流程实例ID

appendNodeModel

void appendNodeModel(Long taskId,
                     NodeModel nodeModel,
                     boolean beforeAfter)

追加节点模型（不执行任务跳转）

执行追加节点模型调用 FlowEngine.executeAppendNodeModel(Long, NodeModel, FlowCreator, boolean)

参数:

taskId - 任务ID

nodeModel - 节点模型

beforeAfter - true 前置 false 后置