JBPM节点分支之Group节点分析

JBPM节点分支之Group节点分析

      

      JBPM的众多节点类型中，唯独Group节点比较有个性；Group节点作为众多的节点中的一员，其并不能完成业务功能，但其作为一种节点的容器，可以对现有的节点类型进行“混搭”，从而构造出可以完成新的业务功能的节点类型！今天我们来简单的学习一下Group节点，后续我们会进行深入分析JBPM的并发设计时候再次提到Group节点。
       Group节点功能分析
       作为父容器，可以将复杂的业务功能进行封装为新的节点类型,便于业务复用和维护；
       可以将各种复杂的业务过程嵌套到Group中，简化复杂的业务流程；
       可以作为流程并发的边界容器；
       可以作为子流程的承载容器，将子流程封装为单独的一种节点类型；
      Group的个性特点
      作为容器节点，可以嵌套任意类型的节点，可以满足复杂的业务需求；
      前一节点出弧可以直接跨越Group节点，与Group的子节点相连，子节点的出弧也可以直接Group的后一个节点；
      嵌套多起点的时候可以进行并发；
      下面我们看一下几个有Group节点的流程，来体味一下Group的功能和使用
      简单的Group流程
      在这个简单的公文流转（权且这样称谓吧）流程中，我们将这个简单的业务流程嵌套到Group节点中，封装了这个业务流程，当然从重用的角度来说，这并不是一个很好的例子，但是这同样足够体现了Group节点的功能！

                                     

      

       流程定义JPDL      

< process  name ="GroupSimple"  xmlns ="http://jbpm.org/4.4/jpdl" >

   < start >
     < transition  to ="evaluate document"   />
   </ start >
  
   < group  name ="evaluate document" >
     < start >
       < transition  to ="distribute document"   />
     </ start >
     < state  name ="distribute document" >
       < transition  to ="collect feedback"   />
     </ state >
     < state  name ="collect feedback" >
       < transition  name ="approved"  to ="done"   />
       < transition  name ="rejected"  to ="update document"   />
     </ state >
     < state  name ="update document" >
       < transition  to ="distribute document"   />
     </ state >
     < end  name ="done"   />
     < transition  to ="publish document"   />
   </ group >
  
   < state  name ="publish document"   />

</ process >

 

       流程测试用例

      

ProcessInstance processInstance = executionService
       .startProcessInstanceByKey("GroupSimple");
String pid = processInstance.getId();
assertEquals("distribute document", processInstance.getActivityName());

processInstance = executionService.signalExecutionById(pid);
assertEquals("collect feedback", processInstance.getActivityName());

processInstance = executionService.signalExecutionById(pid, "rejected");
assertEquals("update document", processInstance.getActivityName());

processInstance = executionService.signalExecutionById(pid);
assertEquals("distribute document", processInstance.getActivityName());

processInstance = executionService.signalExecutionById(pid);
assertEquals("collect feedback", processInstance.getActivityName());

processInstance = executionService.signalExecutionById(pid, "approved");
assertEquals("publish document", processInstance.getActivityName());

     
       带有定时器的Group流程
       Group作为可等待外部唤醒的节点（此唤醒不同task、state的人工外部唤醒，此处唤醒是由流程引擎进行唤醒继续执行的），其出弧是可以设置定时器的，对于定时器我们后续会进行学习。在这个流程中，在Group开始执行后的2个业务小时后就会执行定时器所在的分支。

                                         

 

      流程定义JPDL     

< process  name ="GroupTimer"  xmlns ="http://jbpm.org/4.4/jpdl" >

   < start >
     < transition  to ="evaluate document"   />
   </ start >
  
   < group  name ="evaluate document" >
     < start >
       < transition  to ="approve"   />
     </ start >
     < state  name ="approve" >
       < transition  to ="done"   />
     </ state >
     < end  name ="done"   />
    
     < transition  to ="publish document"   />
     < transition  name ="timeout"  to ="escalate" >
       < timer  duedate ="2 business hours"   />
     </ transition >
    
   </ group >
  
   < state  name ="escalate"   />
   < state  name ="publish document"   />

</ process >

      流程测试用例

     

ProcessInstance processInstance = executionService
       .startProcessInstanceByKey("GroupTimer");
Execution approveExecution = processInstance
       .findActiveExecutionIn("approve");
assertNotNull(approveExecution);

List<Job> jobs = managementService
  .createJobQuery()
  .processInstanceId(processInstance.getId())
  .list();

assertEquals(1, jobs.size());

Timer timer = (Timer) jobs.get(0);

managementService.executeJob(timer.getDbid());

processInstance = executionService
       .findProcessInstanceById(processInstance.getId());
assertNotNull(processInstance.findActiveExecutionIn("escalate") );

      具有多起点的Group流程（非并发流程）
      在这个流程中，判断节点连接到Group中的不同分支上，通过运行时变量承载的弧名称来选择执行不同的分支，这种情况下只能有一个分支执行。

                                                

      流程定义JPDL     

< process  name ="GroupMultipleEntries"  xmlns ="http://jbpm.org/4.4/jpdl" >

   < start >
     < transition  to ="choose strategy"   />
   </ start >
  
   < decision  name ="choose strategy"  expr ="#{time}" >
     < transition  name ="plenty"  to ="play"   />
     < transition  name ="running out"  to ="plan"   />
   </ decision >
  
   < group  name ="evaluate project" >
     < start  name ="play" >
       < transition  to ="distribute document"   />
     </ start >
     < state  name ="distribute document"   />

     < start  name ="plan" >
       < transition  to ="make planning"   />
     </ start >
     < state  name ="make planning"   />
   </ group >
  
</ process >

 

     流程测试用例代码    

Map<String, Object> variables =  new HashMap<String, Object>();
variables.put("time", "plenty");

ProcessInstance pi = executionService
    .startProcessInstanceByKey("GroupMultipleEntries", variables);

assertNotNull(pi.findActiveExecutionIn("distribute document"));
Map<String, Object> variables =  new HashMap<String, Object>();
variables.put("time", "running out");

ProcessInstance pi = executionService
    .startProcessInstanceByKey("GroupMultipleEntries", variables);

assertNotNull(pi.findActiveExecutionIn("make planning"));

      带有Group的并发流程
      带有Group的并发流程与WF4中的Parallel活动类似，在下面的流程中，由于Group的子节点中由两个没有入弧的节点（不一定得是开始节点），所以运行时会产生两个并发分支。

                                                

       流程定义JPDL

      

< process  name ="GroupConcurrency"  xmlns ="http://jbpm.org/4.4/jpdl" >

   < start >
     < transition  to ="evaluate project"   />
   </ start >
  
   < group  name ="evaluate project" >
     < start >
       < transition  to ="distribute document"   />
     </ start >
     < state  name ="distribute document" >
       < transition  to ="collect feedback"   />
     </ state >
     < state  name ="collect feedback" >
       < transition  to ="document finished"   />
     </ state >
     < end  name ="document finished"   />

     < start >
       < transition  to ="make planning"   />
     </ start >
     < state  name ="make planning" >
       < transition  to ="estimate budget"   />
     </ state >
     < state  name ="estimate budget" >
       < transition  to ="planning finished"   />
     </ state >
     < end  name ="planning finished"   />

     < transition  to ="public project announcement"   />
   </ group >
  
   < state  name ="public project announcement"   />

</ process >

        流程测试用例

       

ProcessInstance pi = executionService
    .startProcessInstanceByKey("GroupConcurrency");

String documentExecutionId = pi
    .findActiveExecutionIn("distribute document").getId();

String planningExecutionId = pi
    .findActiveExecutionIn("make planning").getId();

pi = executionService.signalExecutionById(documentExecutionId);
assertNotNull(pi.findActiveExecutionIn("collect feedback"));
assertNotNull(pi.findActiveExecutionIn("make planning"));

pi = executionService.signalExecutionById(planningExecutionId);
assertNotNull(pi.findActiveExecutionIn("collect feedback"));
assertNotNull(pi.findActiveExecutionIn("estimate budget"));

pi = executionService.signalExecutionById(planningExecutionId);
assertNotNull(pi.findActiveExecutionIn("collect feedback"));

pi = executionService.signalExecutionById(documentExecutionId);
assertNotNull(pi.findActiveExecutionIn("public project announcement"));