Activiti流程文件部署过程解析

用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);

}

}

六、总结

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

以上是 Activiti流程文件部署过程解析 的全部内容, 来源链接: utcz.com/z/312097.html

回到顶部