activiti学习（十五）——表达式的使用

本文开始重新回归一些activiti的基本使用。感觉前面太想展开源码和架构方面的探讨，但在这过程中，又涉及到activiti很多基本的用法我没有熟练使用，例如表达式、网关、多实例任务、作业、边界事件等等。导致在探讨源码的时候常常一笔带过，虽然对整体理解没有太大的问题，但是总感觉缺了点什么。所以后续决定也要熟练这些基本功能的使用。毕竟很多业务场景还是需要使用这些功能的。

表达式简述

activiti使用UEL处理表达式。UEL（Unified Expression Language）是EE6规范的一部分。activiti使用JUEL以支撑所有的运行环境及最新的UEL规范。

表达式可以用在很多场景中，例如ServiceTask、执行监听器、任务监听器以及连线的条件上。

表达式	表达式含义
${param}	获取变量param的值
${param.age}	获取对象param的age属性的值
${param.test()}	调用对象param的test方法
${param.test("hello")}	调用对象param的test方法，参数为字符串"hello"

除了上面所说的这些表达式，还有以下三种流程引擎的内置变量

变量名称	变量含义
task	通过此变量可以获取用户任务相关的属性。实现了DelegateTask接口
execution	通过此变量可以获取流程实例的信息。实现了DelegateExecution接口
authenticatedUserId	在启动流程时调用IdentityService的setAuthenticatedUserId方法设置

表达式举例
现在有个场景，新建一个请假流程，员工提交给经理审批，流程到员工待办和到经理待办时都有提示，流程结束时也会提示流程完成。

这个例子我们使用系列文章最简单的activiti.cfg.xml作为流程引擎配置文件，在《activiti学习（一）——activiti流程引擎的配置与初始化操作》中查找。流程文档expressBPM.bpmn如下：

<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:activiti="http://activiti.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="http://www.activiti.org/test">
  <process id="expressProcess" name="Express process" isExecutable="true">
    <startEvent id="startevent1" name="Start"></startEvent>
    <userTask id="usertask1" name="usertask1" activiti:assignee="${employee}">
      <extensionElements>
        <activiti:taskListener event="create" expression="${notice.callEmployee(task)}"></activiti:taskListener>
      </extensionElements>
    </userTask>
    <sequenceFlow id="flow1" sourceRef="startevent1" targetRef="usertask1"></sequenceFlow>
    <userTask id="usertask2" name="usertask2" activiti:assignee="${manager}">
      <extensionElements>
        <activiti:taskListener event="create" delegateExpression="${callManager}"></activiti:taskListener>
      </extensionElements>
    </userTask>
    <sequenceFlow id="flow2" sourceRef="usertask1" targetRef="usertask2"></sequenceFlow>
    <endEvent id="endevent1" name="End">
      <extensionElements>
        <activiti:executionListener event="end" expression="${notice.callComplete(execution)}"></activiti:executionListener>
      </extensionElements>
    </endEvent>
    <sequenceFlow id="flow3" sourceRef="usertask2" targetRef="endevent1"></sequenceFlow>
  </process>
  <bpmndi:BPMNDiagram id="BPMNDiagram_expressProcess">
    <bpmndi:BPMNPlane bpmnElement="expressProcess" id="BPMNPlane_expressProcess">
      <bpmndi:BPMNShape bpmnElement="startevent1" id="BPMNShape_startevent1">
        <omgdc:Bounds height="35.0" width="35.0" x="150.0" y="160.0"></omgdc:Bounds>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape bpmnElement="usertask1" id="BPMNShape_usertask1">
        <omgdc:Bounds height="55.0" width="105.0" x="230.0" y="150.0"></omgdc:Bounds>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape bpmnElement="usertask2" id="BPMNShape_usertask2">
        <omgdc:Bounds height="55.0" width="105.0" x="380.0" y="150.0"></omgdc:Bounds>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape bpmnElement="endevent1" id="BPMNShape_endevent1">
        <omgdc:Bounds height="35.0" width="35.0" x="530.0" y="160.0"></omgdc:Bounds>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNEdge bpmnElement="flow1" id="BPMNEdge_flow1">
        <omgdi:waypoint x="185.0" y="177.0"></omgdi:waypoint>
        <omgdi:waypoint x="230.0" y="177.0"></omgdi:waypoint>
      </bpmndi:BPMNEdge>
      <bpmndi:BPMNEdge bpmnElement="flow2" id="BPMNEdge_flow2">
        <omgdi:waypoint x="335.0" y="177.0"></omgdi:waypoint>
        <omgdi:waypoint x="380.0" y="177.0"></omgdi:waypoint>
      </bpmndi:BPMNEdge>
      <bpmndi:BPMNEdge bpmnElement="flow3" id="BPMNEdge_flow3">
        <omgdi:waypoint x="485.0" y="177.0"></omgdi:waypoint>
        <omgdi:waypoint x="530.0" y="177.0"></omgdi:waypoint>
      </bpmndi:BPMNEdge>
    </bpmndi:BPMNPlane>
  </bpmndi:BPMNDiagram>
</definitions>

第5行usertask1节点通过${employee}表达式设置assignee。第7行为usertask1新增一个监听create事件的任务监听器，使用expression方式创建，调用notice对象的callEmployee方法，并把task内置变量作为参数传入。第11行usertask2节点通过${manager}表达式设置assignee。13行为usertask2新增一个监听create事件的任务监听器，使用delegateExpression方式创建，监听器对象为${callManager}变量。19行为endevent1节点新增一个监听end事件的执行监听器，调用notice对象的callComplete方法，并把execution内置变量作为参数传入。流程图本身并不复杂，但添加了几个监听器，并使用了表达式，初学者可能有点乱。

现在我们创建一个Notice类，将来把它的实例作为流程变量notice传入：

public class Notice implements Serializable{

	public void callEmployee(DelegateTask task) {
		String assignee = (String)task.getVariable("employee");
		System.out.println(assignee + " 有一个新的待办");
	}
	
	public void callComplete(DelegateExecution execution) {
		System.out.println(execution.getProcessBusinessKey() + " 流程完成");
	}
}

Notice类的实例因为要作为流程变量传入，所以必须实现Serializable接口。我们定义callEmployee和callComplete方法，分别表示通知员工有新待办和通知流程结束。注意这两个方法的参数，它们是通过内置变量task和execution传入，可往回查看流程文档对应的地方。

接下来创建一个ManagerListener，作为usertask2的任务监听器：

public class ManagerListener implements TaskListener{

	public void notify(DelegateTask delegateTask) {
		String assignee = delegateTask.getAssignee();
		System.out.println(assignee + "经理有待办需要审批");
	}
}

这里notify实现很简单，就是简单输出某某精力有待办的提示。

下面是我们的客户调用，App.java

public class App {
	
	private ProcessEngine pe;

	public void getFromProcessEngineConfiguration() {
		ProcessEngineConfiguration pec = ProcessEngineConfiguration
				.createProcessEngineConfigurationFromResource("activiti.cfg.xml");
		pe = pec.buildProcessEngine();
	}
	
	public void deploy() {
		RepositoryService repositoryService = pe.getRepositoryService();
		DeploymentBuilder deploymentBuilder = repositoryService.createDeployment();
		
		InputStream inputStream = null;
		try {
			inputStream = App.class.getClassLoader().getResource("bpmn/expressBPM.bpmn").openStream();
			deploymentBuilder.addInputStream("express.bpmn", inputStream);
			deploymentBuilder.name("expressDeployment");
			Deployment deployment = deploymentBuilder.deploy();
			System.out.println("部署完成");
		} catch (IOException e) {
			e.printStackTrace();
		}
	}

	public static void main(String[] args) {
		App app = new App();
		app.getFromProcessEngineConfiguration();
		app.deploy();
	}
}

5-9行为初始化流程引擎。11-25行为部署流程文档。这个和以前没什么区别，部署流程文档之后，查看数据库的情况，查看act_re_procdef：

接下来我们添加启动函数并调用之：

public void startProcessByIdWithVars() {
    RuntimeService runtimeService = pe.getRuntimeService();
    Notice notice = new Notice();
    String businessKey = "请假单01";
    Map<String, Object> vars = new HashMap<String, Object>();
    vars.put("employee", "张三");
    vars.put("notice", notice);
    ProcessInstance pi = runtimeService.startProcessInstanceById("expressProcess:1:4", businessKey, vars);
    System.out.println("流程开始");
}

第7-8行把notice作为流程变量，并在启动流程时添加进去。此时控制台输出：

 可以看到流程已经成功调用Notice的callEmployee方法，使用expression创建监听器成功。此时act_re_task表：

 接着定义一个employeeCompleteTask，员工环节提交的方法并调用之：

public void employeeCompleteTask() {
	TaskService taskService = pe.getTaskService();
	TaskListener taskListener = new ManagerListener();
	Map<String, Object> vars = new HashMap<String, Object>();
	vars.put("callManager", taskListener);
	vars.put("manager", "李四");
	taskService.complete("2508", vars);
	System.out.println("完成提交");
}

第5行设置ManagerListener到callManager变量中，第6行把“李四”设置到“manager”变量中。执行后看看控制台输出：

可以看到已经成功触发了任务监听器ManagerListener，通过delegateExpression创建监听器成功。再看此时act_re_task表：

 

 接下来定义经理审批方法manageCompleteTask并调用之：

public void manageCompleteTask() {
	TaskService taskService = pe.getTaskService();
	TaskListener taskListener = new ManagerListener();
	Map<String, Object> vars = new HashMap<String, Object>();
	taskService.complete("5006", vars);
	System.out.println("完成提交");
}

执行该方法，正常来说流程结束。此时看看控制台：

可以看到已经成功触发Notice的callComplete方法。

到目前为止我们已经掌握表达式的基本用法，并把它使用在任务监听器、执行监听器以及设置assignee。在ServiceTask、连线条件上的使用大同小异，请读者自行学习，后面的文章中也会进行使用。