（5）Flowable流程变量-全局和局部变量

流程实例按步骤执行时，需要使用一些数据。在Flowable中，这些数据称作变量(variable)，并会存储在数据库中。变量可以用在表达式中（例如在排他网关中用于选择正确的出口路径），也可以在Java服务任务(service task)中用于调用外部服务（例如为服务调用提供输入或结果存储），等等。

流程实例可以持有变量（称作流程变量 process variables）；

用户任务以及执行(executions)——流程当前活动节点的指针——也可以持有变量。流程实例可以持有任意数量的变量，每个变量存储为ACT_RU_VARIABLE数据库表的一行。

所有的startProcessInstanceXXX方法都有一个可选参数，用于在流程实例创建及启动时设置变量。例如，在RuntimeService中：

ProcessInstance startProcessInstanceByKey(String processDefinitionKey, Map<String, Object> variables);

也可以在流程执行中加入变量。例如，(RuntimeService):

void setVariable(String executionId, String variableName, Object value);
void setVariableLocal(String executionId, String variableName, Object value);
void setVariables(String executionId, Map<String, ? extends Object> variables);
void setVariablesLocal(String executionId, Map<String, ? extends Object> variables);

请注意可以为给定执行 设置*局部(local)*变量。（请记住，流程实例由一颗执行的树(tree of executions)组成）

局部变量将只在该执行中可见，对执行树的上层则不可见。这可以用于 数据不应该暴露给流程实例的其他执行，或者变量在流程实例的不同路径中有不同的值（例如使用并行路径时）的情况。

读取变量的方法。请注意TaskService中有类似的方法。这意味着任务与执行一样，可以持有局部变量，其生存期为任务持续的时间。

Map<String, Object> getVariables(String executionId);
Map<String, Object> getVariablesLocal(String executionId);
Map<String, Object> getVariables(String executionId, Collection<String> variableNames);
Map<String, Object> getVariablesLocal(String executionId, Collection<String> variableNames);
Object getVariable(String executionId, String variableName);
<T> T getVariable(String executionId, String variableName, Class<T> variableClass);

下图说明了流程实例、执行实例、任务之间的关系。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Ebz7l3Bx-1680843390462)(Flowable学习.assets/image-20230404191928391.png)]

1、全局变量

流程变量的默认作用域是 流程实例。当一个流程变量的作用域是 流程实例 时，可以称为global变量。

global变量变量中变量名不允许重复，设置相同名称的变量，后者设置的值会覆盖掉前者的者。

2、局部变量

任务和执行实例 仅仅是针对一个任务和一个执行实例范围，范围没有流程实力大，称为local变量。

Local 变量由于在不同的任务或不同的执行实例中，作用域互不影响，变量名可以相同，没有影响。local 变量名也可以和 global 变量名相同，没有影响。

3、案例讲解

需求：员工创建出差申请单，由部门经理审核，部门经理申清通过后，3天以下由财务直接审批，3天以上先由总经理审批，总经理审批通过后再由财务审批。

    /**
     * 部署流程
     */
    @Test
    public void TestDeployment() {
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        RepositoryService repositoryService = processEngine.getRepositoryService();
        Deployment deployment  = repositoryService.createDeployment()
                .addClasspathResource("出差申请单.bpmn20.xml")
                .name("出差申请单流程")
                .deploy();

        System.out.println("deployment.getId()" + deployment.getId());
        System.out.println("deployment.getName()" + deployment.getName());
    }



    /**
     * 启动流程实例
     */
    @Test
    public void TestDeploymentRun() {
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        RuntimeService runtimeService = processEngine.getRuntimeService();
        // 流程变量
        Map<String, Object> variables = new HashMap<String, Object>();
        variables.put("assignee0", "张三");
        variables.put("assignee1", "李四");
        variables.put("assignee2", "王五");
        variables.put("assignee3", "赵会计");
        // 启动流程实例
        ProcessInstance processInstance = runtimeService.startProcessInstanceById("evection:1:70004", variables);
        System.out.println("processInstance.getProcessDefinitionId() = " + processInstance.getProcessDefinitionId());
        System.out.println("processInstance.getActivityId() = " + processInstance.getActivityId());
        System.out.println("processInstance.getId()" + processInstance.getId());
    }

    /**
     * 删除流程定义
     */
    @Test
    public void TestDeploymentDelete() {
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        RepositoryService repositoryService = processEngine.getRepositoryService();
        // 第一个参数是id，如果部署的流程启动了，就不允许删除了
        // repositoryService.deleteDeployment("30001");

        // 第二个参数是级联删除，如果流程启动了，相关的任务一并会被删除
        repositoryService.deleteDeployment("57501", true);
    }

    /**
     * 完成任务，指定流程变量
     */
    @Test
    public void TestCompleteTask() {
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        TaskService taskService = processEngine.getTaskService();
        Task task = taskService.createTaskQuery()
                .processInstanceId("72501") //根据流程实例编号查找
                .taskAssignee("张三")
                .singleResult();

        // 获取当前流程实例的所有的变量
        Map<String, Object> processVariables = task.getProcessVariables();
        processVariables.put("num", 2);
        taskService.complete(task.getId(), processVariables);
    }

    /**
     * 设置了局部变量
     */
    @Test
    public void updateVariablesLocal() {
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        TaskService taskService = processEngine.getTaskService();
        Task task = taskService.createTaskQuery()
                .processInstanceId("72501") //根据流程实例编号查找
                .taskAssignee("李四")
                .singleResult();

        // 获取当前流程实例的所有的变量
        Map<String, Object> processVariables = task.getProcessVariables();
        //null，得不到。可以通过taskService得到全局变量 num 2
        System.out.println("测试 processVariables.get(\"num\") = " + processVariables.get("num"));
        processVariables.put("num", 6);
        // 设置了局部变量，跟执行实例、任务实例绑定了
        taskService.setVariablesLocal(task.getId(), processVariables);
    }


    /**
     * 设置全局变量
     */
    @Test
    public void updateVariables() {
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        TaskService taskService = processEngine.getTaskService();
        Task task = taskService.createTaskQuery()
                .processInstanceId("72501") //根据流程实例编号查找
                .taskAssignee("李四")
                .singleResult();

        Map<String, Object> processVariables = task.getProcessVariables();
        //null，得不到。可以通过taskService.getVariable(task.getId(), "num")得到局部变量 num 6
        System.out.println("测试 processVariables.get(\"num\") = " + processVariables.get("num"));
        processVariables.put("num", 1);
        // 设置全局变量
        taskService.setVariables(task.getId(), processVariables);//结果把局部变量6 改成了 1
    }

    /**
     * 完成任务，李四
     */
    @Test
    public void TestCompleteTask2() {
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        TaskService taskService = processEngine.getTaskService();
        Task task = taskService.createTaskQuery()
                .processInstanceId("72501") //根据流程实例编号查找
                .taskAssignee("李四")
                // .includeProcessVariables().includeTaskLocalVariables()
                .singleResult();

        Map<String, Object> processVariables = task.getProcessVariables();
        // Map<String, Object> taskLocalVariables = task.getTaskLocalVariables();
        //null，得不到。可以通过taskService.getVariable(task.getId(), "num")得到局部变量 num 1
        System.out.println("测试 processVariables.get(\"num\") = " + processVariables.get("num"));

        // 完成任务之后，数据库中发现局部变量 num 1 消失了，而且走到了财务那里，全局变量num并没有使用到
        // 在完成任务时用到的是 局部变量num 1
        taskService.complete(task.getId());
    }

发现全局变量、局部变量的使用，要注意它们的方法，多测试。

在得到task的时候，调用.includeProcessVariables().includeTaskLocalVariables()方法，task身上包含了全局变量、局部变量。