用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); } }
六、总结
本文介绍了如何部署流程定义文件,以及对部署后生成的部署信息和流程定义信息的管理。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持菜鸟教程(cainiaojc.com)。
声明:本文内容来源于网络,版权归原作者所有,内容由互联网用户自发贡献自行上传,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任。如果您发现有涉嫌版权的内容,欢迎发送邮件至:notice#cainiaojc.com(发邮件时,请将#更换为@)进行举报,并提供相关证据,一经查实,本站将立刻删除涉嫌侵权内容。