JBPM流程部署之流程实例迁移

JBPM流程部署之流程实例迁移

       前面我们已经学习了JBPM的流程版本升级，流程版本升级给我们带来了一个新的问题，那就是流程实例迁移;那么什么是流程实例的迁移呢？流程实例的迁移就是在流程发布的时候进行了版本升级，这个时候如果我们让已经运行的同一个流程的实例，按照新版本的流程定义来流转。流程实例的迁移是一件比较复杂的事情，今天我们就简单的来了解一下JBPM中流程实例迁移的使用，后续我们就简单的介绍一下相应的设计思路和扩展。

       默认情况下，JBPM为我们提供了两种启动流程实例的方式    

   ProcessInstance processInstance = executionService.startProcessInstanceByKey("AsyncFork");

      这种方式会根据流程的pdkey来查找该流程的最新版本进行启动，这样可以保证在我们在任何时候启动的都是当前流程的最新版本      

   ProcessInstance processInstance = executionService.startProcessInstanceById("AsyncFork-1");

      这种方式是根据流程的pdid来启动给定版本的流程，这样可以我们可以启动该流程的任何版本

      如果您对流程定义的属性pdkey和pdid不是很清楚，请阅读我先前的文章JBPM流程部署之流程版本升级

      虽然JBPM为我们提供了启动流程实例的两个方法，是我们可以方便的启动最新版本、任意版本的流程，但是默认情况下，已经启动的流程实例在整个生命周期内，都会一直使用同一个版本的流程定义，即使有新的版本发布，也不会使用新的版本。但是现实中，有很多的时候我们需要定制流程实例是否迁移。今天我们就结合下边的这个流程定义来看一下JBPM为我们提供的流程实例迁移的工具怎么用！      

<process name="foobar">
  <start>
    <transition to="a"/>
  </start>
  <state name="a">
    <transition to="b">
  </state>
  <state name="b">
    <transition to="c"/>
  </state>
  <state name="c">
    <transition to="end"/>
  </state>
  <end name="end"/>
</process>

    升级先前的版本的所有流程实例
    在以下两种情况下，我们可以升级先前所有版本的流程实例而不会引发异常
    1. 保证流程定义整体结构不变和所有节点的名称不变；
    2. 保证先前版本的流程定义不变，只是新增了节点；
    这个时候我们的流程定义xml如下     

<process name="foobar">
  <start>
    <transition to="a"/>
  </start>
  <state name="a">
    <transition to="b">
  </state>
  <state name="b">
    <transition to="c"/>
  </state>
  <state name="c">
    <transition to="end"/>
  </state>
  <end name="end"/>
  <migrate-instances/>
</process>

        结束先前版本的流程实例的运行
        无论流程定义怎么变化，我们都可以结束先前版本的流程实例运行

<process name="foobar">
  ...
  <migrate-instances action="end"/>
</process>

        指定处于一个区间的版本的流程实例进行迁移或者结束
        只迁移版本为2和3的流程定义的流程实例

<process name="foobar">
  <start>
    <transition to="a"/>
  </start>
  <state name="a">
    <transition to="b">
  </state>
  <state name="b">
    <transition to="c"/>
  </state>
  <state name="c">
    <transition to="end"/>
  </state>
  <end name="end"/>

  <!--默认是流程实例进行迁移，所以action="migrate"可以省略-->
  <migrate-instances  versions="2..3"/>
</process>

   只迁结束版本为2和3的流程定义的流程实例 

<process name="foobar">
  <start>
    <transition to="a"/>
  </start>
  <state name="a">
    <transition to="b">
  </state>
  <state name="b">
    <transition to="c"/>
  </state>
  <state name="c">
    <transition to="end"/>
  </state>
  <end name="end"/>
  <migrate-instances action="end" versions="2..3"/>
</process>

只迁移最后两个版本的流程实例只迁移最后两个版本的流程实例   只迁移最后两个版本的流程实例  

<process name="foobar">
  ...
  <migrate-instances versions="x-2..x"/>
</process>

迁移所有版本的流程实例   

<process name="foobar">
  ...
  <migrate-instances versions="*"/>
</process>


<process name="foobar">
  ...
  <migrate-instances versions="1..x"/>
</process>

   节点映射迁移
    如果流程有的节点被删除或者被替换，先前版本的流程的实例如果正好运行到删除的节点，那么我们就不能直接将其迁移，如果我们不能迁移，那么我们需要提供节点映射

 <process name="foobar">
  <start>
    <transition to="a"/>
  </start>
  <state name="a">
    <transition to="c">
  </state>  
  <state name="c">
    <transition to="d"/>
  </state>
  <state name="d">
    <transition to="end"/>
  </state>
  <end name="end"/>
  <migrate-instances>
    <activity-mapping old-name="b" new-name="c"/>    
  </migrate-instances>
</process>

 

   自定义迁移策略
    如果JBPM提供的流程实例迁移策略不能满足我们的业务需求，那么我们可以实现JBPM提供的接口org.jbpm.pvm.internal.migration.MigrationHandler，在这里实现我们自己的迁移策略

<process name="foobar">
  ...
  <migrate-instances>
    <migration-handler class="org.jbpm.test.migration.TestHandler"/>
  </migrate-instances>
</process>