【Activiti工作流】10.排他网关

很久没有更新Activiti的文章，有朋友想看之后的技术总结，我这里就顺着上一次的记忆继续写，把这个系列完结了。

上一次介绍了Activiti中的其中一种模式“连线”，该模式即是一件任务可能要分多种情况，有些情况需要走一个复杂流程，有些情况需要走简单流程，就如同一条河的分支一样。

而本次介绍的是Activiti的另一种模式“排他网关（ExclusiveGateWay）”。
我们打开Eclipse中的某个bpmn的流程图视图，在左侧的编辑框中就可以看到有一个“GateWay”的选项，其中有“ExclusiveGateWay”和“ParallelGateWay”两个选项，其中“ExclusiveGateWay”就是我们要讲的排他网关：

什么是网关(GateWay)？其实网关说白了就是事件流到某一个核心节点，该节点需要做一个判断，如果判断符合某一个逻辑，那么事件就流到合适的路径上去，进行了分支。而做判断的节点就是所谓的网关。

为了让大家更加清晰的理解排他网关，我们利用之前的工程做一个排他网关的样例。
我们要做一个类似“费用报销申请”的流程图，申请人进行费用报销申请，然后利用网关来区分费用的大小。要求有达成如下条件进行不同的分支操作：
(1)如果报销金额大于500，小于等于1000，则任务流转至部门经理审批；
(2)如果报销金额小于等于500，默认流转至财务处审批；
(3)如果报销金额大于1000，则任务流转至总经理审批；

下面我们来利用排他网关来实现这个实例。
首先在测试工程“”中创建一个新的包“”来放置本次测试样例的代码：

然后在该包下新建一个bpmn的流程图：

进入编辑界面后，先创建一个StartEvent节点和一个连线以及一个UserTask：

其这里的UserTask是报销人的申请任务。该UserTask的Properties参数如下：


然后在下面创建3个任务，分别是排他网关根据情况进行分支后的任务：

三个任务的Properties参数如下：

然后我们在申请任务和下面三个任务之间添加一个排他网关：

然后三个任务最终流向结束节点：


然后最重要的几步来了，首先定义排他网关下面的三条线的Name和相关message判断信息：
总经理审批的流线：

部门经理审批的流线：

对于财务的线，我们没有必要为其设备“${message<=500}”的条件，直接将其设置为排他网关的默认Task（将指向该Task的线的id给排他网关的Defalut flow属性），即是不满足其它两个条件时，默认走该Task：

到此我们的排他网关的流程图就画好了，Ctrl+S保存流程图，可以看到在相应的包下生成了一个png的流程图片：


然后我们创建名为“ExclusiveGateWayTest”的测试类进行测试，先编写一个部署流程的部署方法：

package cn.com.eclusiveGateWay;
import java.io.InputStream;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.RepositoryService;
import org.activiti.engine.repository.Deployment;
import org.activiti.engine.repository.DeploymentBuilder;
import org.junit.Test;

public class ExclusiveGateWayTest {//获取流程引擎对象
	//getDefaultProcessEngine方法内部会自动读取名为activiti.cfg.xml文件的配置信息
	ProcessEngine processEngine=ProcessEngines.getDefaultProcessEngine();

	/**部署流程定义*/
	@Test
	public void deploymentProcessDefinition_inputStream(){
		//获得上传文件的输入流
		InputStream inputStreamBpmn=this.getClass().getResourceAsStream("exclusiveGateWayFlow.bpmn");
		InputStream inputStreamPng=this.getClass().getResourceAsStream("exclusiveGateWayFlow.png");
		//获取仓库服务，从类路径下完成部署
		RepositoryService repositoryService=processEngine.getRepositoryService();
		DeploymentBuilder deploymentBuilder=repositoryService.createDeployment();//创建一个部署对象
		deploymentBuilder.name("排他网关");//添加部署的名称
		deploymentBuilder.addInputStream("exclusiveGateWayFlow.bpmn", inputStreamBpmn);
		deploymentBuilder.addInputStream("exclusiveGateWayFlow.png", inputStreamPng);
		Deployment deployment=deploymentBuilder.deploy();//完成部署
		
		//打印我们的流程信息
		System.out.println("部署Id:"+deployment.getId());
		System.out.println("部署名称Name:"+deployment.getName());
	}
}

执行该部署方法，可以看到控制台输出了部署信息：


然后在数据库中，可以看到act_re_deployment部署对象表、act_re_procdef流程定义表以及act_ge_bytearray资源文件表中都生成了该次部署的流程定义信息：

然后在ExclusiveGateWayTest中编写启动实例方法：

/**启动流程引擎*/
@Test
public void startProcessInstance(){
	//获取流程启动Service
	RuntimeService runtimeService=processEngine.getRuntimeService();
	//使用流程定义的key，key对应bpmn文件对应的id，
	//(也是act_re_procdef表中对应的KEY_字段),默认是按照最新版本启动
	String processDefinitionkey="myProcess";//流程定义的key就是myProcess
	//获取流程实例对象
	ProcessInstance processInstance=runtimeService.startProcessInstanceByKey(processDefinitionkey);
	System.out.println("流程实例ID："+processInstance.getId());//流程实例ID
	System.out.println("流程定义ID："+processInstance.getProcessDefinitionId());//流程定义ID
}

运行测试方法，启动该流程：

在数据库中的act_run_task表中有一个正在执行的任务：


那么我们编写查询“姜晓宏”流程任务的方法，查看姜晓宏当前的待办任务：

/**查询当前的个人任务(实际就是查询act_ru_task表)*/
@Test
public void findMyPersonalTask(){
	String assignee="姜晓宏";
	//获取事务Service
	TaskService taskService=processEngine.getTaskService();
	List<Task> taskList=taskService.createTaskQuery()//创建任务查询对象
			   .taskAssignee(assignee)//指定个人任务查询，指定办理人
			   .list();//获取该办理人下的事务列表
	
	if(taskList!=null&&taskList.size()>0){
		for(Task task:taskList){
			System.out.println("任务ID："+task.getId());
			System.out.println("任务名称："+task.getName());
			System.out.println("任务的创建时间："+task.getCreateTime());
			System.out.println("任务办理人："+task.getAssignee());
			System.out.println("流程实例ID："+task.getProcessInstanceId());
			System.out.println("执行对象ID："+task.getExecutionId());
			System.out.println("流程定义ID："+task.getProcessDefinitionId());
			System.out.println("#############################################");
		}
	}
}

查询结果：


可以看到他的任务ID为2304，下面编写完成任务的测试方法，定义流程变量的名称为message，值为450：

/**完成我的任务*/
@Test
public void completeMyPersonalTask(){
	String taskId="2304";//上一次我们查询的任务ID
	//完成任务的同时，设置流程变量，使用流程变量用来制定完成任务后，下一个连线，
	//对应exclusiveGateWayFlow.bpmn文件中${message==450}
	Map<String,Object> variables=new HashMap<String,Object>();
	variables.put("message", 450);
	TaskService taskService=processEngine.getTaskService();
	taskService.complete(taskId,variables);//完成taskId对应的任务，并附带流程变量
	System.out.println("完成ID为"+taskId+"的任务");
}

完成结果：


按照流程图来说，节点应该流向默认的“财务”处，即是“张丽”来办理该任务，所以我们查询张丽的代办任务：


然后执行张丽的任务：

最后任务完成：

历史的任务节点：

流程中出现的流程变量：


然后重新启动一个流程，将message设置为700：

此时流程流向了部门经理：

执行2704任务后流程结束：


最后再重启一个流程，将message设置为1300：

此时流程流向了总经理：

执行3004任务后流程结束：

总结：
1)一个排他网关对应一个以上的顺序流。

2)由排他网关流出的顺序流都有一个conditionExpression元素，在内部维护返回boolean类型的决策结果。

3)决策网关只会返回一条结果。当流程执行到排他网关时，流程引擎会自动检索网关出口，从上到下检索，如果发现第一条决策结果为true或者没有设置条件的(默认成立)，则流出。

4)如果没有任何一个出口符合条件，则抛出异常。

5)使用流程变量，设置连线的条件，并按照连线的条件执行工作流，如果没有符合的条件，则执行默认的连线。

转载请注明出处：http://blog.csdn.net/acmman/article/details/79618640