首页 > 代码库 > 04--activiti demo
04--activiti demo
核心API
1:ProcessEngine
说明:
1) 在Activiti中最核心的类,其他的类都是由他而来。
2) 产生方式:
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();// 流程引擎
3) 可以产生RepositoryService
processEngine.getRepositoryService()// 与流程定义和部署对象相关的Service
4) 可以产生RuntimeService
processEngine.getRuntimeService()// 与正在执行的流程实例和执行对象相关的Service
5) 可以产生TaskService
processEngine.getTaskService()// 与正在执行的任务管理相关的Service
各个Service的作用:
RepositoryService 管理流程定义
RuntimeService 执行管理,包括启动、推进、删除流程实例等操作
TaskService 任务管理
HistoryService 历史管理(执行完的数据的管理)
IdentityService 组织机构管理
FormService 一个可选服务,任务表单管理
ManagerService
2:RepositoryService
是Activiti的仓库服务类。所谓的仓库指流程定义文档的两个文件:bpmn文件和流程图片。
1) 产生方式
processEngine.getRepositoryService()
2) 可以产生DeploymentBuilder,用来定义流程部署的相关参数
processEngine.getRepositoryService()// 与流程定义和部署对象相关的Service
.createDeployment()// 创建一个部署对象
3) 删除流程定义
processEngine.getRepositoryService().deleteDeployment(deploymentId)
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。
总结:
* 一个流程中,执行对象可以存在多个,但是流程实例只能有一个。
* 当流程按照规则只执行一次的时候,那么流程实例就是执行对象。
package cn.miye.test; import java.util.List; import org.activiti.engine.ProcessEngine; import org.activiti.engine.ProcessEngines; import org.activiti.engine.repository.Deployment; import org.activiti.engine.runtime.ProcessInstance; import org.activiti.engine.task.Task; import org.junit.Test; public class HelloWorld { ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();// 流程引擎 /** 部署流程定义 */ @Test public void deploymentProcessDefinition() { // deployment对象存在对应act_re_deployment表中的一条数据 // 部署流程定义会在act_re_deployment表中插入一条数据, // 也会在act_re_procdef中增加一条数据 Deployment deployment = processEngine.getRepositoryService()// 与流程定义和部署对象相关的Service .createDeployment()// 创建一个部署对象 .name("helloworld入门程序")// 添加部署的名称 .addClasspathResource("diagrams/helloworld.bpmn")// 从classpath的资源中加载,一次只能加载一个文件 .addClasspathResource("diagrams/helloworld.png")// 从classpath的资源中加载,一次只能加载一个文件 .deploy();// 完成部署 System.out.println("部署ID:" + deployment.getId());// 1 System.out.println("部署名称:" + deployment.getName());// helloworld入门程序 } /** 启动流程实例 */ @Test public void startProcessInstance() { // 启动流程实例会在act_ru_execution中增加一条数据,表示流程开始执行 // 在act_ru_identitylink中增加一条数据,表示流程当前的执行人 // 在act_ru_task中增一条数据 // 在act_hi_taskinst中增一条数据 // 在act_hi_procinst中增一条数据 // 在act_hi_actinst中增一条数据 // 流程定义的key String processDefinitionKey = "helloworld"; ProcessInstance pi = processEngine.getRuntimeService()// 与正在执行的流程实例和执行对象相关的Service .startProcessInstanceByKey(processDefinitionKey); // 使用流程定义的key启动流程实例,key对应helloworld.bpmn文件中id的属性值 // 为什么使用使用key值启动,因为使用key启动,默认是按照最新版本的流程定义启动 // 启动返回一个流程实例对象 System.out.println("流程实例ID:" + pi.getId());// 流程实例ID 101 System.out.println("流程定义ID:" + pi.getProcessDefinitionId());// 流程定义ID helloworld:1:4 } /** 查询当前人的个人任务 */ @Test public void findMyPersonalTask() { String assignee = "王五"; // 在在act_ru_task中查询数据 List<Task> list = processEngine.getTaskService()// 与正在执行的任务管理相关的Service .createTaskQuery()// 创建任务查询对象 .taskAssignee(assignee)// 指定个人任务查询,指定办理人 .list(); if (list != null && list.size() > 0) { for (Task task : list) { System.out.println("任务ID:" + task.getId()); System.out.println("任务名称:" + task.getName()); System.out.println("任务的创建时间:" + task.getCreateTime()); System.out.println("任务的办理人:" + task.getAssignee()); System.out.println("流程实例ID:" + task.getProcessInstanceId()); System.out.println("执行对象ID:" + task.getExecutionId()); System.out.println("流程定义ID:" + task.getProcessDefinitionId()); System.out.println("########################################################"); } } } /** 完成我的任务 */ @Test public void completeMyPersonalTask() { // 任务ID String taskId = "302"; processEngine.getTaskService()// 与正在执行的任务管理相关的Service .complete(taskId); System.out.println("完成任务:任务ID:" + taskId); } }
04--activiti demo