Activiti 流程变量

Person.java

package com.activiti.test;

import java.io.Serializable;

public class Person implements Serializable {

private static final long serialVersionUID = -606400410705925986L;
private String name;

public String getName() {
return name;
}

public void setName(String name) {
this.name = name;
}
}

VaribablesTest.java

package com.activiti.test;

import java.util.Date;
import java.util.List;

import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.RuntimeService;
import org.activiti.engine.TaskService;
import org.activiti.engine.history.HistoricVariableInstance;
import org.activiti.engine.task.Task;
import org.junit.Test;

public class VariablesTest {

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

/**
* 部署流程定义
*/
@Test
public void deploy() {
InputStream in = this.getClass().getClassLoader().getResourceAsStream("diagrams/leave.zip");
ZipInputStream zipInputStream = new ZipInputStream(in);
Deployment deploy = processEngine.getRepositoryService()
.createDeployment()
.name("请假流程")
.addZipInputStream(zipInputStream)
.deploy();
System.out.println("部署ID：" + deploy.getId());
System.out.println("部署名称：" + deploy.getName());
}

/**
* 启动流程实例
*/
@Test
public void startProcessInstance() {
ProcessInstance pi = processEngine.getRuntimeService().startProcessInstanceByKey("Leave");
System.out.println("流程定义的ID：" + pi.getProcessDefinitionId());
System.out.println("流程实例的ID：" + pi.getId());
}

/**
* 设置流程变量(将变量存放在任务中)
* 流程变量的作用域就是流程实例，所以只要设置就行了，不用管在哪个阶段设置
*/
@Test
public void setVariables() {
TaskService taskService = processEngine.getTaskService();
String assignee = "张三";//任务办理人
String processInstanceId = "37501"; //流程实例ID
//获取当前任务
Task task = taskService.createTaskQuery()
.taskAssignee(assignee)
.processInstanceId(processInstanceId)
.singleResult();
//设置任务变量 （变量中存放基本数据类型）
taskService.setVariable(task.getId(), "请假人", "crystal");
taskService.setVariable(task.getId(), "请假天数", 2);
taskService.setVariable(task.getId(), "请假日期", new Date());
//变量中存放javabean对象，前提：让javabean对象实现implements java.io.Serializable
Person p = new Person();
p.setName("翠花");
taskService.setVariable(task.getId(), "人员信息", p);
taskService.complete(task.getId());
}

/**
* 获取流程变量
*/
@Test
public void queryVariables() {
TaskService taskService = processEngine.getTaskService();
String assignee = "李四";//任务办理人
String processInstanceId = "37501"; //流程实例ID
//获取当前任务
Task task = taskService.createTaskQuery()
.taskAssignee(assignee)
.processInstanceId(processInstanceId)
.singleResult();
/**一：变量中存放基本数据类型*/
//String stringValue = (String) taskService.getVariable(task.getId(), "请假人");
//Integer integerValue = (Integer) taskService.getVariable(task.getId(), "请假天数");
//Date dateValue = (Date) taskService.getVariable(task.getId(), "请假日期");
//System.out.println(stringValue+"     "+integerValue+"     "+dateValue);
/**二：变量中存放javabean对象，前提：让javabean对象实现implements java.io.Serializable*/
/**
* 获取流程变量时注意：流程变量如果是javabean对象，除了要求实现Serializable之外，
* 同时要求流程变量对象的属性不能发生发生变化，否则抛出异常
* 解决方案：在设置流程变量的时候，在javabean的对象中使用：
* private static final long serialVersionUID = -8065294171680448312L;
*/
Person p = (Person) taskService.getVariable(task.getId(), "人员信息");
System.out.println(p.getName());
}

/**
* 查询流程变量的历史表
*/
@Test
public void findHistoryProcessVariables() {
List<HistoricVariableInstance> list = processEngine.getHistoryService()//
.createHistoricVariableInstanceQuery()//创建一个历史的流程变量查询对象
.variableName("请假天数")
.list();
if(list!=null && list.size()>0){
for(HistoricVariableInstance hvi:list){
System.out.println(hvi.getId()+"\n"+hvi.getProcessInstanceId()+"\n"+hvi.getVariableName()+"\n"+hvi.getVariableTypeName()+"\n"+hvi.getValue());
System.out.println("==============================================");
}
}
}
}

说明：

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

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

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

设置变量的时机

设置流程变量

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集合

获取流程变量

runtimeService.getVariable(executionId, variableName);//使用执行对象ID和流程变量的名称，获取流程变量的值

runtimeService.getVariables(executionId);//使用执行对象ID，获取所有的流程变量，将流程变量放置到Map集合中，map集合的key就是流程变量的名称，map集合的value就是流程变量的值

runtimeService.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表示流程变量的值

扩展：setVariable和setVariableLocal的区别

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

setVariableLocal：

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

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