Activiti（七）：管理流程定义（流程定义部署ZIP/classpath）、查看（获取流程定义图图片）、删除，不能修改

原文链接

一、部署流程定义

    前面的话，我们使用的是classpath加载资源文件方式来部署流程定义的，但是这种方式有局限性，只能适合小项目，固定写死的流程；

    实际项目的话，需要来动态导入流程定义文件，通过把bpmn和png文件打包成zip压缩包，然后用户界面直接导入到系统，然后解析，部署流程定义；Activiti是支持这种方式的。今天我们来实现下这种方式；

首先第一步 ，把bpmn和png文件打成zip压缩包，放到diagrams文件夹下；

前面我们使用的是classpath加载流程定义文件；我们新建一个测试类 ProcessDefinition

[java]  view plain  copy

1. package com.java1234.activiti.test;  
2.    
3. import org.activiti.engine.ProcessEngine;  
4. import org.activiti.engine.ProcessEngines;  
5. import org.activiti.engine.repository.Deployment;  
6. import org.junit.Test;  
7.    
8. public class ProcessDefinition {  
9.    
10.     /** 
11.      * 获取默认的流程引擎实例 会自动读取activiti.cfg.xml文件  
12.      */  
13.     private ProcessEngine processEngine=ProcessEngines.getDefaultProcessEngine();  
14.        
15.     /** 
16.      * 部署流程定义使用classpath方式 
17.      */  
18.     @Test  
19.     public void deployWithClassPath(){  
20.         // 获取部署对象  
21.         Deployment deployment=processEngine.getRepositoryService() // 部署Service  
22.                      .createDeployment()  // 创建部署  
23.                      .addClasspathResource("diagrams/helloWorld.bpmn")  // 加载资源文件  
24.                      .addClasspathResource("diagrams/helloWorld.png")   // 加载资源文件  
25.                      .name("HelloWorld流程")  // 流程名称  
26.                      .deploy(); // 部署  
27.         System.out.println("流程部署ID:"+deployment.getId());  
28.         System.out.println("流程部署Name:"+deployment.getName());  
29.     }  
30.        
31. }  

这一步在数据库中将操作三张表：
  a).act_re_deployment（部署对象表）
    存放流程定义的显示名和部署时间，每部署一次增加一条记录
  b).act_re_procdef（流程定义表）
    存放流程定义的属性信息，部署每个新的流程定义都会在这张表中增加一条记录。
    注意：当流程定义的key相同的情况下，使用的是版本升级
  c).act_ge_bytearray（资源文件表）
    存储流程定义相关的部署信息。即流程定义文档的存放地。每部署一次就会增加两条记录，一条是关于bpmn规则文件的，一条是图片的（如果部署时只指定了bpmn一个文件，activiti会在部署时解析bpmn文件内容自动生成流程图）。两个文件不是很大，都是以二进制形式存储在数据库中。

下面我们用zip方式来实现，新建一个deployWithZip方法：

[java]  view plain  copy

1. /** 
2.  * 部署流程定义使用zip方式 
3.  */  
4. @Test  
5. public void deployWithZip(){  
6.     InputStream inputStream=this.getClass()  // 获取当前class对象  
7.                         .getClassLoader()   // 获取类加载器  
8.                         .getResourceAsStream("diagrams/helloWorld.zip"); // 获取指定文件资源流  
9.     ZipInputStream zipInputStream=new ZipInputStream(inputStream); // 实例化zip输入流对象  
10.     // 获取部署对象  
11.     Deployment deployment=processEngine.getRepositoryService() // 部署Service  
12.                  .createDeployment()  // 创建部署  
13.                  .name("HelloWorld流程2")  // 流程名称  
14.                  .addZipInputStream(zipInputStream)  // 添加zip是输入流  
15.                  .deploy(); // 部署  
16.     System.out.println("流程部署ID:"+deployment.getId());  
17.     System.out.println("流程部署Name:"+deployment.getName());  
18. }  

我们运行这个测试类：

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 流程定义部署表：

我们会发现，这里多了一条记录；

act_re_procdef 流程定义表

流程定义表里，我们发现VERSION_字段 版本升级了，KEY依然是一样的；

act_ge_bytearry 资源文件表

资源表里相应的多里两条记录；

这里再提一个表 act_ge_property 属性表

这里的next_dbid是主键策略，就是规定好了下一次生成的id就是10001；

2、查看 流程定义

[java]  view plain  copy

1.     /**查询流程定义*/    
2.     @Test    
3.     public void findProcessDefinition(){    
4.         List<ProcessDefinition> list = processEngine.getRepositoryService()//与流程定义和部署对象相关的Service    
5.                         .createProcessDefinitionQuery()//创建一个流程定义的查询    
6.                         /**指定查询条件,where条件*/    
7. //                      .deploymentId(deploymentId)//使用部署对象ID查询    
8. //                      .processDefinitionId(processDefinitionId)//使用流程定义ID查询    
9. //                      .processDefinitionKey(processDefinitionKey)//使用流程定义的key查询    
10. //                      .processDefinitionNameLike(processDefinitionNameLike)//使用流程定义的名称模糊查询    
11.                             
12.                         /**排序*/    
13.                         .orderByProcessDefinitionVersion().asc()//按照版本的升序排列    
14. //                      .orderByProcessDefinitionName().desc()//按照流程定义的名称降序排列    
15.                             
16.                         /**返回的结果集*/    
17.                         .list();//返回一个集合列表，封装流程定义    
18. //                      .singleResult();//返回惟一结果集    
19. //                      .count();//返回结果集数量    
20. //                      .listPage(firstResult, maxResults);//分页查询    
21.         if(list!=null && list.size()>0){    
22.             for(ProcessDefinition pd:list){    
23.                 System.out.println("流程定义ID:"+pd.getId());//流程定义的key+版本+随机生成数    
24.                 System.out.println("流程定义的名称:"+pd.getName());//对应helloworld.bpmn文件中的name属性值    
25.                 System.out.println("流程定义的key:"+pd.getKey());//对应helloworld.bpmn文件中的id属性值    
26.                 System.out.println("流程定义的版本:"+pd.getVersion());//当流程定义的key值相同的相同下，版本升级，默认1    
27.                 System.out.println("资源名称bpmn文件:"+pd.getResourceName());    
28.                 System.out.println("资源名称png文件:"+pd.getDiagramResourceName());    
29.                 System.out.println("部署对象ID："+pd.getDeploymentId());    
30.                 System.out.println("#########################################################");    
31.             }    
32.         }               
33.     }    

流程定义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的值以一定的形式变化

[java]  view plain  copy

1. /***附加功能：查询最新版本的流程定义*/    
2. @Test    
3. public void findLastVersionProcessDefinition(){    
4.     List<ProcessDefinition> list = processEngine.getRepositoryService()//    
5.                     .createProcessDefinitionQuery()//    
6.                     .orderByProcessDefinitionVersion().asc()//使用流程定义的版本升序排列（可能存在多个集合）    
7.                     .list();    
8.     /**  
9.      * Map<String,ProcessDefinition>  
10.      * map集合的key：流程定义的key  
11.      * map集合的value：流程定义的对象  
12.      * map集合的特点：当map集合key值相同的情况下，后一次的值将替换前一次的值  
13.      */    
14.     Map<String, ProcessDefinition> map = new LinkedHashMap<String, ProcessDefinition>();    
15.     if(list!=null && list.size()>0){    
16.         for(ProcessDefinition pd:list){    
17.             map.put(pd.getKey(), pd);    
18.         }    
19.     }    
20.     List<ProcessDefinition> pdList = new ArrayList<ProcessDefinition>(map.values());    
21.     if(pdList!=null && pdList.size()>0){    
22.         for(ProcessDefinition pd:pdList){    
23.             System.out.println("流程定义ID:"+pd.getId());//流程定义的key+版本+随机生成数    
24.             System.out.println("流程定义的名称:"+pd.getName());//对应helloworld.bpmn文件中的name属性值    
25.             System.out.println("流程定义的key:"+pd.getKey());//对应helloworld.bpmn文件中的id属性值    
26.             System.out.println("流程定义的版本:"+pd.getVersion());//当流程定义的key值相同的相同下，版本升级，默认1    
27.             System.out.println("资源名称bpmn文件:"+pd.getResourceName());    
28.             System.out.println("资源名称png文件:"+pd.getDiagramResourceName());    
29.             System.out.println("部署对象ID："+pd.getDeploymentId());    
30.             System.out.println("#########################################################");    
31.         }    
32.     }       
33. }    

3、删除流程定义

[java]  view plain  copy

1.     /**删除流程定义*/  
2.     @Test  
3.     public void deleteProcessDefinition(){  
4.         //使用部署ID，完成删除  
5.         String deploymentId = "601";  
6.         /** 
7.          * 不带级联的删除 
8.          *    只能删除没有启动的流程，如果流程启动，就会抛出异常 
9.          */  
10. //      processEngine.getRepositoryService()//  
11. //                      .deleteDeployment(deploymentId);  
12.           
13.         /** 
14.          * 级联删除 
15.          *    不管流程是否启动，都能可以删除 
16.          */  
17.         processEngine.getRepositoryService()//  
18.                         .deleteDeployment(deploymentId, true);  
19.         System.out.println("删除成功！");  
20.     }  

说明：
  1).因为删除的是流程定义，而流程定义的部署是属于仓库服务的，所以应该先得到RepositoryService
  2).如果该流程定义下没有正在运行的流程，则可以用普通删除。如果是有关联的信息，用级联删除。项目开发中使用级联删除的情况比较多，删除操作一般只开放给超级管理员使用。

[java]  view plain  copy

1. /**附加功能：删除流程定义（删除key相同的所有不同版本的流程定义）*/  
2. @Test  
3. public void deleteProcessDefinitionByKey(){  
4.     //流程定义的key  
5.     String processDefinitionKey = "helloworld";  
6.     //先使用流程定义的key查询流程定义，查询出所有的版本  
7.     List<ProcessDefinition> list = processEngine.getRepositoryService()//  
8.                     .createProcessDefinitionQuery()//  
9.                     .processDefinitionKey(processDefinitionKey)//使用流程定义的key查询  
10.                     .list();  
11.     //遍历，获取每个流程定义的部署ID  
12.     if(list!=null && list.size()>0){  
13.         for(ProcessDefinition pd:list){  
14.             //获取部署ID  
15.             String deploymentId = pd.getDeploymentId();  
16.             processEngine.getRepositoryService()//  
17.                         .deleteDeployment(deploymentId, true);  
18.         }  
19.     }  
20. }  

4、查看流程图附件

  查询出流程定义文档。主要查的是图片，用于显示流程用。

[java]  view plain  copy

1. /** 
2.  * 通过流程部署ID获取流程图图片 
3.  */  
4. @Test  
5. public void getImageById()throws Exception{  
6.     InputStream inputStream=processEngine.getRepositoryService()  
7.         .getResourceAsStream("10001", "helloWorld.png"); // 根据流程部署ID和资源名称获取输入流  
8.     FileUtils.copyInputStreamToFile(inputStream, new File("D:/helloWorld.png"));  
9. }  
10.   
11.     /**查看流程图 
12.      * @throws IOException */  
13.     @Test  
14.     public void viewPic() throws IOException{  
15.         /**将生成图片放到文件夹下*/  
16.         //部署Id  
17.         String deploymentId = "301";  
18.         //获取图片资源名称  
19.         List<String> list = processEngine.getRepositoryService()//  
20.                         .getDeploymentResourceNames(deploymentId);  
21.         //定义图片资源的名称  
22.         String resourceName = "";  
23.         if(list!=null && list.size()>0){  
24.             for(String name:list){  
25.                 if(name.indexOf(".png")>=0){  
26.                     resourceName = name;  
27.                 }  
28.             }  
29.         }  
30.                   
31.         //获取图片的输入流  
32.         InputStream in = processEngine.getRepositoryService()//  
33.                         .getResourceAsStream(deploymentId, resourceName);  
34.           
35.         //将图片生成到D盘的目录下  
36.         File file = new File("D:/"+resourceName);  
37.         //将输入流的图片写到D盘下  
38.         FileUtils.copyInputStreamToFile(in, file);  
39.     }  

说明：
  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后得到的流程定义规则的信息，工作流系统就是按照流程定义的规则执行的。