Activiti 核心 API

---

Activiti 核心 API

7大接口

• RepositoryService：提供一系列管理流程部署和流程定义的API。
• RuntimeService：在流程运行时对流程实例进行管理与控制。
• TaskService：对流程任务进行管理，例如任务提醒、任务完成和创建任务等。
• IdentityService：提供对流程角色数据进行管理的API，这些角色数据包括用户组、用户及它们之间的关系。
• ManagementService：提供对流程引擎进行管理和维护的服务。
• HistoryService：对流程的历史数据进行操作，包括查询、删除这些历史数据。
• FormService：表单服务。

核心API

.1: ProcessEngine

说明：

1. 在Activiti中最核心的类，其他的类都是由他而来。

2. 产生方式：

在前面看到了两种创建ProcessEngine（流程引擎）的方式，而这里要简化很多，调用ProcessEngines的getDefaultProceeEngine方法时会自动加载classpath下名为activiti.cfg.xml文件。

3. 可以产生RepositoryService

4. 可以产生RuntimeService

5. 可以产生TaskService

各个Service的作用：

RepositoryService	管理流程定义
RuntimeService	执行管理，包括启动、推进、删除流程实例等操作
TaskService	任务管理
HistoryService	历史管理(执行完的数据的管理)
IdentityService	组织机构管理
FormService	一个可选服务，任务表单管理
ManagerService	使用Activiti的定制环境中基本上不会用到。 它可以查询数据库的表和表的元数据。另外，它提供了查询和管理异步操作的功能。

.2：RepositoryService

是Activiti的仓库服务类。所谓的仓库指流程定义文档的两个文件：bpmn文件和流程图片。

1. 产生方式

2. 可以产生DeploymentBuilder，用来定义流程部署的相关参数

3. 删除流程定义

.3：RuntimeService

是activiti的流程执行服务类。可以从这个服务类中获取很多关于流程执行相关的信息。

.4：TaskService

是activiti的任务服务类。可以从这个类中获取任务的信息。

.5：HistoryService

是activiti的查询历史信息的类。在一个流程执行完成后，这个对象为我们提供查询历史信息。

.6：ProcessDefinition

流程定义类。可以从这里获得资源文件等。

.7：ProcessInstance

代表流程定义的执行实例。如范冰冰请了一天的假，她就必须发出一个流程实例的申请。一个流程实例包括了所有的运行节点。我们可以利用这个对象来了解当前流程实例的进度等信息。流程实例就表示一个流程从开始到结束的最大的流程分支，即一个流程中流程实例只有一个。

.8：Execution

Activiti用这个对象去描述流程执行的每一个节点。在没有并发的情况下，Execution就是同ProcessInstance。流程按照流程定义的规则执行一次的过程，就可以表示执行对象Execution。

如图为ProcessInstance的源代码：

从源代码中可以看出ProcessInstance就是Execution。但在现实意义上有所区别：

在单线流程中，如上图的贷款流程，ProcessInstance与Execution是一致的。

这个例子有一个特点：wire money(汇钱)和archive(存档)是并发执行的。 这个时候，总线路代表ProcessInstance，而分线路中每个活动代表Execution。

总结：

• 一个流程中，执行对象可以存在多个，但是流程实例只能有一个。

• 当流程按照规则只执行一次的时候，那么流程实例就是执行对象。