各种场景的Service总结

各种场景的Service总结

RepositoryService 流程存储服务

RepositoryService是流程定义和部署对象，主要有以下三个部分的功能：

1. 管理流程定义文件(xml)和相关资源(流程图片bpmn)

   这是最重要的功能。通过deploymentBuilder部署文件构造器的方式来部署文件，一个DeploymentBuilder对象可以部署多个资源文件，然后在使用deploy方法的时候完成部署。

2. 流程的暂停挂起和激活

   通过suspendProcessDefinitionById和activateProcessDefinitionByKey来挂起和激活流程。

3. 定义流程启动的权限

   通过addCandidateStarterUser等方法为流程设置用户或用户组。

RuntimeService 流程运行服务

RuntimeService是流程执行的管理对象，有以下几个重要的点：

1. 流程启动和对流程数据进行控制

   流程启动可以通过startProcessInstanceBy**的方式启动流程，可选参数有有key、message、id等，一般都会用key，id是不定的。

   也可以通过createProcessInstanceBuilder.start的方式去启动。

   流程数据主要指的是setVariable设置流程的一些相关数据。

2. 流程实例(ProcessInstance)和执行流(Execution)

   • 流程实例ProcessInstance表示一次工作流业务的数据实体，流程从开始到结束的最大分支，一个流程中，流程实例只有1个
   • 执行流Execution表示流程实例中的具体工作路径，按照流程定义的规则执行一次的操作，一个流程中，执行对象可以有多个（也就是分支，不同的执行路径）
   • ProcessInstance类继承Execution类，可以看出流程实例ProcessInstance是特殊的执行流Execution。

TaskService 任务管理服务

1. 对用户任务UserTask的管理和流程的控制
   • Task对象的创建和删除（一般task的创建是流程流转到UserTask的时候就会创建）
   • 查询Task,驱动Task节点完成执行（taskService.createTaskQuery(）
   • Task相关参数变量variable设置（全局变量-setVariable；局部变量-setVariableLocal（局部变量随着task任务的完成就销毁了））
2. 设置用户任务的权限信息（设置候选人等）
3. 针对用户任务添加任务附件，任务评论和事件记录
   • 任务附件Attachment
   • 任务评论Comment
   • 事件记录Event

IdentityService

1. 管理用户

2. 管理用户组

3. 用户与用户组的关系(MemberShip)

注意：

1. 用户和用户组的关系是多对多的关系。

2. 每次新增或者修改用户信息都记得使用saveUser方法进行保存。关于这个保存用户信息的方法对应的实现逻辑图如下：

   
   之前讲过XXservice的方法实现是通过命令模式和责任链模式去实现的，这里也是一样的，会将saveUser的操作交给CommandExecutor，最后交给了mybatis的DbSqlSession的insert，将user数据保存到数据库。**判断是不是新建的用户的依据是User表中版本号字段是否为0。**执行insert方法时内部并没有mybatis执行insert方法，只是创建id，并将entity实体放到缓存对象中去。那什么时候才最终持久化到数据库中呢？答案在DbSqlSession的flush方法中。

HistoryService

**管理流程实例结束后的数据(查询、删除等操作)。**源码的HistoryService中的方法主要就两类，创建query和delect，也就是说主要就是查询和删除的操作。

可操作的数据主要有：

1. HistoricProcessInstance 历史流程实例信息

   HistoricProcessInstanceQuery createHistoricProcessInstanceQuery();
   

2. HistoricActivityInstance 节点历史活动信息

   HistoricActivityInstanceQuery createHistoricActivityInstanceQuery();
   

3. HistoricTaskInstance 历史任务实例信息

   HistoricTaskInstanceQuery createHistoricTaskInstanceQuery();
   

4. HistoricDetail 历史流程详细信息

   HistoricDetailQuery createHistoricDetailQuery();
   

managementService

1. Job任务管理

2. 数据库相关通用操作

   • 查询表结构元数据(TableMetaData)
   • 通用表查询(TablePageQuery)
   • 执行自定义的sql查询(executeCustomSql)

3. 执行流程引擎命令(Command)