深入了解Activiti工作流流程定义

深入了解Activiti工作流流程定义

2016-03-27| 发布: | 浏览: 2363 |保存PDF

部署流程定义

部署流程定义的流程：

1. 先获取流程引擎对象：在创建时会自动加载 classpath 下的 activiti.cfg.xml

2. 首先获得默认的流程引擎，通过流程引擎获取了一个 RepositoryService 对象（仓库对象）

3. 由仓库的服务对象产生一个部署对象配置对象，用来封装部署操作的相关配置。

4. 这是一个链式编程，在部署配置对象中设置显示名，上传流程定义规则文件

5. 向数据库表中存放流程定义的规则信息。

部署流程定义加载资源文件有两种方式

1、从 classpath 路径加载文件

deploymentBuilder.addClasspathResource("diagrams/hello.bpmn");

deploymentBuilder.addClasspathResource("diagrams/hello.png");

2、使用 zip 的输入流用作部署流程定义

InputStream in = this.getClass().getClassLoader().getResourceAsStream("diagrams/hello.zip");

ZipInputStream zipInputStream = new ZipInputStream(in);

deploymentBuilder.addZipInputStream(zipInputStream);

注：打zip包的时候，不要有文件夹，直接对bpmn和png文件打包

示例：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27

@Test public void testDeploy() {     /**      * RepositoryService是Activiti的仓库服务类,流程定义和部署对象相关的Service      * 所谓的仓库指流程定义文档的两个文件：bpmn文件和流程图片      */     RepositoryService repositoryService = processEngine.getRepositoryService();     // 创建一个部署对象DeploymentBuilder，用来定义流程部署的相关参数     DeploymentBuilder deploymentBuilder = repositoryService.createDeployment();     // 添加部署的名称     deploymentBuilder.name("流程定义");        // 第一种方式：添加hello.bpmn和hello.png //        deploymentBuilder.addClasspathResource("diagrams/hello.bpmn"); //        deploymentBuilder.addClasspathResource("diagrams/hello.png");    //        // 第二种方式：通用zip文件     InputStream in = this.getClass().getClassLoader().getResourceAsStream("diagrams/hello.zip");     ZipInputStream zipInputStream = new ZipInputStream(in);     deploymentBuilder.addZipInputStream(zipInputStream);        // 部署流程定义     Deployment deployment = deploymentBuilder.deploy();        System.out.println("部署ID：" + deployment.getId());// 1     System.out.println("部署名称：" + deployment.getName());// activiti入门程序 }

部署流程定义操作的数据表

1、act_re_deployment （部署对象表）

存放流程定义的显示名和部署时间，每部署一次增加一条记录 

2、 act_re_procdef（流程定义表）

存放流程定义的属性信息，部署每个新的流程定义都会在这张表中增加一条记录。

注意：当流程定义的 key 相同的情况下，使用的是版本升级

3、 act_ge_bytearray（资源文件表）

存储流程定义相关的部署信息。即流程定义文档的存放地。每部署一次就会增加两条记录，一条是关于 bpmn 规则文件的，一条是图片的（如果部署时只指定了 bpmn 一个文件， activiti 会在部署时解析 bpmn 文件内容自动生成流程图）。两个文件不是很大，都是以二进制形

式存储在数据库中。 

4、act_ge_property（主键生成策略表）

查看流程定义

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 是一个自动生成的唯一的数字，由act_ge_property表生成的 next.dbid维护

8. 重复部署一次， deploymentId 的值以一定的形式变化

 

示例：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36

/** 查询流程定义 */ @Test public void processDefinitionQueryTest() {     RepositoryService service = processEngine.getRepositoryService();     /**      * 创建一个流程定义的查询      * .list();返回一个集合 .singleResult();//返回惟一结果集      * .count();//返回结果集数量      * .listPage(firstResult, maxResults);//分页查询      */     ProcessDefinitionQuery pdq = service.createProcessDefinitionQuery();     // pdq.deploymentId(deploymentId)//使用部署对象ID查询     // pdq.processDefinitionId(processDefinitionId)//使用流程定义ID查询     // pdq.processDefinitionKey(processDefinitionKey)//使用流程定义的key查询     // pdq.processDefinitionNameLike(processDefinitionNameLike)//使用流程定义的名称模糊查询     pdq.orderByProcessDefinitionVersion().asc();// 按照版本的升序排列     // pdq.orderByProcessDefinitionName().desc()//按照流程定义的名称降序排列     List<ProcessDefinition> list = pdq.list();        if (list != null && list.size() > 0) {         for (ProcessDefinition pd : list) {             // 流程定义的key+版本+随机生成数             System.out.println("流程定义ID:" + pd.getId());             // 对应hello.bpmn文件中的name属性值             System.out.println("流程定义的名称:" + pd.getName());             // 对应hello.bpmn文件中的id属性值             System.out.println("流程定义的key:" + pd.getKey());             // 当流程定义的key值相同的相同下，版本升级，默认1             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("############################");         }     } }

删除流程定义

因为删除的是流程定义，而流程定义的部署是属于仓库服务的，所以应该先得到 RepositoryService

如果该流程定义下没有正在运行的流程，则可以用普通删除。如果是有关联的信息，用级联删除。项目开发中使用级联删除的情况比较多，删除操作一般只开放给超级管理员使用。

示例：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

/** 删除流程定义 */ @Test public void deleteProcessDefinition() {     // 使用部署ID，完成删除     String deploymentId = "15001";        //不带级联的删除 只能删除没有启动的流程，如果流程启动，就会抛出异常     // processEngine.getRepositoryService().deleteDeployment(deploymentId);        /**      * 级联删除 不管流程是否启动，都能可以删除      */     processEngine.getRepositoryService().deleteDeployment(deploymentId, true);     System.out.println("删除成功！"); }

获取流程定义文档的资源（查看流程图附件）

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

1、deploymentId 为流程部署 ID

2、resourceName 为 act_ge_bytearray 表中 NAME_ 列的值

3、使用 repositoryService 的 getDeploymentResourceNames 方法可以获取指定部署下得所有文件的名称

4、使用 repositoryService 的 getResourceAsStream 方法传入部署 ID 和资源图片名称可以获取部署下指定名称文件的输入流

5、最后的有关 IO 流的操作，使用 FileUtils 工具的 copyInputStreamToFile 方法完成流程流程到文件的拷贝，将资源文件以流的形式输出到指定文件夹下

 

示例：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27

/** 查看流程图 */ @Test public void viewPic() throws IOException {     RepositoryService service = processEngine.getRepositoryService();     /** 将生成图片放到文件夹下 */     String deploymentId = "1";     // 获取图片资源名称     List<String> list = service.getDeploymentResourceNames(deploymentId);        // 定义图片资源的名称     String resourceName = "";     if (list != null && list.size() > 0) {         for (String name : list) {             if (name.indexOf(".png") >= 0) {                 resourceName = name;             }         }     }        // 获取图片的输入流     InputStream in = service.getResourceAsStream(deploymentId, resourceName);        // 将图片生成到D盘的目录下     File file = new File("D:/" + resourceName);     // 将输入流的图片写到D盘下     FileUtils.copyInputStreamToFile(in, file); }

查询最新版本的流程定义

查询的思路：

1、使用流程定义的版本升序排列 

2、创建LinkedHashMap<String, ProcessDefinition>，对相同key的进行覆盖

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33

/***查询最新版本的流程定义*/ @Test public void findLastVersionProcessDefinition() {     List<ProcessDefinition> list = processEngine.getRepositoryService()             .createProcessDefinitionQuery()//             .orderByProcessDefinitionVersion().asc()// 使用流程定义的版本升序排列             .list();     /**      * Map<String,ProcessDefinition>      * map集合的key：流程定义的key      * map集合的value：流程定义的对象      * map集合的特点：当map集合key值相同的情况下，后一次的值将替换前一次的值      */     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("#########################################");         }     } }

删除key相同的所有不同版本的流程定义

思路：把所有相同key的流程定义查出来，然后遍历删除

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

/**删除流程定义（删除key相同的所有不同版本的流程定义）*/ @Test public void deleteProcessDefinitionByKey() {     // 流程定义的key     String processDefinitionKey = "hello";     // 先使用流程定义的key查询流程定义，查询出所有的版本     List<ProcessDefinition> list = processEngine.getRepositoryService()//             .createProcessDefinitionQuery()//             .processDefinitionKey(processDefinitionKey)// 使用流程定义的key查询             .list();     // 遍历，获取每个流程定义的部署ID     if (list != null && list.size() > 0) {         for (ProcessDefinition pd : list) {             // 获取部署ID             String deploymentId = pd.getDeploymentId();             processEngine.getRepositoryService()//                     .deleteDeployment(deploymentId, true);         }     } }