Activiti学习记录(三)

1.流程变量

1.1 流程图

流程变量在整个工作流中扮演很重要的作用。例如：请假流程中有请假天数、请假原因等一些参数都为流程变量的范围。流程变量的作用域范围是只对应一个流程实例。也就是说各个流程实例的流程变量是不相互影响的。流程实例结束完成以后流程变量还保存在数据库中（存放到流程变量的历史表中）。

流程变量的作用:

1.用来传递业务参数

2.指定连线完成任务(同意和拒绝)

3.动态指定任务的办理人

1.2 输入流加载资源文件的3种方式

1.3.设置和获取流程变量

/**
     * 设置流程变量
     */
    @Test
    public void setVariables() {
        /**与任务相关(正在执行)**/
        TaskService taskService = processEngine.getTaskService();
        //任务ID
        String taskId = "2304";
        //设置流程变量，使用基本数据类型
        taskService.setVariableLocal(taskId , "请假天数", 5);//与任务id绑定
        taskService.setVariable(taskId , "请假日期", new Date());
        taskService.setVariable(taskId , "请假原因","回家探亲,一起吃个饭");
        /**使用javabean设置流程变量**/
        /**
         * 当一个javabean(实现序列化)放置到流程变量中,要求javabean的属性不能在发生变化
         * 如果发生变化，在获取时会抛出异常
         * 解决办法：在javabean序列化时，固定序列化版本  private static final long serialVersionUID = 1L;
         */
        Person p = new Person();
        p.setId(10);
        p.setName("翠花");
        taskService.setVariable(taskId, "人员信息", p);
        System.out.println("设置流程变量成功!");
    }
    /**
     * 获取流程变量
     */
    @Test
    public void getVariables() {
        /**与任务相关(正在执行)**/
        TaskService taskService = processEngine.getTaskService();
        //任务ID
        String taskId = "2304";
        /*Integer days = (Integer) taskService.getVariable(taskId, "请假天数");
        Date date = (Date) taskService.getVariable(taskId, "请假日期");
        String reson = (String) taskService.getVariable(taskId, "请假原因");

        System.out.println("请假天数:"+days);
        System.out.println("请假日期:"+date);
        System.out.println("请假原因:"+reson);*/
        /**使用javabean获取流程变量**/
        Person person = (Person) taskService.getVariable(taskId, "人员信息");
        System.out.println(person.getId()+":"+person.getName());
    }

说明：

1） 流程变量的获取针对流程实例（即1个流程），每个流程实例获取的流程变量时不同的

2） 使用基本类型获取流程变量，在taskService中使用任务ID，流程变量的名称，获取流程变量的值。

3） Javabean类型设置获取流程变量，除了需要这个javabean实现了Serializable接口外，还要求流程变量对象的属性不能发生变化，否则抛出异常。解决方案，固定序列化ID（private static final long serialVersionUID = 1L）

1.4 模拟流程变量的设置和获取的场景

/**
     * 模拟设置和获取流程变量的场景
     */
    @Test
    public void setAndGetVariables() {
        /**与流程实例，执行对象(正在执行)**/
        RuntimeService runtimeService = processEngine.getRuntimeService();
        /**与任务相关(正在执行)**/
        TaskService taskService = processEngine.getTaskService();

        /**设置流程变量**/
//        runtimeService.setVariable(executionId, variableName, value);//表示使用执行对象id，和流程变量的名称，设置流程变量的值(一次只能设置一次)
//        runtimeService.setVariables(executionId, variables);//表示使用执行对象id和map集合设置流程变量，map集合的key是流程变量的名称，map集合的value是流程变量的值

//        taskService.setVariable(executionId, variableName, value);//表示使用执行任务id，和流程变量的名称，设置流程变量的值(一次只能设置一次)
//        taskService.setVariables(executionId, variables);//表示使用执行任务id和map集合设置流程变量，map集合的key是流程变量的名称，map集合的value是流程变量的值

//        runtimeService.startProcessInstanceByKey(processDefinitionKey, variables);//启动流程实例的同时，可以设置流程变量，用map集合
//        taskService.complete(taskId, variables);//完成任务的同时，可以设置流程变量，用map集合
        /**获取流程变量**/
//        runtimeService.getVariable(executionId, variableName)//执行对象的id和名称，获取流程变量的值
//        runtimeService.getVariables(executionId);//使用执行对象id，获取所欲的流程变量，将流程变量放入map集合中,map集合的key是流程变量的名称，map集合的value是流程变量的值
//        runtimeService.getVariables(executionId, variableNames);//使用执行对象id，获取流程变量的值，可以通过设置流程变量的名称存放在集合中，获取指定流程变量名称的流程变量的值，并存放在map中

//        taskService.getVariable(executionId, variableName)//执行任务的id和名称，获取流程变量的值
//        taskService.getVariables(executionId);//使用执行任务id，获取所有的流程变量，将流程变量放入map集合中,map集合的key是流程变量的名称，map集合的value是流程变量的值
//        taskService.getVariables(executionId, variableNames);//使用执行任务id，获取流程变量的值，可以通过设置流程变量的名称存放在集合中，获取指定流程变量名称的流程变量的值，并存放在map中

    }

说明：

1） RuntimeService对象可以设置流程变量和获取流程变量

2） TaskService对象可以设置流程变量和获取流程变量

3） 流程实例启动的时候可以设置流程变量

4） 任务办理完成的时候可以设置流程变量

5） 流程变量可以通过名称/值的形式设置单个流程变量

6） 流程变量可以通过Map集合，同时设置多个流程变量

Map集合的key表示流程变量的名称

Map集合的value表示流程变量的值

2 总结

• 1：流程变量

在流程执行或者任务执行的过程中，用于设置和获取变量，使用流程变量在流程传递的过程中传递业务参数。

对应的表：

act_ru_variable：正在执行的流程变量表

act_hi_varinst：流程变量历史表

• 2：扩展知识：setVariable和setVariableLocal的区别

setVariable：设置流程变量的时候，流程变量名称相同的时候，后一次的值替换前一次的值，而且可以看到TASK_ID的字段不会存放任务ID的值

setVariableLocal：

1：设置流程变量的时候，针对当前活动的节点设置流程变量，如果一个流程中存在2个活动节点，对每个活动节点都设置流程变量，即使流程变量的名称相同，后一次的版本的值也不会替换前一次版本的值，它会使用不同的任务ID作为标识，存放2个流程变量值，而且可以看到TASK_ID的字段会存放任务ID的值

例如act_hi_varinst 表的数据：不同的任务节点，即使流程变量名称相同，存放的值也是不同的。

如图：

2：还有，使用setVariableLocal说明流程变量绑定了当前的任务，当流程继续执行时，下个任务获取不到这个流程变量（因为正在执行的流程变量中没有这个数据），所有查询正在执行的任务时不能查询到我们需要的数据，此时需要查询历史的流程变量。