部署流程定义

  InputSteam输入流方式

/**
     * 部署流程定义(inputstream)
     */
    @Test
    public void deploymentProcessDefinition_InputStream() {
        InputStream inputStreamBPMN=this.getClass().getResourceAsStream("/diagrams/processVariables.bpmn");
        InputStream inputStreamPNG=this.getClass().getResourceAsStream("/diagrams/processVariables.png");
        
        Deployment deployment= processEngine.getRepositoryService()
                    .createDeployment()
                    .name("流程变量")
                    .addInputStream("processVariables.bpmn", inputStreamBPMN)
                    .addInputStream("processVariables", inputStreamPNG)
                    .deploy();
        
        System.out.println("部署ID:"+deployment.getId());
        System.out.println("部署名称:"+deployment.getName());
    }

 

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

    this.getClass().getClassLoader().getResourceAsStream("testVariables.bpmn");

    从classPath根目录下加载指定名称的文件

    this.getClass().getResourceAsStream("testVariables.bpmn")

    从当前包下加载指定名称的文件

    this.getClass().getResourceAsStream("/testVariables.bpmn")

    从classpath根目录下加载指定名称的文件

启动流程实例(略)

设置流程变量

  

/**设置流程变量*/
    @Test
    public void setVariables() {
        TaskService taskService=processEngine.getTaskService();
        //任务ID
        String taskId="37504";
        
        /**
         * 一:设置流程变量,使用基本数据类型
         */
        /*taskService.setVariableLocal(taskId, "请假天数", 5);//与任务ID绑定
        taskService.setVariable(taskId, "请假日期", new Date());
        taskService.setVariable(taskId, "请假原因", "回家");*/
        
        /**
         * 二:设置流程变量,用javabean类型
         */
        /**
         * 当一个javabean(实现序列号)放置到流程变量中,要求javabean的属性不能在发生变化
         *     如果发生变化,再获取的时候,就会抛出异常
         * 
         * 解决方案:在Person对象中添加:
         *     private static final long serialVersionUID
         *     同时实现implements Serializable
         */
        Person p=new Person();
        p.setId(10);
        p.setName("王五");
        taskService.setVariable(taskId, "人员信息(添加固定)", p);
        
        System.out.println("设置流程变量成功!!");
    }

 

  说明:

  1) 流程变量的作用域就是流程实例,所以只要设置就行了,不用管在哪个阶段设置

  2) 基本类型设置流程变量,在taskService中使用任务ID,定义流程变量的名称,设置流程变量的值。

  3) Javabean类型设置流程变量,需要这个javabean实现了Serializable接口

  4) 设置流程变量的时候,向act_ru_variable这个表添加数据

获取流程变量

  

/**获取流程变量*/
    @Test
    public void getVariables() {
        TaskService taskService=processEngine.getTaskService();
        //任务ID
        String taskId="37504";
        
        /**
         * 一:获取流程变量,使用基本数据类型
         */
        /*Integer day=(Integer) taskService.getVariable(taskId, "请假天数");
        Date date=(Date) taskService.getVariable(taskId, "请假日期");
        String reason=(String) taskService.getVariable(taskId, "请假原因");
        System.out.println("请假天数:"+day);
        System.out.println("请假日期:"+date);
        System.out.println("请假原因:"+reason);*/
        
        /**
         * 二:获取流程变量,使用javabean类型
         */
        Person p=(Person) taskService.getVariable(taskId,"人员信息(添加固定)");
        System.out.println(p.getId()+"      "+p.getName());
    }

  说明:

  1) 流程变量的获取针对流程实例(即1个流程),每个流程实例获取的流程变量时不同的

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

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

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

  

    /**
     *模拟设置和获取流程变量的场景
     */
    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(taskId, variableName, value);//表示使用任务ID,和流程变量的名称,设置流程变量的值(一次只能设置一个值)
//        taskService.setVariables(taskId, variables);//表示使用任务ID,和Map集合设置流程变量,map集合的key就是流程变量的名称,map集合的value就是流程变量值(一次设置多个值)
        
//        runtimeService.startProcessInstanceByKey(processDefinitionKey, variables);//启动流程实例的同时,可以设置流程变量,用map集合
//        taskService.complete(taskId, variables);//完成任务的同时,设置流程变量,用map集合
        
        /**获取流程变量*/
//        taskService.getVariable(executionId, variableName);//使用执行对象ID和流程变量的名称,获取流程变量的值
//        taskService.getVariables(executionId);//使用执行对象ID,获取所有的流程变量,将流程变量放置到Map集合中,map集合的key就是流程变量的名称,map集合的value就是流程变量的值
//        taskService.getVariables(executionId, variableNames);//使用执行对象ID,获取流程变量的值,通过设置流程变量的名称存放到集合中,获取指定流程变量名称变量的值,值存放到Map集合中
        
//        taskService.getVariable(taskId, variableName);//使用任务ID和流程变量的名称,获取流程变量的值
//        taskService.getVariables(taskId);//使用任务ID,获取所有的流程变量,将流程变量放置到Map集合中,map集合的key就是流程变量的名称,map集合的value就是流程变量的值
//        taskService.getVariables(taskId, variableNames);///使用任务ID,获取流程变量的值,通过设置流程变量的名称存放到集合中,获取指定流程变量名称变量的值,值存放到Map集合中
    }
    

 

 

  说明:

 

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

 

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

 

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

 

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

 

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

 

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

 

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

 

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

 

流程变量的支持的类型

  如图是从官网列出来的流程变量的类型:

从图中可以看出包括了大部分封装类型和DateString和实现了Serializable接口的类的类型。

总结

  流程变量

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

 

   对应的表:

 

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

 

    act_hi_varinst:流程变量历史表

  扩展知识:setVariable和setVariableLocal的区别

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

  setVariableLocal:

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

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

 

  

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