在流程实例运行过程中,难免要记录或者保存一些数据,然后运行到某个节点的时候,取数据查看,或者是后面学到流程分支的时候 判断流程走向,都要用到一些数据存储。
这里就引入了一个新的概念,流程变量,顾名思义,就是流程中用来存储数据的变量;
Activiti中基本支持所有的基本数据类型作为流程变量,以及支持序列化对象,所以也可以存一个对象;当然实际开发的话,还是要建立一些业务表,来存储业务数据;简单的数据,可以存到到流程变量,比较方便;
根据一个流程定义可以启动很多流程实例,每个流程实例里的流程变量都是独立的,互不影响,这个概念要分清楚;
下面我来通过一些实例,来学习下流程变量,以及Activiti给我们提供的接口;
首先我来画一个新的流程定义:

这个大家自己画下,一个学生请假流程,流程定义的Id,Name大家自己取下名字,以及“提交请假申请”,“辅导员审批”任务节点的办理人大家自己随便搞个即可;
接下来新建一个ProcessVariableTest.java测试类:
我们把前面写的代码copy过来改改:
首先是deploy流程部署方法:
package com.java1234.activiti.test;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.repository.Deployment;
import org.junit.Test;
public class ProcessVariableTest {
/**
* 获取默认的流程引擎实例 会自动读取activiti.cfg.xml文件
*/
private ProcessEngine processEngine=ProcessEngines.getDefaultProcessEngine();
/**
* 部署流程定义
*/
@Test
public void deploy(){
// 获取部署对象
Deployment deployment=processEngine.getRepositoryService() // 部署Service
.createDeployment() // 创建部署
.addClasspathResource("diagrams/StudentLeaveProcess.bpmn") // 加载资源文件
.addClasspathResource("diagrams/StudentLeaveProcess.png") // 加载资源文件
.name("学生请假流程") // 流程名称
.deploy(); // 部署
System.out.println("流程部署ID:"+deployment.getId());
System.out.println("流程部署Name:"+deployment.getName());
}
}/**
* 启动流程实例
*/
@Test
public void start(){
// 启动并获取流程实例
ProcessInstance processInstance=processEngine.getRuntimeService() // 运行时流程实例Service
.startProcessInstanceByKey("studentLeaveProcess"); // 流程定义表的KEY字段值
System.out.println("流程实例ID:"+processInstance.getId());
System.out.println("流程定义ID:"+processInstance.getProcessDefinitionId());
}然后我们运行start方法 ,启动流程实例,这样一个新的流程实例就产生并且开始运行了。
这时候到了 “学生请假提交”任务节点,这时候我们可以添加一些流程变量,比如请假日期,请假天数,请假原因,当然这里为了演示Activiti还支持序列化对象,
我们这里再加一个请假的学生对象信息;
所以我们建一个实现了序列化接口的实体类Student:
package com.java1234.activiti.model;
import java.io.Serializable;
public class Student implements Serializable{
/**
*
*/
private static final long serialVersionUID = 1L;
private Integer id;
private String name;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public static long getSerialversionuid() {
return serialVersionUID;
}
}下面我们来设置下流程变量:
/**
* 设置流程变量以及值
*/
@Test
public void setVariablesValues(){
TaskService taskService=processEngine.getTaskService(); // 任务Service
String taskId="2504"; // 任务id
taskService.setVariableLocal(taskId, "days", 2); // 存Integer类型
taskService.setVariable(taskId, "date", new Date()); // 存日期类型
taskService.setVariable(taskId, "reason", "发烧"); // 存字符串
Student student=new Student();
student.setId(1);
student.setName("张三");
taskService.setVariable(taskId, "student", student); // 存序列化对象
}这里我们来说明下,首先要设置流程变量,我们需要获取Service,这里的话,TaskService可以设置变量,RuntimeService也可以设置流程变量。
假如节点不是任务节点的时候,我们只能用RuntimeService。接口和方法和TaskService一样的;
这里我们设置了 请假日期,请假天数,请假理由,请假对象。当然这里set变量的时候 需要一个任务ID,大家可以从任务表里去找;
后面的变量都是key:value形式,这里的key当然也可以用中文,设置的时候也可以一次性设置多个变量,都有重载方法的;大家自行研究下;
我们执行下这个方法,会对应的把数据库查询到对应的流程变量表中,当然那个对象序列的话,特殊点,存到了字节文件表里去了;
当然这里还要讲一个概念,就是全局流程实例变量和任务节点本地变量;
setVariableLocal 和 setVariable 前者仅仅在某个任务节点有作用 后者在整个流程实例都有效;
一般开发用后者即可。后面我们可以演示下效果;
OK我们继续走流程
/**
* 完成任务
*/
@Test
public void completeTask(){
processEngine.getTaskService() // 任务相关Service
.complete("2504"); // 指定要完成的任务ID
}我们执行completeTask即可;这样我们的执行到了 “辅导员审批”任务节点;
我们可以来获取“学生请假提交”任务节点设置的流程变量值;
/**
* 获取流程变量以及值
*/
@Test
public void getVariablesValue(){
TaskService taskService=processEngine.getTaskService(); // 任务Service
String taskId="7502"; // 任务id
Integer days=(Integer) taskService.getVariable(taskId, "days");
Date date=(Date) taskService.getVariable(taskId, "date");
String reason=(String) taskService.getVariable(taskId, "reason");
Student student=(Student) taskService.getVariable(taskId, "student");
System.out.println("请假天数:"+days);
System.out.println("请假日期:"+date);
System.out.println("请假原因:"+reason);
System.out.println("请假对象:"+student.getId()+","+student.getName());
}这里的任务Id是新的,我们可以去运行时任务表里去找;
我们运行下,结果如下:
SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder". SLF4J: Defaulting to no-operation (NOP) logger implementation SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details. 请假天数:null 请假日期:Tue Apr 26 13:32:22 CST 2016 请假原因:发烧 请假对象:1,张三
我们发现,天数没取到,原因上面讲了,是任务节点本地变量,只有在前面那个节点作用域内有效,所以在这个节点是取不到的;
其他的数据都取到了,包括对象;
OK 我们先把流程走完,继续执行completeTask方法 ,当然任务ID现在变成了7502,你们的改成对应的即可;
OK。这样流程是完了,这里关于流程变量,我们还可以在启动流程的时候设置,

完成当前任务,流向下一个节点的时候,也可以设置流程变量:

OK 当然流程变量不能什么数据都放里面,有些复杂的,大块数据,我们要自己定义业务表;
还有流程变量的其他用法,我们后面再具体介绍。大家把这些先掌握即可;
完整代码:http://pan.baidu.com/s/1kVo35iB
下一篇:四B象限图