activiti6.0实战--部署流程资源

activiti实战--部署流程资源

流程资源可以是各种类型的文件,在启动流程或流程实例运行过程中会被读取
一、常用流程资源
流程定义文件:扩展名为bpmn20.xml和bpmn
流程定义的图片:用BPMN2.0规范的各种图形描绘,一般用png格式
表单文件:把表单内容保存在一个扩展名为form的文件中
规则文件:例如Dro'o'ls的规则文件,扩展名为drl
二、部署流程资源涉及到的表
  • act_re_deployment(部署对象表)
存放流程定义的显示名和部署时间,每部署一次增加一条记录
  • act_re_procdef(流程定义表)
存放流程定义的属性信息,部署每个新的流程定义都会在这张表中增加一条记录。注意:当流程定义的key相同的情况下,使用的是版本升级。
  • act_ge_bytearray(资源文件表)
存储流程定义相关的部署信息。即流程定义文档的存放地。每部署一次就会增加两条记录,一条是关于bpmn规则文件的,一条是图片的(如果部署时只指定了bpmn一个文件, activiti会在部署时解析bpmn文件内容自动生成流程图)。两个文件不是很大,都是以二进制形式存储在数据库中
三、部署流程资源方式
使用流程引擎的目的是为了使用流程驱动业务的流转。要用流程驱动业务就必须为业务启动一个流程实例,启动一个流程实例必须定义一系列活动,这一系列活动就组成了一个流程定义
  • classpath方式部署流程资源
classpath方式,顾名思义就是要以class目录为基础寻找对应的资源再部署
//获取repositoryService RepositoryService repositoryService = processEngine.getRepositoryService(); //定义classpath String processPath = "process/2-4.bpmn20.xml"; //创建部署构建器---->部署入口 DeploymentBuilder deploymentBuilder = repositoryService.createDeployment(); //添加流程资源文件 deploymentBuilder.addClasspathResource(processPath).deploy(); //执行部署。此操作会将流程定义文件内容持久化到数据库,并且以addClassPathResouce(resourceName)的参数作为资源名称 Deployment deploy = deploymentBuilder.deploy(); //获取部署的流程 ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery().deploymentId(deploy.getId()).singleResult();

classpath方式一般用于开发阶段的测试环节,真正再产品环境中用的很少,而是通过管理界面手动部署或在设计完流程之后直接部署到引擎中
  • InputStream 方式部署流程资源
使用InputStream 方式部署流程资源需要传入一个输入流及资源的名称,输入流的来源不限,可以从classpath,可以从绝对路径,亦可以从网络
RepositoryService repositoryService = processEngine.getRepositoryService(); String filePath = "E:\\activitistudy\\acticitiDemo1\\src\\main\\resources\\process\\2-4.bpmn20.xml"; //创建文本输入对象 FileInputStream fileInputStream = new FileInputStream(filePath); //创建部署构建器 DeploymentBuilder deployment = repositoryService.createDeployment(); //参数一作为资源名称,参数二为流程资源输入流 Deployment deploy = deployment.addInputStream("2-4bpmn", fileInputStream).deploy(); System.out.println(deploy.getId()); ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery().deploymentId(deploy.getId()).singleResult(); System.out.println(processDefinition.getResourceName());

InputStream 方式从产品环境中用的比较多,例如从WEB客户端接受一个文件对象部署到引擎中,或者从URL读取文件流后部署到引擎
  • zip/bar格式压缩包方式部署流程
以上方式一次只能部署单个流程、除非多次调用deployment.addXXX(),那么如何一次性部署多个流程资源呢?activiti 允许把一批资源打包部署
RepositoryService repositoryService = processEngine.getRepositoryService(); //从class读取zip资源文件流 InputStream resourceAsStream = getClass().getClassLoader().getResourceAsStream("resources.zip"); DeploymentBuilder deployment = repositoryService.createDeployment(); Deployment deploy = deployment.addZipInputStream(new ZipInputStream(resourceAsStream)).deploy(); System.out.println(repositoryService.createProcessDefinitionQuery().count());

- Bpmn模型方式 【activiti6.0实战--部署流程资源】见BPMN的使用
四、以上部署方式使用建议
  1. 如果客户端需要开发一套流程设计器建议使用addBpmnModel方式部署,该方式更加灵活,可塑性强
  2. 如果一次性需要部署多个流程资源,建议使用addZipInputStream方式。该方式常见的场景时,在web项目中使用文件上传的方式对流程资源进行部署。
  3. addClassPahResource方式不建议在生产环境中使用,使用该方式会使流程文档与项目高耦合,不灵活。

    推荐阅读