2017.2.28 activiti实战--第五章--用户与组及部署管理（二）部署流程资源

学习资料：《Activiti实战》

第五章 用户与组及部署管理（二）部署流程资源

内容概览：讲解流程资源的读取与部署。

5.2 部署流程资源

5.2.1 流程资源

流程资源常用的有以下几种：

 流程定义文件：拓展名为bpmn20.xml和bpmn
 流程定义的图片：拓展名为PNG
 表单文件：拓展名为form
 规则文件：拓展名为drl

部署流程资源的时候，要注意一点：

引擎会根据不同的拓展名进行不同的处理。bpmn或bpmn20.xml类型的文件，会在ACT_RU_PROCDEF（流程定义表）、ACT_GE_BYTEARRAY（字节流表）两个表中都插入一条数据。而png类型的文件，只会在ACT_GE_BYTEARRAY表中插入一条数据。

所以可以看到，下文中所有部署，assertEquals（int，processDefinitionQuery）中的int都没有包含png的数目在内。

5.2.2 部署流程资源

启动一个流程实例processInstance，需要首先部署流程定义processDefinition，流程定义由许多活动Activity组成。

部署流程定义的方法有很多种，包括：

 classpath方式：addClasspathResource（）
 InputStream方式：addInputStream（）
 字符串方式：addString（）
 zip/bar方式：addZipInputStream（）

（1）classpath方式

一般用在测试环节，真实的产品环境中很少用到这种方式。一般是管理页面手动部署或者设计完流程后直接部署到engine中。

项目中资源文件存放的位置：

示例代码（为了方便说明，没有使用链式编程，而是把每一步都分开写了）：

 public class ClasspathDeploymentTest extends AbstractTest{
     @Test
     public void testClasspathDeployment throws Exception(){
         String bpmnClasspath = "chapter5/candidateUserInUserTask.bpmn";
         String pngClasspath = "chapter5/candidateUserInUserTask.bng";

         DeploymentBuilder db = repositoryService.createDeployment();
         db.addClasspathResource(bpmnClasspath);
         db.addClasspathResource(pngClasspath);
         db.deploy();

         //验证部署是否成功
         ProcessDefinitionQuery pdq = repositoryService.createProcessDefinitionQuery();
         long count = pdq.processDefinitionKey("candidateUserInUserTask").count;
         assertEquals(1,count);

         //读取图片文件
         ProcessDefinition pd = ProcessDefinitionQuery.singleResult();
         String diagramResourceName = pd.getDiagramResourceName();
         assertEquals(pngClasspath,diagramResourceName);
     }
 }

（2）InputStream方式

InputStream方式在产品环境中用的比较多，比如从web客户端接受一个文件对象，或者从URL中获取文件流，最后部署到engine中。

InputStream方式需要传入一个输入流及资源的名称。输入流的来源不限，可以是绝对路径，可以是classpath，可以是网络获取。

（从绝对路径获取）示例代码：

 public class InputStreamDeploymentTest extends AbstractTest{
     @Test
     public void testInputStreamFromAbsoluteFilePath() throws Exception{
         String filePath = "/Users/henryyan/work/books/aia-books/aia-codes/bpmn20-example/src/test/
         resources/chapter5/userAndGroupInUserTask.bpmn";

         FileInputStream fis = new FileInputStream(filePath);
         repositoryService.createDeployment()
             .addInputStream("userAndGroupInUserTask.bpmn",fis)
             .deploy();//用userAndGroupInUserTask.bpmn作为资源名称

         //验证部署是否成功
         ProcessDefinitionQuery pdq = repositoryService.createProcessDefinitionQuery();
         long count = pdq.processDefinitionKey("userAndGroupInUserTask").count;
         assertEquals(1,count);
     }
 }

（3）字符串方式

字符串方式是直接传入纯文本作为资源的来源。

示例代码：

 public class StringDeploymentTest extends AbstractTest{
     //完整的text内容略
     private String text = "<?xml version=\"1.0\" encoding=\"UTF-8\"?><definitions>...</definitions>";

     @Test
     public void testCharsDeployment(){//用candidateUserInUserTask.bpmn作为资源名称
         repositoryService.createDeployment().addString("candidateUserInUserTask.bpmn",text).deploy();

         //验证部署是否成功
         ProcessDefinitionQuery pdq = repositoryService.createProcessDefinitionQuery();
         long count = pdq.processDefinitionKey("candidateUserInUserTask").count;
         assertEquals(1,count);
     }
 }

（4）zip/bar格式压缩包方式

前面三种方式一次都只能部署一个资源。除非执行多次deployment.addXXX()方法。

zip/bar方式，允许用户将资源打包，一次性部署多个资源。这几个资源关联的部署ID相同，因为属于同一次部署。

将文件打包为bar或者zip均可：

示例代码：

这里的addZipInputStream（）相当于for循环了n次addInputStream（）。

且这四个资源关联的是同一个deploymentID。

 public class ZipStreamDeploymentTest extends AbstractTest{
     @Test
     public class testZipStreamFromAbsoluteFilePath(){
         InputStream zipStream = getClass().getClassLoader().getResourceAsStream("chapter5/chapter5-deployment.bar");
         repositoryService.createDeployment().addZipInputStream(new ZipInputStream(zipStream)).deploy();

         //验证部署是否成功
         long count = repositoryService.createProcessDefinitionQuery().count();
         assertEquals(2,count);//注意，不是4！！！

         //查询部署记录
         Deployment deployment = repositoryService.createDeploymentQuery().singleResult();
         assertNotNull(deployment);

         //验证四个文件均部署成功，且属于同一个部署ID
         String deploymentID = deployment.getId();
         assertNotNull(repositoryService.getResourceAsStream(deploymentID,"candidateUserInUserTask.bpmn"));
         assertNotNull(repositoryService.getResourceAsStream(deploymentID,"candidateUserInUserTask.png"));
         assertNotNull(repositoryService.getResourceAsStream(deploymentID,"userAndGroupInUserTask.bpmn"));
         assertNotNull(repositoryService.getResourceAsStream(deploymentID,"userAndGroupInUserTask.png"));
     }
 }