JBPM学习(五)：流程变量

1.启动流程实例

// 启动流程实例
@Test
public void startProcessInstance() {
	// 使用指定key的最新版本的流程定义启动流程实例
	ProcessInstance pi = processEngine.getExecutionService().startProcessInstanceByKey("test");
	System.out.println("processInstanceId=" + pi.getId());
}

2.设置流程变量

a) 一个设置流程变量实例

//设置流程变量
@Test
public void setVariable() {
	String executionId = "test.140001";
	String name = "请假天数";
	Integer value = 3;

	//将name为"请假天数",value=3的流程变量设置到executionId为test.140001的执行对象上
	processEngine.getExecutionService().setVariable(executionId, name, value);
}

b) 所有设置流程变量方法

用到变量的类型：

Object value = "";
String executionId = "";
String taskId = "";
String name = "";
String processDefinitionKey = "";
String variableName = "";
Set<String> variableNames = new HashSet<String>();
Map<String, Object> variablesMap = new HashMap<String, Object>();

具体方法：

// 根据Execution设置一个流程变量
processEngine.getExecutionService().setVariable(executionId, name, value);
// 根据Execution设置多个流程变量（需要先把流程变量放到一个Map中）
processEngine.getExecutionService().setVariables(executionId, variablesMap);

// 根据Task设置多个流程变量（需要先把流程变量放到一个Map中,通过Task方法,它会先找到它所属的Execution然后设置流程变量）
processEngine.getTaskService().setVariables(taskId, variablesMap);

// 使用指定key的最新版本的流程定义启动流程实例，并设置一些流程变量
processEngine.getExecutionService().startProcessInstanceByKey(processDefinitionKey, variablesMap);
// 办理完指定的任务，并设置一些流程变量
processEngine.getTaskService().completeTask(taskId, variablesMap);

3.获取流程变量

a) 一个获取流程变量实例

//获取流程变量
@Test
public void getVariable() {
	String executionId = "test.140001";
	String variableName = "请假天数";

	//从executionId为test.140001的执行对象上取出流程变量名为"请假天数"的流程变量的value
	Integer value = (Integer) processEngine.getExecutionService().getVariable(executionId, variableName);
	System.out.println(variableName + " = " + value);
}

b) 所有获取流程变量方法

用到变量的类型：

String executionId = "";
String taskId = "";
String variableName = "";
Set<String> variableNames = new HashSet<String>();

具体方法：

// 根据Execution获取指定名称的一个流程变量
processEngine.getExecutionService().getVariable(executionId, variableName);
// 根据Execution获取所有流程变量的名称
processEngine.getExecutionService().getVariableNames(executionId);
// 根据Execution获取指定名称的所有流程变量
processEngine.getExecutionService().getVariables(executionId, variableNames);

// 根据Task获取指定名称的一个流程变量
processEngine.getTaskService().getVariable(taskId, variableName);
// 根据Task获取所有流程变量的名称
processEngine.getTaskService().getVariableNames(taskId);
// 根据Task获取指定名称的所有流程变量
processEngine.getTaskService().getVariables(taskId, variableNames);

4.流程变量所支持的值的类型(jBPM User Guide，7.2. Variable types)

jBPM supports following Java types as process variables:

• java.lang.String 
• java.lang.Long 
• java.lang.Double 
• java.util.Date 
• java.lang.Boolean 
• java.lang.Character 
• java.lang.Byte 
• java.lang.Short 
• java.lang.Integer 
• java.lang.Float 
• byte[] (byte array) 
• char[] (char array) 
• hibernate entity with a long id 
• hibernate entity with a string id 
• serializable

For persistence of these variable, the type of the variable is checked in the order of this list. The first match will determine how the variable is stored.