相信通过前面的学习,你已经了解到activiti绘制图案的几个概念,比如监听器,提交表单属性,路线分发(根据参数条件),如果你看到这几个字眼特别陌生,那我建议你可以去百度或者google一下,案例想对还算丰富的,这不是此文介绍的关键,本系列旨在给读者一个良好的学习方向,少走一些弯路。
这里我将贴出demo示例相关代码,内附注释,各位私下理解一下。
流程图
流程图说明:
在请假流程事件内附带form,里面有4个属性,由于我设置Require都是true,所以是必填项,这里需要注意的是submitType只能为y或者n(不分大小写),form属性如下图:
你可能会问为什么只能输入y或者n?因为我在下一个节点exclusiveGateway,也就是显示为X号的节点设置了${submitType=="y" || submitType=="Y"}
时的线指向部门主管审批,设置 ${submitType=="n" || submitType=="N"}
时指向结束节点,如下两张图所示:
图2:
同样的,后面每一个X型图案对应的两条走向都是有此判断条件来作为基础的,具体可以复制我的图案到你的eclipse,或者idea内查看详情。
同时,这里我的部门主管和经理,还可以设置指定的人选,由于我们这个demo是在main方法内简单走流程,所以你可以看到我设置的zhangsan为部门主管,lisi为部门经理。
代码介绍及代码地址
在简单说明了一下步骤之后,我想你可能看着你的idea已经跃跃欲试了,接下来把此示例的代码流程简单串一遍,先看一下项目结构,很简单拉,就一个java类,一个bpmn文件,是我们在eclipse绘制好的:
我觉得在看代码之前我应该先抛出一个activiti的数据持久化的概念,首先它是支持持久化到mysql数据库的,对应的有它自己的表,这个表不用我们手动创建,通过相关配置后activiti自动帮我们实现,这个在后面的文章中会讲到,并且我会吧每张表的作用贴出来供大家参考,此篇是基于h2内存来完成的,所以表是看不到的,想看表,就跟着我一篇一篇看吧,哈哈。
贴一下pom依赖:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.6.RELEASE</version>
</parent>
<artifactId>activiti6-leave-process</artifactId>
<groupId>com.haohuo</groupId>
<version>1.0-SNAPSHOT</version>
<modelVersion>4.0.0</modelVersion>
<dependencies>
<!-- springboot2.x下Activiti的starter依赖 -->
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-spring-boot-starter-basic</artifactId>
<version>6.0.0</version>
</dependency>
<!-- 较受欢迎的日志组建,类似于log4j -->
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.1.11</version>
</dependency>
<!-- 常用类 -->
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>23.0</version>
</dependency>
<!-- h2内存级数据库 -->
<dependency>
<groupId>com.h2database</groupId>
<artifactId>h2</artifactId>
<version>1.3.176</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<fork>true</fork>
</configuration>
</plugin>
</plugins>
</build>
</project>
在贴一下我们的DemoMain java类,我不想多写什么来解释了,注释都在代码内,大家自行理解,需要说明的是这里使用的scanner来完成流程的提交,大家可以拿上我的,或者你的文件去玩一下,如果想要我的,可以到文末的github地址将我完整示例下载下来跑一下:
package com.haohuo;
import com.google.common.collect.Maps;
import org.activiti.engine.*;
import org.activiti.engine.form.FormProperty;
import org.activiti.engine.form.TaskFormData;
import org.activiti.engine.impl.form.DateFormType;
import org.activiti.engine.impl.form.StringFormType;
import org.activiti.engine.repository.Deployment;
import org.activiti.engine.repository.DeploymentBuilder;
import org.activiti.engine.repository.ProcessDefinition;
import org.activiti.engine.runtime.ProcessInstance;
import org.activiti.engine.task.Task;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.List;
import java.util.Map;
import java.util.Scanner;
/**
* @Auther: Zhang Peike
* @Date: 2019/7/3 09:48
*/
public class DemoMain {
private static final Logger logger = LoggerFactory.getLogger(DemoMain.class);
public static void main(String[] args) throws ParseException {
logger.info("开始请假流程 . . .");
// 创建流程引擎
ProcessEngine processEngine = getProcessEngine();
// 部署流程定义文件
ProcessDefinition processDefinition = getProcessDefinition(processEngine);
// 启动运行流程
ProcessInstance processInstance = getProcessInstance(processEngine, processDefinition);
// 处理流程任务
processTask(processEngine, processInstance);
logger.info("结束请假流程 . . ");
}
/**
* 处理流程任务
* @param processEngine
* @param processInstance
* @throws ParseException
*/
private static void processTask(ProcessEngine processEngine, ProcessInstance processInstance) throws ParseException {
Scanner scanner = new Scanner(System.in);
while (processInstance != null && !processInstance.isEnded()) { //判断流程不为空,且流程没有结束
TaskService taskService = processEngine.getTaskService();
List<Task> list = taskService.createTaskQuery().list(); //列出当前需要处理的任务
logger.info("待处理任务数量 [{}]", list.size());
for (Task task : list) {
logger.info("待处理任务 [{}]", task.getName());
Map<String, Object> variables = getMap(processEngine, scanner, task); //获取用户的输入信息
taskService.complete(task.getId(),variables);
processInstance = processEngine.getRuntimeService().createProcessInstanceQuery()
.processInstanceId(processInstance.getId()).singleResult();
}
}
scanner.close();
}
/**
* 获取用户的输入信息
* @param processEngine
* @param scanner
* @param task
* @return
* @throws ParseException
*/
private static Map<String, Object> getMap(ProcessEngine processEngine, Scanner scanner, Task task) throws ParseException {
FormService formService = processEngine.getFormService(); //通过formService来获取form表单输入
TaskFormData taskFormData = formService.getTaskFormData (task.getId());
List<FormProperty> formProperties = taskFormData.getFormProperties(); //获取taskFormData的表单内容
Map<String,Object> variables = Maps.newHashMap(); //这个Map键值对来存对应表单用户输入的内容
for (FormProperty property : formProperties){ //property为表单中的内容
String line = null; //这里获取输入的信息
if(StringFormType.class.isInstance(property.getType())){ //如果是String类型的话
logger.info("请输入 [{}] ?" , property.getName()); //输入form表单的某一项内容
line = scanner.nextLine();
variables.put(property.getId(),line);
}else if(DateFormType.class.isInstance(property.getType())){ //如果是日期类型的话
logger.info("请输入 [{}] ? 格式为(yyyy-MM-dd)" , property.getName()); //输入form表单的某一项内容
line = scanner.nextLine();
SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd"); //设置输入的日期格式
Date date = dateFormat.parse(line);
variables.put(property.getId(),date);
}else{
logger.info("类型不支持 [{}]",property.getType());
}
logger.info("您输入的内容是 [{}] " , line);
}
return variables;
}
/**
* 启动运行流程
*
* @param processEngine
* @param processDefinition
*/
private static ProcessInstance getProcessInstance(ProcessEngine processEngine, ProcessDefinition processDefinition) {
RuntimeService runtimeService = processEngine.getRuntimeService(); //启动流程要有一个运行时对象
ProcessInstance processInstance = runtimeService.startProcessInstanceById(processDefinition.getId()); //这里我们根据processDefinition的ID来启动
logger.info("启动流程 [{}]", processInstance.getProcessDefinitionKey());
return processInstance;
}
/**
* 部署流程定义文件
*
* @param processEngine
* @return
*/
private static ProcessDefinition getProcessDefinition(ProcessEngine processEngine) {
RepositoryService repositoryService = processEngine.getRepositoryService(); //创建一个对流程编译库操作的Service
DeploymentBuilder deploymentBuilder = repositoryService.createDeployment(); //获取一个builder
deploymentBuilder.addClasspathResource("LeaveProcess.bpmn"); //这里写上流程编译路径
Deployment deployment = deploymentBuilder.deploy(); //部署
String deploymentId = deployment.getId(); //获取deployment的ID
ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery().deploymentId(deploymentId).singleResult(); //根据deploymentId来获取流程定义对象
logger.info("流程定义文件 [{}] , 流程ID [{}]", processDefinition.getName(), processDefinition.getId());
return processDefinition;
}
/**
* 创建流程引擎
*
* @return
*/
private static ProcessEngine getProcessEngine() {
ProcessEngineConfiguration cfg = ProcessEngineConfiguration.createStandaloneInMemProcessEngineConfiguration(); //创建默认的基于内存数据库的流程引擎配置对象
ProcessEngine processEngine = cfg.buildProcessEngine(); //构造流程引擎
String engineName = processEngine.getName(); //获取流程引擎的name
String version = ProcessEngine.VERSION; //获取流程引擎的版本信息
logger.info("流程引擎名称 [{}], 版本 [{}]", engineName, version);
return processEngine;
}
}
本文代码地址:https://github.com/producted/activiti-learn/tree/master/activiti6-leave-process