相关代码参考gihub:https://github.com/changwensir/Activiti/tree/master/ActivitiDemo1
一、部署流程定义
前面的话,我们使用的是classpath加载资源文件方式来部署流程定义的,但是这种方式有局限性,只能适合小项目,固定写死的流程;
实际项目的话,需要来动态导入流程定义文件,通过把bpmn和png文件打包成zip压缩包,然后用户界面直接导入到系统,然后解析,部署流程定义;Activiti是支持这种方式的。今天我们来实现下这种方式;
首先第一步
,把bpmn和png文件打成zip压缩包,放到diagrams文件夹下;
![1460523015018010067.jpg a.jpg](https://i-blog.csdnimg.cn/blog_migrate/e0707752de2a9c0f8fc4c64cb35c7a35.jpeg)
前面我们使用的是classpath加载流程定义文件;我们新建一个测试类 ProcessDefinition
- package com.java1234.activiti.test;
-
- import org.activiti.engine.ProcessEngine;
- import org.activiti.engine.ProcessEngines;
- import org.activiti.engine.repository.Deployment;
- import org.junit.Test;
-
- public class ProcessDefinition {
-
-
-
-
- private ProcessEngine processEngine=ProcessEngines.getDefaultProcessEngine();
-
-
-
-
- @Test
- public void deployWithClassPath(){
-
- Deployment deployment=processEngine.getRepositoryService()
- .createDeployment()
- .addClasspathResource("diagrams/helloWorld.bpmn")
- .addClasspathResource("diagrams/helloWorld.png")
- .name("HelloWorld流程")
- .deploy();
- System.out.println("流程部署ID:"+deployment.getId());
- System.out.println("流程部署Name:"+deployment.getName());
- }
-
- }
这一步在数据库中将操作三张表:
a).act_re_deployment(部署对象表)
存放流程定义的显示名和部署时间,每部署一次增加一条记录
b).act_re_procdef(流程定义表)
存放流程定义的属性信息,部署每个新的流程定义都会在这张表中增加一条记录。
注意:当流程定义的key相同的情况下,使用的是版本升级
c).act_ge_bytearray(资源文件表)
存储流程定义相关的部署信息。即流程定义文档的存放地。每部署一次就会增加两条记录,一条是关于bpmn规则文件的,一条是图片的(如果部署时只指定了bpmn一个文件,activiti会在部署时解析bpmn文件内容自动生成流程图)。两个文件不是很大,都是以二进制形式存储在数据库中。
下面我们用zip方式来实现,新建一个deployWithZip方法:
-
-
-
- @Test
- public void deployWithZip(){
- InputStream inputStream=this.getClass()
- .getClassLoader()
- .getResourceAsStream("diagrams/helloWorld.zip");
- ZipInputStream zipInputStream=new ZipInputStream(inputStream);
-
- Deployment deployment=processEngine.getRepositoryService()
- .createDeployment()
- .name("HelloWorld流程2")
- .addZipInputStream(zipInputStream)
- .deploy();
- System.out.println("流程部署ID:"+deployment.getId());
- System.out.println("流程部署Name:"+deployment.getName());
- }
我们运行这个测试类:
SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.
流程部署ID:7501
流程部署Name:HelloWorld流程2
|
说明已经部署成功了;
我们来看下相关表:这里我们再来把几个关键表拎出来,好好熟悉下:
act_re_deployment 流程定义部署表:
![1460523389534070099.jpg b.jpg](https://i-blog.csdnimg.cn/blog_migrate/9e8c0629138699b030a68e339662b93b.jpeg)
我们会发现,这里多了一条记录;
act_re_procdef 流程定义表
![1460523477549054436.jpg c.jpg](https://i-blog.csdnimg.cn/blog_migrate/68bfbb974c3e339b53b300dd39ce9611.jpeg)
流程定义表里,我们发现VERSION_字段 版本升级了,KEY依然是一样的;
act_ge_bytearry 资源文件表
![1460523540096074889.jpg d.jpg](https://i-blog.csdnimg.cn/blog_migrate/81343b473c38847ffed290f5e84343b9.jpeg)
资源表里相应的多里两条记录;
这里再提一个表 act_ge_property 属性表
![1460523588096010487.jpg e.jpg](https://i-blog.csdnimg.cn/blog_migrate/6d7fa0b87be753b24c7c07b29fa3c6a0.jpeg)
这里的next_dbid是主键策略,就是规定好了下一次生成的id就是10001;
2、查看 流程定义
-
- @Test
- public void findProcessDefinition(){
- List<ProcessDefinition> list = processEngine.getRepositoryService()
- .createProcessDefinitionQuery()
-
-
-
-
-
-
-
- .orderByProcessDefinitionVersion().asc()
-
-
-
- .list();
-
-
-
- if(list!=null && list.size()>0){
- for(ProcessDefinition pd:list){
- System.out.println("流程定义ID:"+pd.getId());
- System.out.println("流程定义的名称:"+pd.getName());
- System.out.println("流程定义的key:"+pd.getKey());
- System.out.println("流程定义的版本:"+pd.getVersion());
- System.out.println("资源名称bpmn文件:"+pd.getResourceName());
- System.out.println("资源名称png文件:"+pd.getDiagramResourceName());
- System.out.println("部署对象ID:"+pd.getDeploymentId());
- System.out.println("#########################################################");
- }
- }
- }
流程定义ID:helloworld:1:4 流程定义的名称:helloworldProcess 流程定义的key:helloworld 流程定义的版本:1 资源名称bpmn文件:diagrams/helloWorld.bpmn 资源名称png文件:diagrams/helloWorld.png 部署对象ID:1 ######################################################### 流程定义ID:helloworld:2:304 流程定义的名称:helloworldProcess 流程定义的key:helloworld 流程定义的版本:2 资源名称bpmn文件:diagrams/helloWorld.bpmn 资源名称png文件:diagrams/helloWorld.png 部署对象ID:301 ######################################################### 流程定义ID:helloworld:3:404 流程定义的名称:helloworldProcess 流程定义的key:helloworld 流程定义的版本:3 资源名称bpmn文件:helloworld.bpmn 资源名称png文件:helloworld.png 部署对象ID:401 ######################################################### |
流程定义的查询,本质的话就是通过Activiti框架提供的API对act_re_procdef进行查询操作;
可以看到流程定义的key值相同的情况下,版本是从1开始逐次升级的
流程定义的Id是【key:版本:生成ID】
说明:
1).流程定义和部署对象相关的Service都是RepositoryService。
2).创建流程定义查询对象,可以在ProcessDefinitionQuery上设置查询的相关参数
3).调用ProcessDefinitionQuery对象的list方法,执行查询,获得符合条件的流程定义列表
4).由运行结果可以看出:Key和Name的值为:bpmn文件process节点的id和name的属性值
5).key属性被用来区别不同的流程定义。
6).带有特定key的流程定义第一次部署时,version为1。之后每次部署都会在当前最高版本号上加1
7).Id的值的生成规则为:{processDefinitionKey}:{processDefinitionVersion}:{generated-id}, 这里的generated-id是一个自动生成的唯一的数字
8).重复部署一次,deploymentId的值以一定的形式变化
-
- @Test
- public void findLastVersionProcessDefinition(){
- List<ProcessDefinition> list = processEngine.getRepositoryService()
- .createProcessDefinitionQuery()
- .orderByProcessDefinitionVersion().asc()
- .list();
-
-
-
-
-
-
- Map<String, ProcessDefinition> map = new LinkedHashMap<String, ProcessDefinition>();
- if(list!=null && list.size()>0){
- for(ProcessDefinition pd:list){
- map.put(pd.getKey(), pd);
- }
- }
- List<ProcessDefinition> pdList = new ArrayList<ProcessDefinition>(map.values());
- if(pdList!=null && pdList.size()>0){
- for(ProcessDefinition pd:pdList){
- System.out.println("流程定义ID:"+pd.getId());
- System.out.println("流程定义的名称:"+pd.getName());
- System.out.println("流程定义的key:"+pd.getKey());
- System.out.println("流程定义的版本:"+pd.getVersion());
- System.out.println("资源名称bpmn文件:"+pd.getResourceName());
- System.out.println("资源名称png文件:"+pd.getDiagramResourceName());
- System.out.println("部署对象ID:"+pd.getDeploymentId());
- System.out.println("#########################################################");
- }
- }
- }
3、删除流程定义
-
- @Test
- public void deleteProcessDefinition(){
-
- String deploymentId = "601";
-
-
-
-
-
-
-
-
-
-
-
- processEngine.getRepositoryService()
- .deleteDeployment(deploymentId, true);
- System.out.println("删除成功!");
- }
说明:
1).因为删除的是流程定义,而流程定义的部署是属于仓库服务的,所以应该先得到RepositoryService
2).如果该流程定义下没有正在运行的流程,则可以用普通删除。如果是有关联的信息,用级联删除。项目开发中使用级联删除的情况比较多,删除操作一般只开放给超级管理员使用。
-
- @Test
- public void deleteProcessDefinitionByKey(){
-
- String processDefinitionKey = "helloworld";
-
- List<ProcessDefinition> list = processEngine.getRepositoryService()
- .createProcessDefinitionQuery()
- .processDefinitionKey(processDefinitionKey)
- .list();
-
- if(list!=null && list.size()>0){
- for(ProcessDefinition pd:list){
-
- String deploymentId = pd.getDeploymentId();
- processEngine.getRepositoryService()
- .deleteDeployment(deploymentId, true);
- }
- }
- }
4、查看流程图附件
查询出流程定义文档。主要查的是图片,用于显示流程用。
-
-
-
- @Test
- public void getImageById()throws Exception{
- InputStream inputStream=processEngine.getRepositoryService()
- .getResourceAsStream("10001", "helloWorld.png");
- FileUtils.copyInputStreamToFile(inputStream, new File("D:/helloWorld.png"));
- }
-
-
-
- @Test
- public void viewPic() throws IOException{
-
-
- String deploymentId = "301";
-
- List<String> list = processEngine.getRepositoryService()
- .getDeploymentResourceNames(deploymentId);
-
- String resourceName = "";
- if(list!=null && list.size()>0){
- for(String name:list){
- if(name.indexOf(".png")>=0){
- resourceName = name;
- }
- }
- }
-
-
- InputStream in = processEngine.getRepositoryService()
- .getResourceAsStream(deploymentId, resourceName);
-
-
- File file = new File("D:/"+resourceName);
-
- FileUtils.copyInputStreamToFile(in, file);
- }
说明:
1).deploymentId为流程部署ID
2).resourceName为act_ge_bytearray表中NAME_列的值
3).使用repositoryService的getDeploymentResourceNames方法可以获取指定部署下得所有文件的名称
4).使用repositoryService的getResourceAsStream方法传入部署ID和资源图片名称可以获取部署下指定名称文件的输入流
5).最后的有关IO流的操作,使用FileUtils工具的copyInputStreamToFile方法完成流程流程到文件的拷贝,将资源文件以流的形式输出到指定文件夹下
首先说下结论,流程定义是不能修改的;这里举例子,假如一个流程定义的流程实例在活动运行中。假如可以修改,本来要流转到A这个节点,因为流程定义修改了,流转到B这个节点。就不符合当时这个流程实例的初衷了;所以一般开发的话,不能修改流程定义,我们是通过增加版本号的方式。来实现“修改”的;
总结:
Deployment 部署对象
1、一次部署的多个文件的信息。对于不需要的流程可以删除和修改。
2、对应的表:
act_re_deployment:部署对象表
act_re_procdef:流程定义表
act_ge_bytearray:资源文件表
act_ge_property:主键生成策略表
ProcessDefinition 流程定义
1、解析.bpmn后得到的流程定义规则的信息,工作流系统就是按照流程定义的规则执行的。
文章转自《http://blog.csdn.net/oChangWen/article/details/51909059》,多谢作者分享!