activiti学习4:流程文件的部署

activiti学习4:流程文件的部署

用bpmn规范定义好一个流程得到流程定义文件后，需要把该文件部署到activiti的数据库后，这个流程才可以使用。

activiti中和流程定义相关的操作都需要使用RepositoryService这个服务组件来进行。

activiti中所有的服务组件都需要通过流程引擎对象来获取

一、RepositoryService服务组件

这个组件中提供了一系列管理流程定义和流程部署的api,我们可以使用这个组件中的api来部署流程

1.1 RepositoryService实例对象的获取

使用流程引擎对象的实例方法processEngine.getRepositoryService();来获取RepositoryService

	@Test
	public void test1() {
		ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
		RepositoryService repositoryService = processEngine.getRepositoryService();
		System.out.println(repositoryService);
	}

二、流程部署信息的描述,Deployment对象

在讲解如何部署流程前，我们先了解下activiti如何描述流程的部署信息。activiti用Deployment这个接口来描述流程的部署信息，并自己提供了实现类。对应activiti数据库中的一张表ACT_RE_DEPLOYMENT

三、流程的部署

activiti使用DeploymentBuilder这个类的对象来部署流程，从这个类的名字就可以看出它的功能，部署一个流程并返回描述这次部署信息的对象。

使用RepositoryService服务组件的对象来获取DeploymentBuilder对象

DeploymentBuilder deploymentBuilder = repositoryService.createDeployment();

然后给这个deploymentBuilder添加要部署的流程文件的位置

deploymentBuilder.addClasspathResource("process/process.bpmn");

我这里是在resources目录下创建了process/process.bpmn流程定义文件,所以添加了这个路径

还可以为本次部署添加名称和分类

deploymentBuilder.name("vacation-test").category("test");

最后执行部署

Deployment deploy = deploymentBuilder.deploy();

观察数据库ACT_RE_DEPLOYMENT表，会发现多了一条部署记录。

完整的代码为

	@Test
	public void test1() {
		ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
		RepositoryService repositoryService = processEngine.getRepositoryService();
		DeploymentBuilder deploymentBuilder = repositoryService.createDeployment();
		deploymentBuilder.addClasspathResource("process/process.bpmn");
		deploymentBuilder.name("vacation-test").category("test");
		Deployment deploy = deploymentBuilder.deploy();
		System.out.println(deploy);
	}

注意，默认情况下多次部署同一流程图在表中会产生多条记录，用部署时间字段用来做区分

3.1 过滤重复部署的问题

为了防止资源没有发生变化而再次执行部署方法产生的重复部署，可以调用DeploymentBuilder的enableDuplicateFiltering()方法，这里的过滤方式是先查询部署表，得到表中已有的部署对象集合，如果发现有一条部署记录与将要部署的对象相同，就不会重复部署。所以部署时设置的name,category,资源名称和内容，只要有一个不一样就不会被过滤掉

deploymentBuilder.enableDuplicateFiltering();//设置过滤重复部署

四、部署信息的管理

activiti在DeploymentQuery这个接口中封装了管理部署信息的api,并自己提供了实现类，通过repositoryService服务组件来获取其实现类对象。

DeploymentQuery deploymentQuery = repositoryService.createDeploymentQuery();

4.1 查询部署信息

@Test
	public void test2() {
		ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
		RepositoryService repositoryService = processEngine.getRepositoryService();
		DeploymentQuery deploymentQuery = repositoryService.createDeploymentQuery();
		//根据deploymentId查询
		String deploymentId="4201";
		Deployment singleResult = deploymentQuery.deploymentId(deploymentId)
				.deploymentName("vacation-test").singleResult();
		System.out.println(singleResult);
	}

查询时，先给deploymentQuery对象拼接查询条件,这里支持链式编程，先一个个的拼接查询条件，最后这个

singleResult()方法执行查询，返回一个结果；如果根据设定的条件返回多个结果，调用singleResult()就会抛出异常，这时需要调用返回多个结果的查询方法list()

4.2 删除部署信息

因为部署信息表与其他表有外键关联，所以直接删除部署表中的数据是删不掉的，需要调用RepositoryService中的删除方法来删除

	@Test
	public void test3() {
		ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
		RepositoryService repositoryService = processEngine.getRepositoryService();
		String deploymentId="4201";
		boolean cascade=true;
		repositoryService.deleteDeployment(deploymentId, cascade);
	}

其中第2个参数cascade表示是否级联删除其他表的数据，直接给true就可以

五、流程定义及其管理

5.1 流程定义信息的描述

一个流程文件部署成功后，不仅会在部署表中记录部署信息，同时也会在流程定义表act_re_procdef中添加一条流程定义信息，描述被部署的流程文件所定义的流程。

注意其中的这个KEY_字段对应的就是流程定义文件中的process节点的id，activiti开启流程时要使用这个字段。

<process id="process" isExecutable="true">
    <startEvent id="sid-26F630F1-0761-4247-8383-F63F913A310E"></startEvent>
    <userTask id="usertask1" name="apply vecation" activiti:assignee="kermit"></userTask>
    <sequenceFlow id="sid-85398367-B674-473A-B7AC-268635F0DF5D" sourceRef="sid-26F630F1-0761-4247-8383-F63F913A310E" targetRef="usertask1"></sequenceFlow>
    <userTask id="usertask2" name="manager agree" activiti:assignee="kermit"></userTask>
    <sequenceFlow id="sid-5372C6B1-7359-40AB-B0A4-3FF06F20790E" sourceRef="usertask1" targetRef="usertask2"></sequenceFlow>
    <endEvent id="sid-F621C8EF-13A5-4A49-BD5B-708BFB066576"></endEvent>
    <sequenceFlow id="sid-BCF9087D-36F4-4EDE-BD88-013AC74AB93A" sourceRef="usertask2" targetRef="sid-F621C8EF-13A5-4A49-BD5B-708BFB066576"></sequenceFlow>
  </process>

和部署信息一样，activiti也有一个接口来描述这张表的信息,ProcessDefinition,并自己提供了实现类

5.2 流程定义信息的管理

activiti提供了ProcessDefinitionQuery这个接口，在其中封装了流程定义信息查询相关的api。查询对象的获取和使用与DeploymentQuery类似。

	@Test
	public void test1() {
		ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
		RepositoryService repositoryService = processEngine.getRepositoryService();
		ProcessDefinitionQuery processDefinitionQuery = repositoryService.createProcessDefinitionQuery();
		String processDefinitionKey="process";
		List<ProcessDefinition> list = processDefinitionQuery.processDefinitionKey(processDefinitionKey).list();
		for (ProcessDefinition processDefinition : list) {
			System.out.println(processDefinition);
		}
	}

六、总结

本文介绍了如何部署流程定义文件,以及对部署后生成的部署信息和流程定义信息的管理。