有了前面几章,我们肯定有一定的困惑,activiti如何与实际业务整合,比如一条采购单,如何跟一个流程实例互相关联起来?
这里就需要使用到activiti启动流程实例时设置一个流程实例的businessKey(一般存储我们一条采购单的id)
1,启动流程实例设置其businessKey
/**
* 启动一个流程实例,设置其业务id
*/
@Test
public void startProInsWithKey() {
RuntimeService runtimeService = engine.getRuntimeService(); String processDefinitionKey = "purchasingflow";
//设置一个businessKey,在我实际业务中可能是一个采购单,或者订单之类的id
String businessKey ="111";
// 根据流程定义的key启动一个流程实例
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey,businessKey);
System.out.println("流程实例id:" + processInstance.getId());
System.out.println("流程定义id:" + processInstance.getProcessDefinitionId()); }
一般情况下,我们是在用户保存一条采购单的时候,启动这个实例,并且动态获取采购单的id(也就是用作流程实例的businessKey),并且我们还会在采购单表中保存这个流程实例的id,双向一对一绑定,方便业务查询
2,根据采购单的id(也就是用作流程实例的businessKey),动态的查询出对应的流程实例
/**
* 通过businessKey查询流程实例
*/
@Test
public void queryProInsWithKey(){
RuntimeService runtimeService = engine.getRuntimeService();
String businessKey ="111"; ProcessInstanceQuery instanceQuery = runtimeService.createProcessInstanceQuery();
//根据其流程定义key和业务id businessKey查询出对应的流程实例,一般只有一条
instanceQuery.processInstanceBusinessKey(businessKey);
//查询出唯一的一条流程实例
ProcessInstance processInstance = instanceQuery.singleResult(); System.out.println("流程实例id:"+processInstance.getId());
System.out.println("流程定义id:"+processInstance.getProcessDefinitionId()); }
到这里,我们就清楚了一个流程实例和实际业务数据的绑定
大家到这里也启动了很多的流程实例了,发现我们的任务办理人都是写死为zhangsan,lisi之类的,那么我们可以动态的指定吗,这就需要使用到我们的uel表达式了
首先uel表达式到底是什么呢?
UEL是java EE6规范的一部分,UEL(Unified Expression Language)即统一表达式语言,activiti支持两个UEL表达式:UEL-value和UEL-method。我们都会分别做介绍
(一)我们先来演示uel-value
首先做个简单的使用带大家入门
使用步骤:(看不明白的运行下面的代码走一遍再回头看)
1,在任务的节点,不直接指定处理人的id,设置处理人表达式${assignee},并且重新部署流程定义
2, 启动一个流程实例是设置启动变量动态设置assignee的值
3,查看并验证下一个任务的处理人是否为我们动态设置
1,首先我们设置节点
2,在启动代码时动态设置assignee的值
/**
* 启动流程实例时设置全局变量
*/
@Test
public void startProInsWithArgs(){ RuntimeService runtimeService = engine.getRuntimeService(); String processDefinitionKey = "purchasingflow";
//设置其启动的全局变量参数,其value可以是javabean,也可以是普通字符串,数字
Map<String,Object> variables = new HashMap<String, Object>();
variables.put("assignee", "feige");
//设置流程启动时,设置参数启动
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey,variables);
System.out.println("流程实例id:" + processInstance.getId());
System.out.println("流程定义id:" + processInstance.getProcessDefinitionId()); }
3,这个时候我们通过查看数据库,查看act_ru_task当前运行的任务,查看
从上面的我们可以看到流程走到了,创建采购单,并且采购的assignee处理人为feige
因为当我们走到了创建采购单时,会从当前流程实例的全局变量查找name为assignee的值,如果查询到,则将这个assignee的值赋给这个节点,如果我们动态设置了,但是走到这个节点前(为什么说节点前呢,因为还可以在别的时候设置变量,后面的章节会讲)
没有找到这个assignee变量的值,会报错的,大家可以自己试一试
当然除了上面的设置方法,我们还有其他的设置方法来动态设置其节点的值吗?答案是肯定的,启动的流程时候的参数的value,不仅仅可以是String类型,还可以是Object对象(序列化的),Map,List,Array
我们这里采用对象做演示,执行步骤如下
1,设置流程的第一个节点动态的值为${user.userId},他会默认查找变量name为user的对应的值的getUserId获取值,重新部署流程定义
2,启动流程时,设置这个user的javabean到流程的全局变量中
3,查看走到这个节点的当前任务的处理人是否是我们user的userId变量的值
1,设置节点
2,设置javabean User对象并且在流程实例启动时设置进去
public class User implements Serializable{
/**
* 用于序列化
*/
private static final long serialVersionUID = 7717000074223077256L;
private String userId;
private String sex;
private String name; public User(String userId, String sex, String name) {
super();
this.userId = userId;
this.sex = sex;
this.name = name;
}
public String getUserId() {
return userId;
}
public void setUserId(String userId) {
this.userId = userId;
}
public String getSex() {
return sex;
}
public void setSex(String sex) {
this.sex = sex;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
} }
/**
* 启动流程设置一个user用户到全局变量中
*/
@Test
public void startProInsWithObj(){ RuntimeService runtimeService = engine.getRuntimeService(); String processDefinitionKey = "purchasingflow"; //设置其启动的全局变量参数,其value设置为user对象,这里写死
User user = new User("101","男","张三"); Map<String,Object> variables = new HashMap<String, Object>();
variables.put("user", user);
//设置流程启动时,设置参数启动
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey,variables);
System.out.println("流程实例id:" + processInstance.getId());
System.out.println("流程定义id:" + processInstance.getProcessDefinitionId()); }
3,到这里流程实例启动成功,我们观察数据库的当前任务表,观察第一个节点的处理人是否为我们设置的101的userId
设置成功!
(二)演示uel-method
执行步骤
1,设置节点的执行人为${method.getUserNameByUserId(userId)} ,其中method方法是我们注入到spring中的一个类,userId是我们设置的全局变量
2,将method方法注入到activiti的processEngineConfiguration的bean中(在我们的activiti.cfg.xml中)
3,启动一个流程设置全局变量userId作为启动参数,看看是否走到这个节点的处理人是我们method方法getUserNameByUserId返回的name
好了,直接上代码
1,设置节点,重新部署流程定义
2,method的java方法和activiti.cfg.xml的注入配置
public class CommonMethod{ public String getUserNameByUserId(int userId){ return "activiti"+userId; } }
<bean class="cn.nfcm.po.CommonMethod" id="commonmethod"></bean> <bean id="processEngineConfiguration"
class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
<!-- 数据源 -->
<property name="dataSource" ref="dataSource" />
<!-- activiti数据库表处理策略 -->
<property name="databaseSchemaUpdate" value="true" />
<!-- 可以注入多个类到activiti的beans中,其中key对应的就是我们的类名 -->
<property name="beans">
<map>
<entry key="commonmethod" value-ref="commonmethod" />
</map>
</property>
</bean>
3,启动一个流程实例
/**
* 根据方法得到值
*/
@Test
public void startProInsWithMethod(){ RuntimeService runtimeService = engine.getRuntimeService(); String processDefinitionKey = "purchasingflow";
//这里设置userId为8,走到第一个节点会查找我们注入进去的commonmethod的getUserNameByUserId方法并传递userId
Map<String,Object> variables = new HashMap<String, Object>();
variables.put("userId", 8); //设置流程启动时,设置参数启动
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey,variables);
System.out.println("流程实例id:" + processInstance.getId());
System.out.println("流程定义id:" + processInstance.getProcessDefinitionId()); }
到这里我们会发现流程启动成功,并且流程的当前任务处理人为acitiviti8,在实际的应用中因为都是spring管理的类,我们可以进行多种多样的查询赋值,非常方便!