activiti学习之变量

淡淡的烟草味﹌ 2022-08-28 06:57 213阅读 0赞

## 写在前面 ##

Activiti中变量类型分为流程变量和任务变量，变量的设置又分基本类型设置，JavaBean类型设置，下面将分别讲解。

## 1：测试使用的流程 ##

![在这里插入图片描述][acb946e83a2c421fa3414b06435f18a3.png]

xml：

<?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="csdnvariable" name="csdnvariable" isExecutable="true">
            <startEvent id="startevent1" name="Start"></startEvent>
            <endEvent id="endevent1" name="End"></endEvent>
            <userTask id="usertask1" name="用户任务" activiti:assignee="张三">
                <extensionElements>
                    <modeler:initiator-can-complete xmlns:modeler="http://activiti.com/modeler">false</modeler:initiator-can-complete>
                </extensionElements>
            </userTask>
            <sequenceFlow id="flow1" sourceRef="startevent1" targetRef="usertask1"></sequenceFlow>
            <sequenceFlow id="flow2" sourceRef="usertask1" targetRef="endevent1"></sequenceFlow>
        </process>
        <bpmndi:BPMNDiagram id="BPMNDiagram_myProcess">
            <bpmndi:BPMNPlane bpmnElement="myProcess" id="BPMNPlane_myProcess">
                <bpmndi:BPMNShape bpmnElement="startevent1" id="BPMNShape_startevent1">
                    <omgdc:Bounds height="35.0" width="35.0" x="230.0" y="260.0"></omgdc:Bounds>
                </bpmndi:BPMNShape>
                <bpmndi:BPMNShape bpmnElement="endevent1" id="BPMNShape_endevent1">
                    <omgdc:Bounds height="35.0" width="35.0" x="650.0" y="260.0"></omgdc:Bounds>
                </bpmndi:BPMNShape>
                <bpmndi:BPMNShape bpmnElement="usertask1" id="BPMNShape_usertask1">
                    <omgdc:Bounds height="55.0" width="105.0" x="400.0" y="250.0"></omgdc:Bounds>
                </bpmndi:BPMNShape>
                <bpmndi:BPMNEdge bpmnElement="flow1" id="BPMNEdge_flow1">
                    <omgdi:waypoint x="265.0" y="277.0"></omgdi:waypoint>
                    <omgdi:waypoint x="400.0" y="277.0"></omgdi:waypoint>
                </bpmndi:BPMNEdge>
                <bpmndi:BPMNEdge bpmnElement="flow2" id="BPMNEdge_flow2">
                    <omgdi:waypoint x="505.0" y="277.0"></omgdi:waypoint>
                    <omgdi:waypoint x="650.0" y="277.0"></omgdi:waypoint>
                </bpmndi:BPMNEdge>
            </bpmndi:BPMNPlane>
        </bpmndi:BPMNDiagram>
    </definitions>

## 2：测试 ##

### 2.1：部署流程 ###

@Test
    public void deploy() { 
        Deployment deployment = repositoryService.createDeployment() // 创建部署
                .addClasspathResource("com/jh/activiti/csdn-variable.bpmn20.xml") // 加载流程资源文件
                .name("csdn流程变量测试") // 流程名称
                .deploy(); // 部署
        /* 流程部署ID:57501 流程部署Name:helloworld流程 */
        System.out.println("流程部署ID:" + deployment.getId());
        System.out.println("流程部署Name:" + deployment.getName());
    }

部署成功后：

![在这里插入图片描述][8dcaf334c2d0413bacfc6ce766d55f4a.png]

![在这里插入图片描述][47dc23d198a842578750cef65f9d4b34.png]

### 2.2：启动流程实例 ###

@Test
    public void start() { 
        ProcessInstance pi = runtimeService.startProcessInstanceByKey("csdnvariable"); // 流程定义表的KEY字段值
        System.out.println("流程实例ID:" + pi.getId());
        System.out.println("流程定义ID:" + pi.getProcessDefinitionId());
    }

启动后：

实例：

![在这里插入图片描述][77d52f7382bd464686508925acfcb561.png]

任务：

![在这里插入图片描述][fa14059d550b470a98904f809cb9b678.png]

### 2.3：直接设置和获取任务变量 ###

*  设置变量

// 存储到表act_ru_variable，ru是running的简称，代表的是正在执行中的流程实例
    // 存储到表act_hi_varinst，hi是history的简称，代表的是所有的执行中和执行完毕的流程实例变量信息
    @Test
    public void setVariable1() { 
        String taskId = "747507";
        // 基本类型,这里变量的数据范围是当前任务id所属的流程实例
        taskService.setVariable(taskId, "days", 5);
        // 这里变量的数据范围是当前任务id所属的流程实例
        taskService.setVariable(taskId, "reason", "回家结婚");
        // setVariableLocal设置局部变量，只能在当前任务中得到,变量的范围是流程实例的当前任务
        taskService.setVariableLocal(taskId, "date", new Date());
    
        // 序列化对象
        Leave leave = new Leave();
        leave.setDays(5);
        leave.setReason("相亲");
        taskService.setVariable(taskId, "leave", leave);
    }

设置后从运行时表`act_ru_variable`表查看：

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAd2FuZzA5MDc_size_20_color_FFFFFF_t_70_g_se_x_16]

从历史变量表`act_hi_varinst`中查看：

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAd2FuZzA5MDc_size_20_color_FFFFFF_t_70_g_se_x_16 1]

*  获取变量

@Test
    public void getVariable1() { 
        String taskId = "747507";
        // 获取基本类型
        Integer days = (Integer) taskService.getVariable(taskId, "days");
        Date date = (Date) taskService.getVariableLocal(taskId, "date");
        String reason = (String) taskService.getVariable(taskId, "reason");
        // 获取对象类型
        Leave leave = (Leave) taskService.getVariable(taskId, "leave");
    
        System.out.println("天数：" + days);
        System.out.println("日期：" + date);
        System.out.println("原因：" + reason);
        System.out.println("对象：" + leave.getDays() + ", " + leave.getReason());
    }

天数：5
    日期：Sat Oct 09 18:13:24 CST 2021
    原因：回家结婚
    对象：5, 相亲

### 2.4：设置和获取Map变量 ###

*  设置变量

/** * 设置流程变量--MAP方式 */
    @Test
    public void setVariableToProcessInstance1() { 
        String executionId = "757502";
        Leave leave = new Leave();
        leave.setDays(5);
        leave.setReason("相亲");
        // 填充map
        Map<String, Object> variables = new HashMap<String, Object>();
        variables.put("exe_days", 5);
        variables.put("exe_reason", "相亲");
        variables.put("exe_date", new Date());
        variables.put("exe_leave", leave);
    
        runtimeService.setVariables(executionId, variables);
    }

设置后查看：

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAd2FuZzA5MDc_size_20_color_FFFFFF_t_70_g_se_x_16 2]

*  获取变量

/** * 获取流程变量--MAP方式 */
    @Test
    public void getVariableToProcessInstance1() { 
        String executionId = "757502";
        // 获取变量
        Map<String, Object> variables = runtimeService.getVariables(executionId);
        Integer days = (Integer) variables.get("exe_days");
        String reason = (String) variables.get("exe_reason");
        Date date = (Date) variables.get("exe_date");
        Leave leave = (Leave) variables.get("exe_leave");
    
        System.out.println("天数：" + days);
        System.out.println("日期：" + date);
        System.out.println("原因：" + reason);
        System.out.println("对象：" + leave.getDays() + "," + leave.getReason());
    }

天数：5
    日期：Sun Oct 10 08:50:18 CST 2021
    原因：相亲
    对象：5,相亲

### 2.5：启动流程市就设置流程变量 ###

可应用于启动流程实例时输入一些信息的场景。

*  设置变量

// 启动流程市就设置流程变量（如发起流程的人有一些提示性质信息，给后续执行流程的人来看）
    @Test
    public void startProcInstanceWithInitVairable() { 
        Map<String, Object> variables = new HashMap<String, Object>();
        variables.put("var_start", "var_start");
        ProcessInstance pi = runtimeService.startProcessInstanceByKey("helloworld", variables); // 流程定义表的KEY字段值
        System.out.println("流程实例ID:" + pi.getId());
        System.out.println("流程定义ID:" + pi.getProcessDefinitionId());
    }

直接存储到act\_hi\_varinst，历史变量表，不会存储在act\_ru\_variable表中，效果等同于，设置任务变量，然后直接完成任务,可以认为是`针对开始节点设置的变量`，注意是认为。

![在这里插入图片描述][36d57ecb02994b5d966b6e938244512c.png]

*  获取变量

/** * 获取流程变量 */
    // 获取在启动流程实例时就设置的属性信息
    // 直接存储到act_hi_varinst，历史变量表，不会存储在act_ru_variable表中，效果等同于，设置任务变量，然后直接完成任务
    @Test
    public void getStartProcInstanceWithInitVairable() { 
        String executionId = "762502";
        String params = (String) runtimeService.getVariable(executionId, "var_start");
    
        System.out.println("启动流程变量：" + params);
    }

启动流程变量：var_start

### 2.6：完成任务时设置变量 ###

*  设置变量

// 完成任务时设置变量
    @Test
    public void setVariableWhenComplateTask() { 
        Map<String, Object> variables = new HashMap<String, Object>();
        variables.put("var_complete", "var_complete");
        taskService.complete("757506", variables);
    }

*  获取变量

@Test
    public void getVariableWhenComplateTask() { 
        List<HistoricVariableInstance> list = historyService.createHistoricVariableInstanceQuery()
                .executionId("757502")
                .variableName("var_complete")
                .list();
    
        if (list != null && list.size() > 0) { 
            for (HistoricVariableInstance hiv : list) { 
                System.out.println(hiv.getVariableName() + "=" + hiv.getValue());
            }
        }
    }

[acb946e83a2c421fa3414b06435f18a3.png]: /images/20220828/e546b5fc604243d9b15e6aa4bff5c47c.png
[8dcaf334c2d0413bacfc6ce766d55f4a.png]: /images/20220828/cf695dd2af2e4b61b2b0945fa37095d7.png
[47dc23d198a842578750cef65f9d4b34.png]: /images/20220828/26f831d31bca4c3587460942ec258067.png
[77d52f7382bd464686508925acfcb561.png]: /images/20220828/34c07993d3b54b8cbe386f396eafe70c.png
[fa14059d550b470a98904f809cb9b678.png]: /images/20220828/45250084e171429b9acccddc795b8ff0.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAd2FuZzA5MDc_size_20_color_FFFFFF_t_70_g_se_x_16]: /images/20220828/be711f38e8d84344901c50ddb15a7aae.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAd2FuZzA5MDc_size_20_color_FFFFFF_t_70_g_se_x_16 1]: /images/20220828/194568c0dd7c45798a6107a4079b4d6e.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAd2FuZzA5MDc_size_20_color_FFFFFF_t_70_g_se_x_16 2]: /images/20220828/ba48628a44334ce0905fe8bee5479d19.png
[36d57ecb02994b5d966b6e938244512c.png]: https://img-blog.csdnimg.cn/36d57ecb02994b5d966b6e938244512c.png