部署流程定义
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表示流程变量的值
流程变量的支持的类型
如图是从官网列出来的流程变量的类型:

从图中可以看出包括了大部分封装类型和Date、String和实现了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说明流程变量绑定了当前的任务,当流程继续执行时,下个任务获取不到这个流程变量(因为正在执行的流程变量中没有这个数据),所有查询正在执行的任务时不能查询到我们需要的数据,此时需要查询历史的流程变量。
浙公网安备 33010602011771号