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"));
    }
}