介绍工作流
网上工作流的定义一大堆，这里就不去复制了，通俗的理解，工作流就是类似OA系统中请假审批、报销审批等一系列流程，下级提交的申请只有直系领导才能审批，其他人是没有权限的，而只有直系领导审批通过后，直系领导的直系领导才可以看到申请，并进行审批，以此类推。。。
而Activiti工作流就可以实现类似的功能，本笔记将以最简单的方式让你明白怎么使用Activiti工作流，直接上代码
准备环境
1) JDK1.6或者更高版本
2) 支持的数据库有：h2, mysql, oracle, postgres, mssql, db2等。
3) 支持activiti5运行的jar包
4) 开发环境为Eclipse3.7或者以上版本,myeclipse为8.6版本
安装流程设计器(eclipse插件)
方案一：
在有网络的情况下，安装流程设计器步骤如下：
1) 打开 Help -> Install New Software. 在如下面板中:
2) 在如下Install界面板中，点击Add按钮：
3) 然后填入下列字段
Name: Activiti BPMN 2.0 designer
Location: http://activiti.org/designer/update/
4) 回到Install界面，在面板正中列表中把所有展示出来的项目都勾上：
5) 点击复选框
在Detail部分记得选中 "Contact all updates sites.." , 因为它会检查所有当前安装所需要的插件并可以被Eclipse下载.
6) 安装完以后，点击新建工程new->Other…打开面板，如果看到下图内容：
说明安装成功了。
方案二
在没有网络的情况下，安装流程设计器步骤如下：
首先下载离线插件包：
https://files.cnblogs.com/files/lm970585581/activiti.zip
将压缩包解压后
这两个文件夹复制到Eclipse根目录下 ，重启即可
注意：
打开菜单Windows->Preferences->Activiti->Save下流程流程图片的生成方式:
虽然流程引擎在单独部署bpmn文件时会自动生成图片，但在实际开发过程中，自动生成的图片会导致和BPMN中的坐标有出入，在实际项目中展示流程当前位置图会有问题。
所在完成以上配置后，会由我们自己来管理流程图片。在发布流程时把流程规则文件和流程图片一起上传就行了。
准备Activiti5开发环境
在activiti-5.13->wars目录下是一些示例项目，解压activiti-rest项目，导入activiti-rest目录中WEB-INF\lib下所有包。添加到classpath中。
另外需要根据我们正在使用的数据库添加相应的数据库jar包
初始化数据库
可以在activiti-rest\WEB-INF\classes下找到配置文件：如下
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-2.5.xsd
http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.0.xsd">
<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
<property name="jdbcDriver" value="com.mysql.jdbc.Driver"></property>
<property name="jdbcUrl" value="jdbc:mysql://192.168.220.130:3306/activiti?useUnicode=true&characterEncoding=utf8"></property>
<property name="jdbcUsername" value="root"></property>
<property name="jdbcPassword" value="root"></property>
<!--
创建表的策略
-->
<property name="databaseSchemaUpdate" value="true"></property>
</bean>
</beans>
调用以下java代码，即可把需要的表创建出来
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngineConfiguration;
import org.junit.Test; public class CreateTable {
@Test
public void testCreateTable(){
ProcessEngine processEngine = ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml")
.buildProcessEngine();
}
}
HelloWorld程序
先画请假流程图
注意：
properties=>General中的ID和NAME可以设置每个步骤的名称：
每个审批过程的properties=>Main config=>Assignee:设置能够审批的对象，这里部门经理审批设置为：张三，总经理审批设置为：李四
保存后，在根目录下生成：
JAVA程序如下：
import java.util.List; import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngineConfiguration;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.task.Task;
import org.junit.Test; /**
* 1、部署流程图
* 2、启动流程实例
* 3、发起申请
* 4、审批
* @author zd
*
*/
public class HelloWorld {
/**
* 部署流程图
*/
@Test
public void testDeploy(){
//产生流程引擎
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
//获取仓库流程的实例
processEngine.getRepositoryService()
.createDeployment()
.addClasspathResource("qingjia.bpmn")
.addClasspathResource("qingjia.png")
.deploy();
/**
* 这里使用RepositoryService部署流程定义
addClasspathResource表示从类路径下加载资源文件，一次只能加载一个文件
*/
} /**
* 启动流程实例 pi=process instance
*/
@Test
public void testStartPI(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
processEngine.getRuntimeService()
.startProcessInstanceById("qingjia:1:4");//ID在act_re_procdef这个表中可以看到
//这里使用RuntimeService启动流程实例
} /**
* 完成任务
*/
@Test
public void testFinishTask(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
processEngine.getTaskService()
.complete("104");//act_ru_task表中获取
} /**
* 根据张三查询任务
*/
@Test
public void testQueryTask(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
//查询任务列表
List<Task> tasks = processEngine.getTaskService()
.createTaskQuery()
.taskAssignee("张三")
.list();
for (Task task : tasks) {
System.out.println(task.getName());
}
}
}
流程定义
import java.io.FileOutputStream;
import java.io.InputStream;
import java.io.OutputStream;
import java.util.List;
import java.util.zip.ZipInputStream; import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.repository.Deployment;
import org.activiti.engine.repository.ProcessDefinition;
import org.junit.Test;
import org.springframework.transaction.annotation.Transactional; /**
* pd=process definition
* @author zd
* 1、把流程图部署到activiti的引擎中 重点
* classpath
* inputstream
* zipinputstream
* 2、对流程图进行删除 重点
* 3、获取到流程图和bpmn文件 重点
* 4、查询 了解
* 查询部署
* 查询流程定义
*/
public class PDTest {
/**
* 涉及到的表
* act_ge_bytearray
* 1、说明
* 该表存储了bpmn文件和png图片
* 从字段可以看出，根据deploymentID可以查询bpmn文件和png图片
* 2、字段
* name_:存储该文件的路径名称
* deploymentid_id_:部署表的ID
* byte_:存放值(bpmn和png)
* act_re_deployment
* 1、说明
* 该表存储了部署的动作
* 2、字段
* ID_:部署ID 主键
* act_re_procdef
* 1、说明
* 流程定义表
* 2、字段
* id: 是由${name}:${version}:随机数 确定唯一的流程
* name_: 流程定义名称
* key_: 流程定义名称
* version_: 某一个流程定义的版本
* deployment_id_:部署表的ID
*
* 说明：
* 1、根据deploymentID-->查询图片和bpmn文件
* 2、根据deploymentID-->查询流程定义
* 3、只要流程名称不变，部署一次，版本号加1，id就发生变化，生成了一个新的deploymentID
* 4、所以deploymentID和pdid是一一对应的关系
*/
@Test
public void testDeployFromClasspath(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
processEngine.getRepositoryService()
.createDeployment()
.addClasspathResource("qingjia.bpmn")
.addClasspathResource("qingjia.png")
.deploy();
} /**
* 通过inputStream的方式部署
*/
@Test
public void testDeployFromInputStream(){
InputStream inputStream = this.getClass().getClassLoader().getResourceAsStream("qingjia.bpmn");
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
processEngine.getRepositoryService()
.createDeployment()
.addInputStream("qingjia.bpmn", inputStream)
.deploy();
} /**
* 通过zip的方式部署
*/
@Test
public void testDeployFromZip(){
InputStream inputStream = this.getClass().getClassLoader().getResourceAsStream("qingjia.zip");
ZipInputStream zipInputStream = new ZipInputStream(inputStream);
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
processEngine.getRepositoryService()
.createDeployment()
.addZipInputStream(zipInputStream)
.deploy();
} /**
* 把查询出来的图片放到E盘的根目录下
*/
@Test
public void testShowImage() throws Exception{
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
InputStream inputStream = processEngine.getRepositoryService()
/**
* 参数为pdid
*/
.getProcessDiagram("qingjia:1:4");
/**
* 得到一个图片
*/
// OutputStream outputStream = new FileOutputStream("e:/processimg.png");
// for(int b=-1;(b=inputStream.read())!=-1;){
// outputStream.write(b);
// }
// inputStream.close();
// outputStream.close();
/***************************************************************************************/
/**
* 第一个参数为deploymentId
* 第二个参数为resourceName
*/
/********************************************************************************/
/**
* 得到的是一个图片
*/
// InputStream inputStream2 = processEngine.getRepositoryService()
// .getResourceAsStream("101", "qingjia.png");
//
// OutputStream outputStream2 = new FileOutputStream("e:/processimg2.png");
// for(int b=-1;(b=inputStream2.read())!=-1;){
// outputStream2.write(b);
// }
// inputStream2.close();
// outputStream2.close();
/**********************************************************************************/
/**
* 得到的是bpmn文件
*/
InputStream inputStream3 = processEngine.getRepositoryService()
.getProcessModel("qingjia:1:4");
OutputStream outputStream3 = new FileOutputStream("e:/processimg3.bpmn");
for(int b=-1;(b=inputStream3.read())!=-1;){
outputStream3.write(b);
}
inputStream3.close();
outputStream3.close();
/*************************************************************************************/ } /**
* 查询流程部署
*/
@Test
public void testQueryDeploy(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
List<Deployment> deployments = processEngine.getRepositoryService()
.createDeploymentQuery()
.list();
for (Deployment deployment : deployments) {
System.out.println(deployment.getId());
}
} /**
* 根据部署ID查询部署 一个结果
*/
@Test
public void testQueryDeployById(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
Deployment deployment = processEngine.getRepositoryService()
.createDeploymentQuery()
.deploymentId("1")
.singleResult(); System.out.println(deployment.getId()); } /**
* 查询所有的流程定义
*/
@Test
public void testQueryPD(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
List<ProcessDefinition> processDefinitions = processEngine.getRepositoryService()
.createProcessDefinitionQuery()
.list();
for (ProcessDefinition processDefinition : processDefinitions) {
System.out.println(processDefinition.getKey());
System.out.println(processDefinition.getId());
System.out.println(processDefinition.getVersion());
}
} /**
* 按照版本的从高到低进行排序
*/
@Test
public void testQueryPDByVersion(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
List<ProcessDefinition> processDefinitions = processEngine.getRepositoryService()
.createProcessDefinitionQuery()
.orderByProcessDefinitionVersion()
.desc()
.list();
for (ProcessDefinition processDefinition : processDefinitions) {
System.out.println(processDefinition.getKey());
System.out.println(processDefinition.getId());
System.out.println(processDefinition.getVersion());
}
} /**
* 根据pdid查询流程定义
* 根据 pdkey查询流程定义
*/
//略。。 /**
* 删除
*/
@Test
public void testDelete(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
processEngine.getRepositoryService()
//.deleteDeployment("");//该方法只能删除流程定义，一般不会使用
.deleteDeployment("1", true);//该方法不仅能够删除流程定义，而且能够删除正在运行的流程实例
}
}
流程实例、任务的执行
import java.util.List; import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.history.HistoricActivityInstance;
import org.activiti.engine.history.HistoricTaskInstance;
import org.activiti.engine.impl.bpmn.parser.handler.ProcessParseHandler;
import org.activiti.engine.impl.persistence.entity.ProcessDefinitionEntity;
import org.activiti.engine.impl.pvm.process.ActivityImpl;
import org.activiti.engine.runtime.ProcessInstance;
import org.activiti.engine.task.Task;
import org.junit.Test; /**
* pi=process instance
* @author zd
* 1、启动流程实例
* 2、完成任务
* 3、任务的查询
* 1、根据任务的执行人查询任务
* 2、可以根据任务查询任务的执行人
* 3、查看历史任务
* 4、怎么样查看流程实例是否结束
*/
public class PITest {
/**
* 启动流程实例
* 涉及到的表
* act_hi_actinst hi:history actinst:action instance
* 1、概念
* 所有的正在执行的或者已经完成的节点
* 2、字段
* act_type_:为节点的类型
* end_time_: 如果有值，说明该节点已经结束了
* act_hi_procinst procinst:process instance
* 1、概念
* 所有的正在执行的或者已经完成的流程实例
* 2、字段
* end_time_:如果该字段有值，说明这个流程实例已经结束了
* end_act_id_:说明该流程实例是在哪个节点结束的
* act_hi_taskinst taskinst:task instance
* 1、概念
* 所有的正在执行的或者已经完成的任务节点
* 2、字段
* end_time_:如果该字段有值，说明任务已经完成了
* delete_reason:如果该值为completed,说明该任务处于完成的状态
* act_ru_execution ru:runtime
* 1、概念
* 代表正在执行的流程实例
* 2、字段
* id_:主键 executionid
* proc_inst_id_: process instanceid
* proc_def_id_:pdid
* act_id_:当前的流程实例正在执行的节点的ID的值
* act_ru_task
* 1、概念
* 代表正在执行的任务
* 2、字段
* id_:主键 任务ID
* execution_id_:piid,executionid
* name_:任务名称
* 3、说明
* 该表是一个临时表，该表中的任务完成以后，这一行会被删除掉
*
*/
@Test
public void testStartPI(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
ProcessInstance pi = processEngine.getRuntimeService()
.startProcessInstanceById("qingjia:1:304");
System.out.println(pi.getId());
} /**
* 查询所有的正在执行的流程实例
*/
@Test
public void testQueryPI(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
List<ProcessInstance> processInstances = processEngine.getRuntimeService()
.createProcessInstanceQuery()
.list();
for (ProcessInstance processInstance : processInstances) {
System.out.println(processInstance.getActivityId());
System.out.println(processInstance.getId());
}
} /**
* 查询当前正在执行的节点
*/
@Test
public void testQueryActivity(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
List<String> strings = processEngine.getRuntimeService()
.getActiveActivityIds("401");
for (String string : strings) {
System.out.println(string);
}
} /**
*获取当前的流程实例正在运行的节点的坐标
*/
@Test
public void getPix(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
/**
* processDefinitionEntity代表流程图对象的实体
*
* 根据pdid获取到流程定义实体
*/
ProcessDefinitionEntity processDefinitionEntity = (ProcessDefinitionEntity)processEngine.getRepositoryService()
.getProcessDefinition("qingjia:1:304");
List<String> strings = processEngine.getRuntimeService()
.getActiveActivityIds("401"); //piid
for (String string : strings) {
/**
* ActivityImpl代表流程图上的每一个节点
*/
ActivityImpl activityImpl = processDefinitionEntity.findActivity(string);
/**
* 获取到正在执行的流程节点的坐标
*/
System.out.println(activityImpl.getHeight());
System.out.println(activityImpl.getWidth());
System.out.println(activityImpl.getX());
System.out.println(activityImpl.getY());
}
} /**
* 查询所有的任务
*/
@Test
public void testQueryAllTask(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
List<Task> tasks = processEngine.getTaskService()
.createTaskQuery()
.list();
for (Task task : tasks) {
System.out.println(task.getId());
System.out.println(task.getName());
}
} /**
* 完成任务
* 需要一个参数：taskId
*/
@Test
public void testFinishTask(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
processEngine.getTaskService()
.complete("602");
} /**
* 根据任务的执行人查看任务
*/
@Test
public void testQueryTaskByAssignee(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
List<Task> tasks = processEngine.getTaskService()
.createTaskQuery()
.taskAssignee("张三")
.list();
for (Task task : tasks) {
System.out.println(task.getId());
System.out.println(task.getName());
}
} /**
* 根据任务的执行人查看任务，并且按照时间的倒叙排序
*/
@Test
public void testQueryTaskByAssigneeByTime_DESC(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
List<Task> tasks = processEngine.getTaskService()
.createTaskQuery()
.taskAssignee("张三")
.orderByTaskCreateTime()
.desc()
.list();
for (Task task : tasks) {
System.out.println(task.getId());
System.out.println(task.getName());
}
} /**
* 根据piid判断流程实例是否结束
*/
@Test
public void testQueryPIByPIID(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
ProcessInstance pi = processEngine.getRuntimeService()
.createProcessInstanceQuery()
.processInstanceId("401")
.singleResult();
if(pi==null){
System.out.println("该流程实例已经结束了");
}else{
System.out.println("该流程实例正在执行中");
}
} /**
* 查询已经完成的任务
*/
@Test
public void testQueryHistoryTask(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
List<HistoricTaskInstance> historicTaskInstances = processEngine.getHistoryService()
.createHistoricTaskInstanceQuery()
.finished()
.list();
for (HistoricTaskInstance historicTaskInstance : historicTaskInstances) {
System.out.println(historicTaskInstance.getAssignee());
System.out.println(historicTaskInstance.getName());
System.out.println(historicTaskInstance.getId());
}
} /**
* 查询已经完成的activityimpl
*/
@Test
public void testQueryHistoryActivityImpl(){
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
List<HistoricActivityInstance> historicActivityInstances = processEngine.getHistoryService()
.createHistoricActivityInstanceQuery()
.list();
for (HistoricActivityInstance historicActivityInstance : historicActivityInstances) {
System.out.println(historicActivityInstance.getActivityName());
}
}
}