com.bstek.uflo.service

接口 TaskService

所有已知实现类:

DefaultTaskService

public interface TaskService

字段概要

字段

限定符和类型	字段和说明
static String	BEAN_ID
static String	TEMP_FLOW_NAME_PREFIX

方法概要

限定符和类型	方法和说明
Task	addCountersign(long taskId, String username) 向现有的会签任务中再添加一个新的会签任务
void	batchComplete(List<Long> taskIds, Map<String,Object> variables) 批量完成指定ID的任务，并写入指定的流程变量
void	batchComplete(List<Long> taskIds, Map<String,Object> variables, TaskOpinion opinion) 批量完成指定ID的任务，并写入指定的流程变量
void	batchStart(List<Long> taskIds) 批量开始一批任务
void	batchStartAndComplete(List<Long> taskIds, Map<String,Object> variables) 批量开始并完成一批指定的任务，并可写入指定的流程变量
void	batchStartAndComplete(List<Long> taskIds, Map<String,Object> variables, TaskOpinion opinion) 批量开始并完成一批指定的任务，并可写入指定的流程变量
void	cancelTask(long taskId) 取消指定的任务，任务状态将会标记上Canceled标记，同时任务也会被插入到历史表中，以备查询
void	cancelTask(long taskId, TaskOpinion opinion) 取消指定的任务，任务状态将会标记上Canceled标记，同时任务也会被插入到历史表中，以备查询
boolean	canWithdraw(long taskId) 判断当前任务是否可被撤回到上一任务节点
boolean	canWithdraw(Task task) 判断当前任务是否可回退到上一任务节点
void	changeTaskAssignee(long taskId, String username) 更改任务处理人
void	claim(long taskId, String username) 认领一个任务
void	complete(long taskId) 完成指定ID的任务
void	complete(long taskId, Map<String,Object> variables) 完成指定ID的任务，同时设置回写到流程实例中的变量集合
void	complete(long taskId, Map<String,Object> variables, TaskOpinion opinion) 完成指定ID的任务，同时设置回写到流程实例中的变量集合
void	complete(long taskId, String flowName) 完成指定ID的任务，同时设置下一步流向名称
void	complete(long taskId, String flowName, Map<String,Object> variables) 完成指定ID的任务，同时设置下一步流向名称及回写到流程实例中的变量集合
void	complete(long taskId, String flowName, Map<String,Object> variables, TaskOpinion opinion) 完成指定ID的任务，同时设置下一步流向名称及回写到流程实例中的变量集合
void	complete(long taskId, String flowName, TaskOpinion opinion) 完成指定ID的任务，同时设置下一步流向名称
void	complete(long taskId, TaskOpinion opinion) 完成指定ID的任务
TaskQuery	createTaskQuery()
void	deleteCountersign(long taskId) 删除一个会签任务
void	deleteTask(long taskId) 删除一个任务实例，要求这个任务对应的实例实例未结束，否则将不能删除
void	deleteTaskByNode(long processInstanceId, String nodeName) 删除某个任务节点上产生的所有任务实例，要求这里的processInstanceId对应的流程实例未结束
void	deleteTaskReminder(long taskReminderId)
void	forward(long taskId, String targetNodeName) 完成指定ID的任务，跳转到指定的目标节点
void	forward(long taskId, String targetNodeName, Map<String,Object> variables) 完成指定ID的任务，跳转到指定的目标节点，同时设置回写到流程实例中的变量集合
void	forward(long taskId, String targetNodeName, Map<String,Object> variables, TaskOpinion opinion) 完成指定ID的任务，跳转到指定的目标节点，同时设置回写到流程实例中的变量集合
void	forward(long taskId, String targetNodeName, TaskOpinion opinion) 完成指定ID的任务，跳转到指定的目标节点
void	forward(Task task, String targetNodeName, Map<String,Object> variables, TaskOpinion opinion) 完成指定ID的任务，跳转到指定的目标节点，同时设置回写到流程实例中的变量集合
void	forward(Task task, String targetNodeName, Map<String,Object> variables, TaskOpinion opinion, TaskState state) 完成指定ID的任务，跳转到指定的目标节点，同时设置回写到流程实例中的变量集合，并指定任务状态
List<TaskReminder>	getAllTaskReminders()
List<String>	getAvaliableAppointAssigneeTaskNodes(long taskId) 根据给出的任务ID，获取当前任务节点下可指定任务处理人的任务节点名
List<JumpNode>	getAvaliableForwardTaskNodes(long taskId) 获取当前任务可以跳转的任务节点名称
List<JumpNode>	getAvaliableRollbackTaskNodes(long taskId) 获取指定任务ID对应的可回退的目标任务节点名列表
List<JumpNode>	getAvaliableRollbackTaskNodes(Task task) 获取指定任务ID对应的可回退的目标任务节点名列表
Task	getTask(long taskId) 根据ID获取一个任务对象
List<TaskAppointor>	getTaskAppointors(String taskNodeName, long processInstanceId) 获取指定流程实例下任务节点的通过指派的任务处理人信息
List<String>	getTaskNodeAssignees(long taskId, String taskNodeName) 获取指定任务节点下配置的任务处理人列表
List<TaskParticipator>	getTaskParticipators(long taskId) 根据任务ID取得当前任务潜在处理人列表
List<TaskReminder>	getTaskReminders(long taskId)
String	getUserData(long processId, String taskNodeName, String key) 查找指定任务节点上指定key对象的UserData的值
String	getUserData(Task task, String key) 查找指定任务节点上指定key对象的UserData的值
void	release(long taskId) 对认领后的任务进行释放，从而允许其它人认领
void	resume(long taskId) 让处于挂起状态的任务恢复正常
void	rollback(long taskId, String targetNodeName) 完成指定ID的任务，回退到指定的目标节点
void	rollback(long taskId, String targetNodeName, Map<String,Object> variables) 完成指定ID的任务，回退到指定的目标节点，同时设置回写到流程实例中的变量集合
void	rollback(long taskId, String targetNodeName, Map<String,Object> variables, TaskOpinion opinion) 完成指定ID的任务，回退到指定的目标节点，同时设置回写到流程实例中的变量集合
void	rollback(Task task, String targetNodeName, Map<String,Object> variables, TaskOpinion opinion) 完成指定ID的任务，回退到指定的目标节点，同时设置回写到流程实例中的变量集合
void	saveTaskAppointor(long taskId, String[] assignees, String taskNodeName) 在某个任务中指定下一个指定任务节点上的任务处理人,可以为多个处理人
void	saveTaskAppointor(long taskId, String assignee, String taskNodeName) 在某个任务中指定下一个指定任务节点上的任务处理人
void	setPriority(String priority, long taskId) 设置任务优先级或紧急程序，该值是一个字符串，具体内容由用户决定
void	setProgress(int progress, long taskId) 设置任务处理进度值，正常情况下该值应该在0~100之间，同时当任务正常完成时，任务进度将自动设置为100
void	start(long taskId) 开始处理一个任务
void	suspend(long taskId) 将一个任务挂起
void	withdraw(long taskId) 将指定ID的任务撤回到上一个任务节点
void	withdraw(long taskId, Map<String,Object> variables) 将指定ID的任务撤回到上一个任务节点，并填充变量
void	withdraw(long taskId, Map<String,Object> variables, TaskOpinion opinion) 将指定ID的任务撤回到上一个任务节点，并填充变量
void	withdraw(long taskId, TaskOpinion opinion) 将指定ID的任务撤回到上一个任务节点

字段详细资料

BEAN_ID

static final String BEAN_ID

另请参阅:

常量字段值

TEMP_FLOW_NAME_PREFIX

static final String TEMP_FLOW_NAME_PREFIX

另请参阅:

常量字段值

方法详细资料

setProgress

void setProgress(int progress,
                 long taskId)

设置任务处理进度值，正常情况下该值应该在0~100之间，同时当任务正常完成时，任务进度将自动设置为100

参数:

progress - 任务进度值

taskId - 任务ID

setPriority

void setPriority(String priority,
                 long taskId)

设置任务优先级或紧急程序，该值是一个字符串，具体内容由用户决定

参数:

priority - 任务优先级或紧急程序

taskId - 任务ID

getAvaliableAppointAssigneeTaskNodes

List<String> getAvaliableAppointAssigneeTaskNodes(long taskId)

根据给出的任务ID，获取当前任务节点下可指定任务处理人的任务节点名

参数:

taskId - 任务ID

返回:

可指定任务处理人的任务节点名列表

getTaskNodeAssignees

List<String> getTaskNodeAssignees(long taskId,
                                  String taskNodeName)

获取指定任务节点下配置的任务处理人列表

参数:

taskId - 任务ID

taskNodeName - 任务节点名称

返回:

返回当前节点配置的任务处理人列表

saveTaskAppointor

void saveTaskAppointor(long taskId,
                       String assignee,
                       String taskNodeName)

在某个任务中指定下一个指定任务节点上的任务处理人

参数:

taskId - 具体任务对象ID

assignee - 要指定的任务处理人

taskNodeName - 指定任务处理人的任务节点名称

saveTaskAppointor

void saveTaskAppointor(long taskId,
                       String[] assignees,
                       String taskNodeName)

在某个任务中指定下一个指定任务节点上的任务处理人,可以为多个处理人

参数:

taskId - 具体任务对象ID

assignees - 要指定的任务处理人集合

taskNodeName - 指定任务处理人的任务节点名称

addCountersign

Task addCountersign(long taskId,
                    String username)

向现有的会签任务中再添加一个新的会签任务

参数:

taskId - 参考的任务ID

username - 新的任务的处理人

返回:

返回加签产生的新的任务对象

deleteCountersign

void deleteCountersign(long taskId)

删除一个会签任务

参数:

taskId - 要删除的会签任务的ID

getAvaliableForwardTaskNodes

List<JumpNode> getAvaliableForwardTaskNodes(long taskId)

获取当前任务可以跳转的任务节点名称

参数:

taskId - 任务ID

返回:

可跳转的目标任务节点集合

complete

void complete(long taskId,
              String flowName)

完成指定ID的任务，同时设置下一步流向名称

参数:

taskId - 要完成的任务ID

flowName - 下一步流向名称

complete

void complete(long taskId,
              String flowName,
              TaskOpinion opinion)

完成指定ID的任务，同时设置下一步流向名称

参数:

taskId - 要完成的任务ID

flowName - 下一步流向名称

opinion - 任务处理意见

batchComplete

void batchComplete(List<Long> taskIds,
                   Map<String,Object> variables)

批量完成指定ID的任务，并写入指定的流程变量

参数:

taskIds - 要完成的任务的ID集合

variables - 回写到要完成任务的变量集合

batchComplete

void batchComplete(List<Long> taskIds,
                   Map<String,Object> variables,
                   TaskOpinion opinion)

批量完成指定ID的任务，并写入指定的流程变量

参数:

taskIds - 要完成的任务的ID集合

variables - 回写到要完成任务的变量集合

opinion - 任务处理意见

complete

void complete(long taskId,
              String flowName,
              Map<String,Object> variables)

完成指定ID的任务，同时设置下一步流向名称及回写到流程实例中的变量集合

参数:

taskId - 任务ID

flowName - 下一步流向名称

variables - 回写的变量集合

complete

void complete(long taskId,
              String flowName,
              Map<String,Object> variables,
              TaskOpinion opinion)

完成指定ID的任务，同时设置下一步流向名称及回写到流程实例中的变量集合

参数:

taskId - 任务ID

flowName - 下一步流向名称

variables - 回写的变量集合

opinion - 任务处理意见

complete

void complete(long taskId)

完成指定ID的任务

参数:

taskId - 要完成的任务ID

complete

void complete(long taskId,
              TaskOpinion opinion)

完成指定ID的任务

参数:

taskId - 要完成的任务ID

opinion - 任务处理意见

complete

void complete(long taskId,
              Map<String,Object> variables)

完成指定ID的任务，同时设置回写到流程实例中的变量集合

参数:

taskId - 任务ID

variables - 变量集合

complete

void complete(long taskId,
              Map<String,Object> variables,
              TaskOpinion opinion)

完成指定ID的任务，同时设置回写到流程实例中的变量集合

参数:

taskId - 任务ID

variables - 变量集合

opinion - 任务处理意见

forward

void forward(long taskId,
             String targetNodeName)

完成指定ID的任务，跳转到指定的目标节点

参数:

taskId - 任务ID

targetNodeName - 指定的目标节点名称

forward

void forward(long taskId,
             String targetNodeName,
             TaskOpinion opinion)

完成指定ID的任务，跳转到指定的目标节点

参数:

taskId - 任务ID

targetNodeName - 指定的目标节点名称

opinion - 任务处理意见

forward

void forward(long taskId,
             String targetNodeName,
             Map<String,Object> variables)

完成指定ID的任务，跳转到指定的目标节点，同时设置回写到流程实例中的变量集合

参数:

taskId - 任务ID

targetNodeName - 指定的目标节点名称

variables - 变量集合

forward

void forward(long taskId,
             String targetNodeName,
             Map<String,Object> variables,
             TaskOpinion opinion)

完成指定ID的任务，跳转到指定的目标节点，同时设置回写到流程实例中的变量集合

参数:

taskId - 任务ID

targetNodeName - 指定的目标节点名称

variables - 变量集合

opinion - 任务处理意见

forward

void forward(Task task,
             String targetNodeName,
             Map<String,Object> variables,
             TaskOpinion opinion)

完成指定ID的任务，跳转到指定的目标节点，同时设置回写到流程实例中的变量集合

参数:

task - 任务对象

targetNodeName - 指定的目标节点名称

variables - 变量集合

opinion - 任务处理意见

forward

void forward(Task task,
             String targetNodeName,
             Map<String,Object> variables,
             TaskOpinion opinion,
             TaskState state)

完成指定ID的任务，跳转到指定的目标节点，同时设置回写到流程实例中的变量集合，并指定任务状态

参数:

task - 任务对象

targetNodeName - 指定的目标节点名称

variables - 变量集合

opinion - 任务处理意见

state - 任务状态

rollback

void rollback(long taskId,
              String targetNodeName,
              Map<String,Object> variables,
              TaskOpinion opinion)

完成指定ID的任务，回退到指定的目标节点，同时设置回写到流程实例中的变量集合

参数:

taskId - 任务ID

targetNodeName - 指定的目标节点名称

variables - 变量集合

opinion - 任务处理意见

rollback

void rollback(Task task,
              String targetNodeName,
              Map<String,Object> variables,
              TaskOpinion opinion)

完成指定ID的任务，回退到指定的目标节点，同时设置回写到流程实例中的变量集合

参数:

task - 任务对象

targetNodeName - 指定的目标节点名称

variables - 变量集合

opinion - 任务处理意见

rollback

void rollback(long taskId,
              String targetNodeName,
              Map<String,Object> variables)

完成指定ID的任务，回退到指定的目标节点，同时设置回写到流程实例中的变量集合

参数:

taskId - 任务ID

targetNodeName - 指定的目标节点名称

variables - 变量集合

rollback

void rollback(long taskId,
              String targetNodeName)

完成指定ID的任务，回退到指定的目标节点

参数:

taskId - 任务ID

targetNodeName - 指定的目标节点名称

getAvaliableRollbackTaskNodes

List<JumpNode> getAvaliableRollbackTaskNodes(long taskId)

获取指定任务ID对应的可回退的目标任务节点名列表

参数:

taskId - 要回退的任务ID

返回:

返回可回退的目标任务节点名列表

getAvaliableRollbackTaskNodes

List<JumpNode> getAvaliableRollbackTaskNodes(Task task)

获取指定任务ID对应的可回退的目标任务节点名列表

参数:

task - 要回退的任务

返回:

返回可回退的目标任务节点名列表

withdraw

void withdraw(long taskId)

将指定ID的任务撤回到上一个任务节点

参数:

taskId - 任务的ID

withdraw

void withdraw(long taskId,
              TaskOpinion opinion)

将指定ID的任务撤回到上一个任务节点

参数:

taskId - 任务的ID

opinion - 任务处理意见

withdraw

void withdraw(long taskId,
              Map<String,Object> variables)

将指定ID的任务撤回到上一个任务节点，并填充变量

参数:

taskId - 任务的ID

variables - 变量集合

withdraw

void withdraw(long taskId,
              Map<String,Object> variables,
              TaskOpinion opinion)

将指定ID的任务撤回到上一个任务节点，并填充变量

参数:

taskId - 任务的ID

variables - 变量集合

opinion - 任务处理意见

canWithdraw

boolean canWithdraw(long taskId)

判断当前任务是否可被撤回到上一任务节点

参数:

taskId - 任务的ID

返回:

返回布尔值

canWithdraw

boolean canWithdraw(Task task)

判断当前任务是否可回退到上一任务节点

参数:

task - 任务对象

返回:

返回布尔值

getTask

Task getTask(long taskId)

根据ID获取一个任务对象

参数:

taskId - 任务ID

返回:

返回任务对象

claim

void claim(long taskId,
           String username)

认领一个任务

参数:

taskId - 要认领任务的ID

username - 认领任务的人的用户名

release

void release(long taskId)

对认领后的任务进行释放，从而允许其它人认领

参数:

taskId - 要释放任务的ID

start

void start(long taskId)

开始处理一个任务

参数:

taskId - 任务的ID

batchStart

void batchStart(List<Long> taskIds)

批量开始一批任务

参数:

taskIds - 要开始的任务的ID集合

batchStartAndComplete

void batchStartAndComplete(List<Long> taskIds,
                           Map<String,Object> variables)

批量开始并完成一批指定的任务，并可写入指定的流程变量

参数:

taskIds - 要完成的任务的ID集合

variables - 要回写的流程变量

batchStartAndComplete

void batchStartAndComplete(List<Long> taskIds,
                           Map<String,Object> variables,
                           TaskOpinion opinion)

批量开始并完成一批指定的任务，并可写入指定的流程变量

参数:

taskIds - 要完成的任务的ID集合

variables - 要回写的流程变量

opinion - 任务处理意见

suspend

void suspend(long taskId)

将一个任务挂起

参数:

taskId - 要挂起的任务的ID

resume

void resume(long taskId)

让处于挂起状态的任务恢复正常

参数:

taskId - 要操作的任务的ID

deleteTask

void deleteTask(long taskId)

删除一个任务实例，要求这个任务对应的实例实例未结束，否则将不能删除

参数:

taskId - 任务实例ID

deleteTaskByNode

void deleteTaskByNode(long processInstanceId,
                      String nodeName)

删除某个任务节点上产生的所有任务实例，要求这里的processInstanceId对应的流程实例未结束

参数:

processInstanceId - 流程实例ID

nodeName - 任务节点名称

cancelTask

void cancelTask(long taskId)

取消指定的任务，任务状态将会标记上Canceled标记，同时任务也会被插入到历史表中，以备查询

参数:

taskId - 任务ID

cancelTask

void cancelTask(long taskId,
                TaskOpinion opinion)

取消指定的任务，任务状态将会标记上Canceled标记，同时任务也会被插入到历史表中，以备查询

参数:

taskId - 任务ID

opinion - 任务处理意见

getTaskParticipators

List<TaskParticipator> getTaskParticipators(long taskId)

根据任务ID取得当前任务潜在处理人列表

参数:

taskId - 任务ID

返回:

处理人列表

getTaskAppointors

List<TaskAppointor> getTaskAppointors(String taskNodeName,
                                      long processInstanceId)

获取指定流程实例下任务节点的通过指派的任务处理人信息

参数:

taskNodeName - 任务节点名称

processInstanceId - 流程实例ID

返回:

TaskAppointor集合

changeTaskAssignee

void changeTaskAssignee(long taskId,
                        String username)

更改任务处理人

参数:

taskId - 任务ID

username - 新的处理人用户名

getUserData

String getUserData(Task task,
                   String key)

查找指定任务节点上指定key对象的UserData的值

参数:

task - 任务对象

key - UserData的key值

返回:

UserData对应的value值

getUserData

String getUserData(long processId,
                   String taskNodeName,
                   String key)

查找指定任务节点上指定key对象的UserData的值

参数:

processId - 流程模版ID

taskNodeName - 任务节点名称

key - UserData的key值

返回:

UserData对应的value值

createTaskQuery

TaskQuery createTaskQuery()

getTaskReminders

List<TaskReminder> getTaskReminders(long taskId)

deleteTaskReminder

void deleteTaskReminder(long taskReminderId)

getAllTaskReminders

List<TaskReminder> getAllTaskReminders()