Activiti流程定义部署、删除

1、部署流程定义

  部署流程定义也可以认为是增加流程定义。

   首先创建流程引擎对象(公用的方法)

   private ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
 
  方法1:
  /**
   * 1.发布流程
   * 会在三张表中产生数据:
   * act_ge_bytearray 产生两条数据
   * act_re_deployment 产生一条数据
   * act_re_procdef 产生一条数据
   */
 public void deploy() throws Exception {
  // 获取仓库服务
  RepositoryService repositoryService = processEngine.getRepositoryService();
  // 创建发布配置对象
  DeploymentBuilder builder = repositoryService.createDeployment();
  // 设置发布信息
  builder
  .name("请假流程")// 添加部署规则的显示别名
  .addClasspathResource("diagrams/Leave2.bpmn")// 添加规则文件
  .addClasspathResource("diagrams/Leave2.png");// 添加规则图片  不添加会自动产生一个图片不推荐
  // 完成发布
  builder.deploy();
 }

 

  方法2:

 public void deployZIP() throws Exception {
  // 获取仓库服务
  RepositoryService repositoryService = processEngine.getRepositoryService();
  // 创建发布配置对象
  DeploymentBuilder builder = repositoryService.createDeployment();
  // 获得上传文件的输入流程
  InputStream in = this.getClass().getClassLoader().getResourceAsStream("diagrams/diagrams.zip");
  ZipInputStream zipInputStream = new ZipInputStream(in);
  // 设置发布信息
  builder
  .name("请假流程")// 添加部署规则的显示别名
  .addZipInputStream(zipInputStream );
  // 完成发布
  builder.deploy();
 }

 说明:

  1)     首先获得默认的流程引擎,在创建时会自动加载classpath下得activiti.cfg.xml

  2)     通过流程引擎获取了一个RepositoryService对象->仓库服务对象

  3)     由仓库的服务对象产生一个部署对象配置对象,用来封装部署环境的相关配置。

  4)     这是一个链式编程,在部署配置对象中设置显示名,上传规则文件相对classpath的地址。

  5)     部署,也是往数据库中存储流程定义的过程。

  6)     这一步在数据库中将操作三张表:

    a)     act_re_deployment

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

    b)     act_re_procdef

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

    c)     act_ge_bytearray

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

 

2、删除流程

  删除部署到activiti中的流程定义。

 public void delDeployment() throws Exception {
  // 获取仓库服务对象
  RepositoryService repositoryService = processEngine.getRepositoryService();
  // 删除发布信息
  String deploymentId = "1";
  // 普通删除,如果当前规则下有正在执行的流程,则抛异常
  repositoryService.deleteDeployment(deploymentId);
  // 级联删除,会删除和当前规则相关的所有信息,包括历史
  repositoryService.deleteDeployment(deploymentId, true);
 }

 说明:

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

  2)     如果该流程定义下没有正在运行的流程,则可以用普通删除。如果是有关联的信息,用级联删除。一般情况下用普通删除就可以。由于级联删除涉及的数据比较多,一般只开放给超级管理员使用。

 

3、查看流程定义

 /**
   * 查看流程定义
   * 流程定义 ProcessDefinition
   * id : {key}:{version}:{随机值}
   * name : 对应流程文件process节点的name属性
   * key : 对应流程文件process节点的id属性
   * version : 发布时自动生成的。如果是第一发布的流程,veresion默认从1开始;如果当前流程引擎中已存在相同key的流程,则找到当前key对应的最高版本号,在最高版本号上加1
   */public void queryProcessDefinition() throws Exception {
  // 获取仓库服务对象
  RepositoryService repositoryService = processEngine.getRepositoryService();
  // 获取流程定义查询对象
  ProcessDefinitionQuery processDefinitionQuery = repositoryService.createProcessDefinitionQuery();
  // 配置查询对象
  processDefinitionQuery
      //添加过滤条件
//     .processDefinitionName(processDefinitionName)
//     .processDefinitionId(processDefinitionId)
//     .processDefinitionKey(processDefinitionKey)
     //分页条件
//     .listPage(firstResult, maxResults)
      //排序条件
     .orderByProcessDefinitionVersion().desc();
  /**
   * 执行查询
   * list : 执行后返回一个集合
   * singelResult 执行后,首先检测结果长度是否为1,如果为一则返回第一条数据;如果不唯一,抛出异常
   * count: 统计符合条件的结果数量
   */
  List<ProcessDefinition> pds = processDefinitionQuery.list();
  // 遍历集合,查看内容
  for (ProcessDefinition pd : pds) {
   System.out.print("id:" + pd.getId() +",");
   System.out.print("name:" + pd.getName() +",");
   System.out.print("key:" + pd.getKey() +",");
   System.out.println("version:" + pd.getVersion());
  }
 }

 说明:

  1)     因为流程定义的信息存放在仓库中,所以应该获取RepositoryService。

  2)     创建流程定义查询对象,可以在ProcessDefinitionQuery上设置查询过滤参数

  3)     调用ProcessDefinitionQuery对象的list方法,执行查询,获得符合条件的流程定义列表

  4)     由运行结果可以看出:

    a)     Key和Name的值为:bpmn文件process节点的id和name的属性值

    b)     key属性被用来区别不同的流程定义。

    c)     带有特定key的流程定义第一次部署时,version为1。之后每次部署都会在当前最高版本号上加1

    d)     Id的值的生成规则为:{processDefinitionKey}:{processDefinitionVersion}:{generated-id}, 这里的generated-id是一个自动生成的唯一的数字

    e)     重复部署一次,deploymentId的值以一定的形式变化

    f)      流程定义(ProcessDefinition)在数据库中没有相应的表对应,只是从act_ge_bytearray表中取出相应的bpmn和png图片,并进行解析。

 

posted @ 2014-07-30 09:24  长夏已尽  阅读(11356)  评论(1编辑  收藏  举报