分享一下手把手教你如何玩转Activiti工作流
还未完善
场景：学校
主角：阿毛 ， 班主任 ，教务处处长
问题：有一天，阿毛到学校，感觉到身体不舒服，然后想跟班主任请假，然后班主任告诉阿毛说，你想请假，那么就必须要请假条，这个上面必须要我同意，然后再拿到教务处去盖章，然后交给我，这样才可以进行请假。。阿毛，想着，怎么请个假都这么麻烦，这么多层次处理问题，能不能简便一点。。。。好烦好烦~！！~~
分析：从上面的小例子，我们可以很明显的得到一个结论，就是：
请假流程：阿毛------》提交申请-----》班主任审批-----》教务处审批-----》请假成功
也就是说，这种问题就是一种流式的控制管理，当然，这是最简单的，因为里面没有包含着回馈，相当于只是一个方向。其实，到这里，Activiti的定义就已经出来了。。。。。
大纲：
之前做过一些项目没有用到工作流，都是以状态控制整个流程，现在系统化的将工作流分享一下
使用activiti-designer-5.18.0.zip
2.创建SpringBoot工程
①编辑POM文件
代码语言：javascript复制<!-- 继承SpringBoot官方指定的父工程 -->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.5.12.RELEASE</version>
</parent>
<dependencies>
<!-- MySQL驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>
<!-- 数据库连接池 -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.0.5</version>
</dependency>
<!-- MyBatis场景启动器 -->
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>1.1.1</version>
</dependency>
<!-- Activiti场景启动器 -->
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-spring-boot-starter-basic</artifactId>
<version>5.21.0</version>
</dependency>
<!-- 基本场景启动器 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<!-- SpringBoot测试支持 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
</dependency>
</dependencies>特别说明：请把mybatis-spring-boot-starter的依赖放在activiti-spring-boot-starter-basic的前面以避免jar包冲突问题。jar包冲突的表现是：java.lang.ClassNotFoundException: org.apache.ibatis.annotations.Mapper。
依赖顺序和依赖传递的关系： mybatis-spring-boot-starter依赖mybatis-3.4.0.jar，而activiti-spring-boot-starter-basic依赖mybatis-3.3.0.jar，对于这种情况，Maven以顺序靠前的为准。现在如果导入的是mybatis-3.3.0.jar就会抛出异常，而mybatis-3.4.0.jar是正确的，所以要让mybatis-spring-boot-starter的依赖放在activiti-spring-boot-starter-basic的前面。
②主启动类
代码语言：javascript复制@SpringBootApplication
public class MainApplication {
public static void main(String[] args) {
SpringApplication.run(MainApplication.class, args);
}
}③测试类
代码语言：javascript复制@RunWith(SpringRunner.class)
@SpringBootTest
public class ProcessTest {
@Autowired
private ProcessEngine processEngine;
@Test
public void createTable() {
System.out.println(processEngine);
}
}④yml配置
代码语言：javascript复制spring:
datasource:
name: mydb
type: com.alibaba.druid.pool.DruidDataSource
url: jdbc:mysql://127.0.0.1:3306/db_activiti
username: root
password: root
driver-class-name: com.mysql.jdbc.Driver⑤特别操作
在src/main/java目录下创建processes目录，否则将抛出异常：java.io.FileNotFoundException: class path resource [processes/] cannot be resolved to URL because it does not exist。processes目录的作用是存放bpmn流程定义文件，并对bpmn文件进行自动部署。如果创建到src/main/resources目录下则要求processes目录下至少存在一个文件（任意）。
三、流程操作
1.创建第一个流程图
2.流程部署
①Java代码
注意：如果放在processes目录下会被自动部署，下面的Java代码是手动部署。
代码语言：javascript复制@RunWith(SpringRunner.class)
@SpringBootTest
public class ProcessTest {
@Autowired
private RepositoryService repositoryService;
@Test
public void test01ProcessDefinitionDeployment() {
//部署：将流程定义文件中流程定义信息存入数据库
repositoryService
.createDeployment() //创建部署构建器对象
.addClasspathResource("MyProcess.bpmn") //添加要部署的流程定义文件名
.deploy(); //执行部署
}
}②数据库表分析
[1]act_ge_bytearray表
二进制数据表，存储了流程定义图形的XML文件和图片信息 保存流程定义的xml信息 保存流程定义的图片
[2]act_re_deployment表
部署信息表，存储了部署的相关信息(部署时间)
[3]act_re_procdef表
流程定义数据表，存储了当前流程图形的相关信息(id,name,版本号)
③解决乱码问题
代码语言：javascript复制import org.activiti.spring.SpringProcessEngineConfiguration;
import org.activiti.spring.boot.ProcessEngineConfigurationConfigurer;
import org.springframework.context.annotation.Configuration;
@Configuration
public class ActivitiConfig implements ProcessEngineConfigurationConfigurer {
@Override
public void configure(SpringProcessEngineConfiguration processEngineConfiguration) {
processEngineConfiguration.setActivityFontName("宋体");
processEngineConfiguration.setLabelFontName("宋体");
}
}3.流程查询
①第一步：创建ProcessDefinitionQuery对象
代码语言：javascript复制 @Test
public void test02ProcessDefinitionQuery() {
//1.创建流程定义查询对象
ProcessDefinitionQuery query = repositoryService.createProcessDefinitionQuery();
//2.调用对应的方法执行查询
List<ProcessDefinition> list = query.list();
//3.遍历集合
for (ProcessDefinition processDefinition : list) {
String key = processDefinition.getKey();
String name = processDefinition.getName();
int version = processDefinition.getVersion();
System.err.println("key=" key);
System.err.println("name=" name);
System.err.println("version=" version);
}
}
注意2：创建了新的流程定义需要再次执行部署，再次启动流程。
6.查询任务和7.完成任务
代码语言：javascript复制@Test
public void test03TaskQuery() {
//创建任务查询对象
TaskQuery query = taskService.createTaskQuery();
//根据流程定义key和委托人查询待办任务
List<Task> list = query.processDefinitionKey("MyProcess").taskAssignee("zuzu").list();
for (Task task : list) {
String assignee = task.getAssignee();
String taskId = task.getId();
String taskName = task.getName();
//taskService需要使用@Autowired注解装配
taskService.complete(task.getId());//完成任务，使任务进入下一步
System.err.println("assignee=" assignee);
System.err.println("taskId=" taskId);
System.err.println("taskName=" taskName);
}
}8.查询流程实例历史
代码语言：javascript复制//1.创建流程实例的历史查询对象，historyService使用@Autowired注解注入
HistoricProcessInstanceQuery query = historyService.createHistoricProcessInstanceQuery();
HistoricProcessInstance instance =
query.processInstanceId("7501") //流程实例的id
.finished()//调用这个方法后未完成的流程实例会返回null
.singleResult();
System.out.println(instance);9.将任务指派给一个组
注意1：创建的新的流程定义要指定一个新的id。 注意2：创建了新的流程定义需要再次执行部署，再次启动流程。
10.领取任务
代码语言：javascript复制 @Test
public void test04Claim() {
//1.创建任务查询对象
TaskQuery taskQuery = taskService.createTaskQuery();
//2.根据任务委托组查询任务列表
List<Task> list = taskQuery.taskCandidateGroup("jingli").list();
//3.遍历
for (Task task : list) {
String taskId = task.getId();
String userId = "jingli";
//3.指派任务
taskService.claim(taskId, userId);
}
}提示：可以根据任务委托人在领取任务前和领取任务后分别查询任务，之前没有之后有即为正确。
代码语言：javascript复制TaskQuery query = taskService.createTaskQuery();//创建任务查询对象
List<Task> list = query.processDefinitionKey("MyProcess") //指定流程定义
.taskAssignee("jingli")//指定委托人
.list();//执行查询
for (Task task : list) {
System.out.println(task);
}11.流程变量
①在创建流程定义时指定流程变量
例如：用变量的方式指定委托人
创建MyProcess02.bpmn
创建后正常部署
代码语言：javascript复制 @Test
public void test01ProcessDefinitionDeployment() {
//部署：将流程定义文件中流程定义信息存入数据库
repositoryService
.createDeployment() //创建部署构建器对象
.addClasspathResource("MyProcess02.bpmn") //添加要部署的流程定义文件名
.deploy(); //执行部署
}②启动
代码语言：javascript复制 @Test
public void test05StartProcessInstance() {
//1.查询流程定义对象
ProcessDefinition processDefinition =
repositoryService.createProcessDefinitionQuery()
.processDefinitionKey("MyProcess02")
.latestVersion()
.singleResult();
//2.获取流程定义的id
String processDefinitionId = processDefinition.getId();
//3.使用RunTimeService根据流程定义id启动流程定义
ProcessInstance processInstance = runtimeService.startProcessInstanceById(processDefinitionId);
//4.打印processInstance对象
System.err.println(processInstance);
}带有变量的流程启动时，如果第一个任务中就存在变量，那么启动的时候就必须给出变量值。否则将抛出异常：org.activiti.engine.impl.javax.el.PropertyNotFoundException: Cannot resolve identifier 'erzi'
@Test
public void test06StartProcessInstanceWithVariable() {
//1.查询流程定义对象
ProcessDefinition processDefinition =
repositoryService.createProcessDefinitionQuery()
.processDefinitionKey("MyProcess02")
.latestVersion()
.singleResult();
//2.获取流程定义的id
String processDefinitionId = processDefinition.getId();
//※为第一个任务指定流程变量
Map<String,Object> variables = new HashMap<String, Object>();
variables.put("erzi", "zhangsan");
//3.使用RunTimeService根据流程定义id启动流程定义
ProcessInstance processInstance = runtimeService.startProcessInstanceById(processDefinitionId, variables);
//4.打印processInstance对象
System.err.println(processInstance);
}③完成任务
如果完成当前任务时，下一个任务中包含变量，那么此时也必须给出下一个任务的变量值
代码语言：javascript复制 @Test
public void test7CompleteTaskWithVariables() {
List<Task> list =
taskService.createTaskQuery() //创建任务查询对象
.processDefinitionKey("MyProcess02")//指定流程定义
.taskAssignee("zhangsan")//指定委托人
.list();//执行查询
for (Task task : list) {
String taskId = task.getId();
//在完成当前任务时，为下一个任务指定流程变量
Map<String,Object> variables = new HashMap<String, Object>();
variables.put("sunzi", "lisi");
//完成当前任务时为下一个任务指定变量值
taskService.complete(taskId, variables);//完成任务，使任务进入下一步
//Unknown property used in expression: ${sunzi}
//taskService.complete(taskId);
}
}12.排他网关
①创建流程定义
部署、启动
代码语言：javascript复制 @Test
public void test01ProcessDefinitionDeployment() {
//部署：将流程定义文件中流程定义信息存入数据库
repositoryService
.createDeployment() //创建部署构建器对象
.addClasspathResource("MyProcess03.bpmn") //添加要部署的流程定义文件名
.deploy(); //执行部署
} @Test
public void test05StartProcessInstance() {
//1.查询流程定义对象
ProcessDefinition processDefinition =
repositoryService.createProcessDefinitionQuery()
.processDefinitionKey("MyProcess03")
.latestVersion()
.singleResult();
//2.获取流程定义的id
String processDefinitionId = processDefinition.getId();
//3.使用RunTimeService根据流程定义id启动流程定义
ProcessInstance processInstance = runtimeService.startProcessInstanceById(processDefinitionId);
//4.打印processInstance对象
System.err.println(processInstance);
}②完成第一个任务时为排他网关指定变量值
@Test
public void test7CompleteTaskWithVariables() {
List<Task> list =
taskService.createTaskQuery() //创建任务查询对象
.processDefinitionKey("MyProcess03")//指定流程定义
.taskAssignee("zhangsan")//指定委托人
.list();//执行查询
for (Task task : list) {
String taskId = task.getId();
//在完成当前任务时，为下一个任务指定流程变量
Map<String,Object> variables = new HashMap<String, Object>();
variables.put("day", "5");
//完成当前任务时为下一个任务指定变量值
taskService.complete(taskId, variables);//完成任务，使任务进入下一步
//Unknown property used in expression: ${sunzi}
//taskService.complete(taskId);
}
}
[3]创建流程监听器类
代码语言：javascript复制import org.activiti.engine.delegate.DelegateExecution;
import org.activiti.engine.delegate.ExecutionListener;
public class YesListener implements ExecutionListener {
private static final long serialVersionUID = 1L;
@Override
public void notify(DelegateExecution execution) throws Exception {
System.err.println("YesListener触发了！！！");
}
}import org.activiti.engine.delegate.DelegateExecution;
import org.activiti.engine.delegate.ExecutionListener;
public class NoListener implements ExecutionListener {
private static final long serialVersionUID = 1L;
@Override
public void notify(DelegateExecution execution) throws Exception {
System.err.println("NoListener触发了！！！");
}
}[4]绑定监听器
④操作
部署
代码语言：javascript复制 /**
* 部署
*/
@Test
public void test01ProcessDefinitionDeployment() {
//部署：将流程定义文件中流程定义信息存入数据库
repositoryService
.createDeployment() //创建部署构建器对象
.addClasspathResource("MyProcess04.bpmn") //添加要部署的流程定义文件名
.deploy(); //执行部署
}启动
代码语言：javascript复制 /**
* 启动流程
*/
@Test
public void test05StartProcessInstance() {
//1.查询流程定义对象
ProcessDefinition processDefinition =
repositoryService.createProcessDefinitionQuery()
.processDefinitionKey("MyProcess04")
.latestVersion()
.singleResult();
//2.获取流程定义的id
String processDefinitionId = processDefinition.getId();
//3.使用RunTimeService根据流程定义id启动流程定义
ProcessInstance processInstance = runtimeService.startProcessInstanceById(processDefinitionId);
//4.打印processInstance对象
System.err.println(processInstance);
}完成任务时为排他网关指定flag变量值
代码语言：javascript复制 /**
* 完成任务
*/
@Test
public void test7CompleteTaskWithVariables() {
List<Task> list =
taskService.createTaskQuery() //创建任务查询对象
.processDefinitionKey("MyProcess04")//指定流程定义
.taskAssignee("zhangsan")//指定委托人
.list();//执行查询
for (Task task : list) {
String taskId = task.getId();
//在完成当前任务时，为下一个任务指定流程变量
Map<String,Object> variables = new HashMap<String, Object>();
variables.put("flag", "true");
//完成当前任务时为下一个任务指定变量值
taskService.complete(taskId, variables);//完成任务，使任务进入下一步
//Unknown property used in expression: ${sunzi}
//taskService.complete(taskId);
}
}观察监听器执行情况
