(4)activiti工作流引擎之uel表达式

有了前面几章，我们肯定有一定的困惑，activiti如何与实际业务整合，比如一条采购单，如何跟一个流程实例互相关联起来？

这里就需要使用到activiti启动流程实例时设置一个流程实例的businessKey(一般存储我们一条采购单的id)

1，启动流程实例设置其businessKey

/**
     * 启动一个流程实例，设置其业务id
     */
    @Test
    public void startProInsWithKey() {
        RuntimeService runtimeService = engine.getRuntimeService();

        String processDefinitionKey = "purchasingflow";
        //设置一个businessKey，在我实际业务中可能是一个采购单，或者订单之类的id
        String businessKey ="111";
        // 根据流程定义的key启动一个流程实例
        ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey,businessKey);
        System.out.println("流程实例id:" + processInstance.getId());
        System.out.println("流程定义id:" + processInstance.getProcessDefinitionId());

    }

 一般情况下，我们是在用户保存一条采购单的时候，启动这个实例，并且动态获取采购单的id（也就是用作流程实例的businessKey）,并且我们还会在采购单表中保存这个流程实例的id，双向一对一绑定，方便业务查询

2，根据采购单的id（也就是用作流程实例的businessKey）,动态的查询出对应的流程实例

/**
     * 通过businessKey查询流程实例
     */
    @Test
    public void queryProInsWithKey(){
        RuntimeService runtimeService = engine.getRuntimeService();
        String businessKey ="111";
        
        ProcessInstanceQuery instanceQuery = runtimeService.createProcessInstanceQuery();
        //根据其流程定义key和业务id businessKey查询出对应的流程实例，一般只有一条
        instanceQuery.processInstanceBusinessKey(businessKey);
        //查询出唯一的一条流程实例
        ProcessInstance processInstance = instanceQuery.singleResult();
        
        System.out.println("流程实例id:"+processInstance.getId());
        System.out.println("流程定义id:"+processInstance.getProcessDefinitionId());
        
    }

到这里，我们就清楚了一个流程实例和实际业务数据的绑定

大家到这里也启动了很多的流程实例了，发现我们的任务办理人都是写死为zhangsan，lisi之类的，那么我们可以动态的指定吗，这就需要使用到我们的uel表达式了

首先uel表达式到底是什么呢？

UEL是java EE6规范的一部分，UEL（Unified Expression Language）即统一表达式语言，activiti支持两个UEL表达式：UEL-value和UEL-method。我们都会分别做介绍

(一)我们先来演示uel-value

首先做个简单的使用带大家入门

使用步骤：(看不明白的运行下面的代码走一遍再回头看)

1，在任务的节点，不直接指定处理人的id，设置处理人表达式${assignee}，并且重新部署流程定义

2, 启动一个流程实例是设置启动变量动态设置assignee的值

3，查看并验证下一个任务的处理人是否为我们动态设置

1，首先我们设置节点

2，在启动代码时动态设置assignee的值

/**
     * 启动流程实例时设置全局变量
     */
    @Test
    public void startProInsWithArgs(){
        
        RuntimeService runtimeService = engine.getRuntimeService();

        String processDefinitionKey = "purchasingflow";
        //设置其启动的全局变量参数，其value可以是javabean，也可以是普通字符串，数字
        Map<String,Object> variables = new HashMap<String, Object>();
        variables.put("assignee", "feige");
        //设置流程启动时，设置参数启动
        ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey,variables);
        System.out.println("流程实例id:" + processInstance.getId());
        System.out.println("流程定义id:" + processInstance.getProcessDefinitionId());
        
    }

3，这个时候我们通过查看数据库，查看act_ru_task当前运行的任务，查看

从上面的我们可以看到流程走到了，创建采购单，并且采购的assignee处理人为feige

因为当我们走到了创建采购单时，会从当前流程实例的全局变量查找name为assignee的值，如果查询到，则将这个assignee的值赋给这个节点，如果我们动态设置了，但是走到这个节点前（为什么说节点前呢，因为还可以在别的时候设置变量，后面的章节会讲）

没有找到这个assignee变量的值，会报错的，大家可以自己试一试

---

当然除了上面的设置方法，我们还有其他的设置方法来动态设置其节点的值吗？答案是肯定的，启动的流程时候的参数的value，不仅仅可以是String类型，还可以是Object对象（序列化的），Map,List,Array

我们这里采用对象做演示，执行步骤如下

1，设置流程的第一个节点动态的值为${user.userId}，他会默认查找变量name为user的对应的值的getUserId获取值，重新部署流程定义

2，启动流程时，设置这个user的javabean到流程的全局变量中

3，查看走到这个节点的当前任务的处理人是否是我们user的userId变量的值

1，设置节点

2，设置javabean  User对象并且在流程实例启动时设置进去

public class User implements Serializable{
    /**
     * 用于序列化
     */
    private static final long serialVersionUID = 7717000074223077256L;
    private String userId;
    private String sex;
    private String name;
    
    public User(String userId, String sex, String name) {
        super();
        this.userId = userId;
        this.sex = sex;
        this.name = name;
    }
    public String getUserId() {
        return userId;
    }
    public void setUserId(String userId) {
        this.userId = userId;
    }
    public String getSex() {
        return sex;
    }
    public void setSex(String sex) {
        this.sex = sex;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }

}

/**
     * 启动流程设置一个user用户到全局变量中
     */
    @Test
    public void startProInsWithObj(){
        
        RuntimeService runtimeService = engine.getRuntimeService();

        String processDefinitionKey = "purchasingflow";
        
        //设置其启动的全局变量参数，其value设置为user对象，这里写死
        User user = new User("101","男","张三");
        
        Map<String,Object> variables = new HashMap<String, Object>();
        variables.put("user", user);
        //设置流程启动时，设置参数启动
        ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey,variables);
        System.out.println("流程实例id:" + processInstance.getId());
        System.out.println("流程定义id:" + processInstance.getProcessDefinitionId());
        
    }

3，到这里流程实例启动成功，我们观察数据库的当前任务表，观察第一个节点的处理人是否为我们设置的101的userId

 设置成功！

(二)演示uel-method

执行步骤

1，设置节点的执行人为${method.getUserNameByUserId(userId)} ，其中method方法是我们注入到spring中的一个类，userId是我们设置的全局变量

2，将method方法注入到activiti的processEngineConfiguration的bean中（在我们的activiti.cfg.xml中）

3，启动一个流程设置全局变量userId作为启动参数,看看是否走到这个节点的处理人是我们method方法getUserNameByUserId返回的name

好了，直接上代码

1，设置节点，重新部署流程定义

2，method的java方法和activiti.cfg.xml的注入配置

public class CommonMethod{

    public String getUserNameByUserId(int userId){
        
        return "activiti"+userId;
        
    }

}

<bean class="cn.nfcm.po.CommonMethod" id="commonmethod"></bean>
    
    <bean id="processEngineConfiguration"
        class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
        <!-- 数据源 -->
        <property name="dataSource" ref="dataSource" />
        <!-- activiti数据库表处理策略 -->
        <property name="databaseSchemaUpdate" value="true" />
        <!-- 可以注入多个类到activiti的beans中，其中key对应的就是我们的类名 -->
        <property name="beans">
            <map>
                <entry key="commonmethod" value-ref="commonmethod" />
            </map>
        </property>
    </bean>

3，启动一个流程实例

/**
     * 根据方法得到值
     */
    @Test
    public void startProInsWithMethod(){

        RuntimeService runtimeService = engine.getRuntimeService();

        String processDefinitionKey = "purchasingflow";
        //这里设置userId为8，走到第一个节点会查找我们注入进去的commonmethod的getUserNameByUserId方法并传递userId
        Map<String,Object> variables = new HashMap<String, Object>();
        variables.put("userId", 8);
        
        //设置流程启动时，设置参数启动
        ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey,variables);
        System.out.println("流程实例id:" + processInstance.getId());
        System.out.println("流程定义id:" + processInstance.getProcessDefinitionId());
        
        
    }

到这里我们会发现流程启动成功，并且流程的当前任务处理人为acitiviti8，在实际的应用中因为都是spring管理的类，我们可以进行多种多样的查询赋值，非常方便！