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 ="1..x" />
</ process >

 

< process  name ="foobar" >
  ...
   < migrate-instances  versions ="*" />
</ 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 >