Activity7工作流—从零到实战

一 Activity基础

1.1 工作流简介

       工作流(Workflow)，就是通过计算机对业务流程自动化执行管理。它主要解决的是“使在多个参与者之间按照某种预定义的规则自动进行传递文档、信息或任务的过程，从而实现某个预期的业务目标，或者促使此目标的实现”。

1.2 工作流系统

       一个软件系统中具有工作流的功能，我们把它称为工作流系统，一个系统中工作流的功能是什么？就是对系统的业务流程进行自动化管理，所以工作流是建立在业务流程的基础上，所以一个软件的系统核心根本上还是系统的业务流程，工作流只是协助进行业务流程管理。即使没有工作流业务系统也可以开发运行，只不过有了工作流可以更好的管理业务流程，提高系统的可扩展性。

1.2.1 适用行业

       消费品行业，制造业，电信服务业，银证险等金融服务业，物流服务业，物业服务业，物业管理，大中型进出口贸易公司，政府事业机构，研究院所及教育服务业等，特别是大的跨国企业和集团公司。

1.2.2 具体应用

1. 关键业务流程：订单、报价处理、合同审核、客户电话处理、供应链管理等
2. 行政管理类:出差申请、加班申请、请假申请、用车申请、各种办公用品申请、购买申请、日报
   周报等凡是原来手工流转处理的行政表单。
3. 人事管理类：员工培训安排、绩效考评、职位变动处理、员工档案信息管理等。
4. 财务相关类：付款请求、应收款处理、日常报销处理、出差报销、预算和计划申请等。
5. 客户服务类：客户信息管理、客户投诉、请求处理、售后服务管理等。
6. 特殊服务类： ISO 系列对应流程、质量管理对应流程、产品数据信息管理、贸易公司报关处理、物流公司货物跟踪处理等各种通过表单逐步手工流转完成的任务均可应用工作流软件自动规范地实施。

1.3 工作流实现方式

       在没有专门的工作流引擎之前，我们之前为了实现流程控制，通常的做法就是采用状态字段的值来
跟踪流程的变化情况。这样不用角色的用户，通过状态字段的取值来决定记录是否显示。

       针对有权限可以查看的记录，当前用户根据自己的角色来决定审批是否合格的操作。如果合格将状
态字段设置一个值，来代表合格；当然如果不合格也需要设置一个值来代表不合格的情况。

       这是一种最为原始的方式。通过状态字段虽然做到了流程控制，但是当我们的流程发生变更的时候，
这种方式所编写的代码也要进行调整。

       那么有没有专业的方式来实现工作流的管理呢？并且可以做到业务流程变化之后，我们的程序可以不用改变，如果可以实现这样的效果，那么我们的业务系统的适应能力就得到了极大提升。

1.4 工作流实现原理分析

       如何可以做到我们在业务流程发生变更后，我们的业务系统代码可以不发生改变？此时我们就来分析一下原理。具体分析过程如下图所示：

二 什么是Activiti7

2.1 Activiti 介绍（博主这里介绍的版本是Activiti7）

       Alfresco 软件在 2010 年 5 月 17 日宣布 Activiti 业务流程管理（BPM）开源项目的正式启动， 其首席架构师由业务流程管理 BPM 的专家 Tom Baeyens 担任， Tom Baeyens 就是原来 jbpm 的架构师，而 jbpm 是一个非常有名的工作流引擎，当然 activiti 也是一个工作流引擎。
       Activiti 是一个工作流引擎， activiti 可以将业务系统中复杂的业务流程抽取出来，使用专门的建模语言（BPMN2.0）进行定义，业务系统按照预先定义的流程进行执行，实现了业务系统的业务流程由 activiti 进行管理，减少业务系统由于流程变更进行系统升级改造的工作量，从而提高系统的健壮性，同时也减少了系统开发维护成本。
       官方网站： https://www.activiti.org/

2.1.1 BPM

       BPM（Business Process Management），即业务流程管理，是一种以规范化的构造端到端的卓越
业务流程为中心，以持续的提高组织业务绩效为目的系统化方法，常见商业管理教育如 EMBA、MBA
等均将 BPM 包含在内。
       企业流程管理主要是对企业内部改革，改变企业职能管理机构重叠、中间层次多、流程不闭环
等，做到机构不重叠、业务不重复，达到缩短流程周期、节约运作资本、提高企业效益的作用。

比较下边的两个人事加薪流程哪个效率更高？
流程一：

流程二：

上边两个流程的区别在于第二个流程在执行时，如果本次加薪金额在一万元以内不再由总经理审批将比第一个流程缩短流程周期，从而提交效率。再比较下边的例子，哪个效率更高？

2.1.2 BPM 软件

       BPM 软件就是根据企业中业务环境的变化，推进人与人之间、人与系统之间以及系统与系统之间的整合及调整的经营方法与解决方案的 IT 工具。 通常以 Internet 方式实现信息传递、数据同步、业务监控和企业业务流程的持续升级优化，从而实现跨应用、跨部门、跨合作伙伴与客户的企业运作。 通过 BPM 软件对企业内部及外部的业务流程的整个生命周期进行建模、自动化、管理监控和优化，使企业成本降低，利润得以大幅提升。
       BPM 软件在企业中应用领域广泛， 凡是有业务流程的地方都可以 BPM 软件进行管理，比如企业人事办公管理、采购流程管理、公文审批流程管理、财务管理等。

2.1.3 BPMN

       BPMN（Business Process Model And Notation） - 业务流程模型和符号， 是由 BPMI（BusinessProcess Management Initiative）开发的一套标准的业务流程建模符号，使用 BPMN 提供的符号可以创建业务流程。 2004 年 5 月发布了 BPMN1.0 规范.BPMI 于 2005 年 9 月并入 OMG（The ObjectManagement Group 对象管理组织)组织。 OMG 于 2011 年 1 月发布 BPMN2.0 的最终版本。具体发展历史如下:

BPMN 是目前被各 BPM 厂商广泛接受的 BPM 标准。 Activiti 就是使用 BPMN 2.0 进行流程建模、流程执行管理，它包括很多的建模符号，比如：
Event 用一个圆圈表示，它是流程中运行过程中发生的事情。

活动用圆角矩形表示，一个流程由一个活动或多个活动组成

一个 bpmn 图形的例子：
首先当事人发起一个请假单；
其次他所在部门的经理对请假单进行审核；
然后人事经理进行复核并进行备案；
最后请假流程结束。

Bpmn 图形其实是通过 xml 表示业务流程，上边的.bpmn 文件使用文本编辑器打开：

<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:activiti="http://activiti.org/bpmn"
xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI"
xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC"
xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI"
typeLanguage="http://www.w3.org/2001/XMLSchema"
expressionLanguage="http://www.w3.org/1999/XPath"
targetNamespace="http://www.activiti.org/test">
<process id="myProcess" name="My process" isExecutable="true">
<startEvent id="startevent1" name="Start"></startEvent>
<userTask id="usertask1" name="创建请假单"></userTask>
<sequenceFlow id="flow1" sourceRef="startevent1"
targetRef="usertask1"></sequenceFlow>
<userTask id="usertask2" name="部门经理审核"></userTask>
<sequenceFlow id="flow2" sourceRef="usertask1"
targetRef="usertask2"></sequenceFlow>
<userTask id="usertask3" name="人事复核"></userTask>
<sequenceFlow id="flow3" sourceRef="usertask2"
targetRef="usertask3"></sequenceFlow>
<endEvent id="endevent1" name="End"></endEvent>
<sequenceFlow id="flow4" sourceRef="usertask3"
targetRef="endevent1"></sequenceFlow>
</process>
<bpmndi:BPMNDiagram id="BPMNDiagram_myProcess">
<bpmndi:BPMNPlane bpmnElement="myProcess" id="BPMNPlane_myProcess">
<bpmndi:BPMNShape bpmnElement="startevent1" id="BPMNShape_startevent1">
<omgdc:Bounds height="35.0" width="35.0" x="130.0"
y="160.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="usertask1" id="BPMNShape_usertask1">
<omgdc:Bounds height="55.0" width="105.0" x="210.0"
y="150.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="usertask2" id="BPMNShape_usertask2">
<omgdc:Bounds height="55.0" width="105.0" x="360.0"
y="150.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="usertask3" id="BPMNShape_usertask3">
<omgdc:Bounds height="55.0" width="105.0" x="510.0"
y="150.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="endevent1" id="BPMNShape_endevent1">
<omgdc:Bounds height="35.0" width="35.0" x="660.0"
y="160.0"></omgdc:Bounds>
</bpmndi:BPMNShape>
<bpmndi:BPMNEdge bpmnElement="flow1" id="BPMNEdge_flow1">
<omgdi:waypoint x="165.0" y="177.0"></omgdi:waypoint>
<omgdi:waypoint x="210.0" y="177.0"></omgdi:waypoint>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="flow2" id="BPMNEdge_flow2">
<omgdi:waypoint x="315.0" y="177.0"></omgdi:waypoint>
<omgdi:waypoint x="360.0" y="177.0"></omgdi:waypoint>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="flow3" id="BPMNEdge_flow3">
<omgdi:waypoint x="465.0" y="177.0"></omgdi:waypoint>
<omgdi:waypoint x="510.0" y="177.0"></omgdi:waypoint>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="flow4" id="BPMNEdge_flow4">
<omgdi:waypoint x="615.0" y="177.0"></omgdi:waypoint>
<omgdi:waypoint x="660.0" y="177.0"></omgdi:waypoint>
</bpmndi:BPMNEdge>
</bpmndi:BPMNPlane>
</bpmndi:BPMNDiagram>
</definitions>

2.2 Activit 如何使用

2.2.1 部署 activity

       Activiti 是一个工作流引擎（其实就是一堆 jar 包 API），业务系统使用 activiti 来对系统的业务流程进行自动化管理，为了方便业务系统访问(操作)activiti 的接口或功能，通常将 activiti 环境与业务系统的环境集成在一起。

2.2.2 流程定义

       使用 activiti 流程建模工具(activity-designer)定义业务流程(.bpmn 文件) 。bpmn 文件就是业务流程定义文件，通过 xml 定义业务流程。
       如果使用其它公司开发的工作引擎一般都提供了可视化的建模工具(Process Designer)用于生
成流程定义文件，建模工具操作直观，一般都支持图形化拖拽方式、 多窗口的用户界面、 丰富的过
程图形元素、过程元素拷贝、粘贴、删除等功能。

2.2.3 流程定义部署

       向 activiti 部署业务流程定义（.bpmn 文件）。使用 activiti 提供的 api 向 activiti 中部署.bpmn 文件（一般情况还需要一块儿部署业务流程的图片.png）

2.2.4 启动一个流程实例（ProcessInstance）

       启动一个流程实例表示开始一次业务流程的运行，比如员工请假流程部署完成，如果张三要请假就可以启动一个流程实例，如果李四要请假也启动一个流程实例，两个流程的执行互相不影响，就好比定义一个 java 类，实例化两个对象一样，部署的流程就好比 java 类，启动一个流程实例就好比 new 一个 java 对象。

2.2.5 用户查询待办任务(Task)

       因为现在系统的业务流程已经交给 activiti 管理，通过 activiti 就可以查询当前流程执行到哪了，当前用户需要办理什么任务了，这些 activiti帮我们管理了，而不像上边需要我们在 sql语句中的where条件中指定当前查询的状态值是多少。

2.2.6 用户办理任务

       用户查询待办任务后，就可以办理某个任务，如果这个任务办理完成还需要其它用户办理，比如采购单创建后由部门经理审核，这个过程也是由 activiti 帮我们完成了，不需要我们在代码中硬编码指
定下一个任务办理人了。

2.2.7 流程结束

       当任务办理完成没有下一个任务结点了，这个流程实例就完成了。

三 环境准备

3.1 三个环境

第一个环境：没有加入工作流 SaaS-IHRM 系统
作用：主要是为 activiti 工作流引擎的引入提供场景

第二个环境： activiti 测试环境
作用：用于测试 activiti 的 api，提供各种 service 接口。
需要创建一个数据库：
仅仅有 activiti 的数据表

第三个环境： activiti 应用环境，加入工作流的 SaaS-IHRM 系统
需要创建一个数据库：
包括 activiti 的数据表和业务表（SaaS-IHRM 系统的表）

3.2 开发环境

3.2.1 Java 环境

Jdk1.8 或以上版本。

3.2.2 数据库

Mysql 5 及以上的版本
博主采用 5.5 版本

3.2.3 Web 容器

博主采用的是 Tomcat8.5

3.2.4 开发工具

Mysql 客户端连接工具：Sqlyog 或其它；
文本编辑器：EditPlus 或其它；
Java 开发工具： IDEA 或 Eclipse 工具；
注意： activiti 的流程定义工具插件可以安装在 IDEA 下，也可以安装在 Eclipse 工具下。

3.3 Activiti 环境

Activiti7.0.0.Beta1
默认支持 spring5

3.3.1 下载 activiti7

Activiti 下载地址： http://activiti.org/download.html

<dependencyManagement>
	<dependencies>
		<dependency>
			<groupId>org.activiti</groupId>
			<artifactId>activiti-dependencies</artifactId>
			<version>7.0.0.Beta1</version>
			<scope>import</scope>
			<type>pom</type>
		</dependency>
	</dependencies>
</dependencyManagement>

1. Database：
   activiti 运行需要有数据库的支持， 支持的数据库有： h2, mysql, oracle, postgres, mssql, db2
   等，该目录存放 activiti 的建表脚本。
2. Docs
   Activiti 的帮助文档。
3. Wars
   官方自带的示例工程。

3.3.2 Activiti Designer 流程设计器(Eclipse 工具)

博主使用 Activiti –Designer-eclipse-plugin（activiti 流程设计器插件）完成流程的制作。
下面介绍了 activiti designer 设计器插件的两种安装方式，博主使用的是方式一；

3.3.2.1 Eclispe 工具下插件安装方式 1

参数文档开发工具目录下的“activiti 开发环境配置.docx”中“eclipse 插件安装”，其中包括了 Activiti
插件。

3.3.2.2 Eclispe 工具下插件安装方式 2

网络在线安装：

1. 打开 Help -> Install New Software. 在如下面板中:
   
2. 在如下 Install 界面板中，点击 Add 按钮：
   
   配置新装插件的地址和名称
3. 然后填入下列字段

Name: Activiti BPMN 2.0 designer
Location: http://activiti.org/designer/update/

4) 回到 Install 界面，在面板正中列表中把所有展示出来的项目都勾上，在 Detail 部分记得选中 “Contact all updates sites…” , 因为它会检查所有当前安装所需要的插件并可以被 Eclipse 下载

6) 安装完以后，点击新建工程 new->Other…打开面板，如果看到下图内容就说明安装成功了：

补充说明
打开菜单 Windows->Preferences->Activiti->Save 下流程图片的生成方式:

       虽然流程引擎在单独部署 bpmn 文件时会自动生成图片，但在实际开发过程中，自动生成的图片会导致和 BPMN 中的坐标有出入，在实际项目中展示流程当前位置图会有问题。在完成以上配置后，会由我们自己来管理流程图片。所以在发布流程时把流程规则文件和流程图片一起上传就行了。

3.3.3 Activiti Designer 流程设计器(IDEA 工具)

在 IDEA 的 File 菜单中找到子菜单”Settings”,后面我们再选择左侧的“plugins”菜单，如下图所示：

此时我们就可以搜索到 actiBPM 插件，它就是 Activiti Designer 的 IDEA 版本。

安装好后，页面如下：

3.3.4 Activiti 支持的数据库

Activiti 的运行需要数据库支撑，需要安装 activiti 数据库，支持如下版本：

Activiti 数据库类型	测试版本	JDBC URL 实例	备注
h2	1.3.168	jdbc:h2:tcp://localhost/activiti	默认配置的数据库
mysql	5.1.21	jdbc:mysql://localhost:3306/activiti?autoReconnect=true	使用 mysql-connector-java驱动测试
oracle	11.2.0.1.0	jdbc:oracle:thin:@localhost:1521:xe
postgres	8.1	jdbc:postgresql://localhost:5432/activiti
db2	DB2 10.1 usingdb2jcc4	jdbc:db2://localhost:50000/activiti
mssql	2008 usingsqljdbc4	jdbc:sqlserver://localhost:1433/activiti

3.3.5 创建 mysql 数据库

博主使用的是 mysql 数据库。
创建 mysql 数据库 activiti（名字任意）：

CREATE DATABASE activiti DEFAULT CHARACTER SET utf8;

3.3.6 创建表方式

通过运行 java 程序创建表。

3.3.6.1 创建 java 工程

使用 eclipse 或 idea 创建 maven 的 java 工程。

3.3.6.2 加入 maven 依赖的坐标（jar 包）

首先需要在 java 工程中加入 ProcessEngine 所需要的 jar 包，包括：

1. activiti-engine-7.0.0.beta1.jar
2. activiti 依赖的 jar 包： mybatis、 alf4j、 log4j 等
3. activiti 依赖的 spring 包
4. 数据库驱动
5. 第三方数据连接池 dbcp
6. 单元测试 Junit-4.12.jar

我们使用 maven 来实现项目的构建，所以应当导入这些 jar 所对应的坐标到 pom.xml 文件中。

<properties>
	<slf4j.version>1.6.6</slf4j.version>
	<log4j.version>1.2.12</log4j.version>
</properties>
<dependencies>
	<dependency>
		<groupId>org.activiti</groupId>
		<artifactId>activiti-engine</artifactId>
		<version>7.0.0.Beta1</version>
	</dependency>
	<dependency>
		<groupId>org.activiti</groupId>
		<artifactId>activiti-spring</artifactId>
		<version>7.0.0.Beta1</version>
	</dependency>
	<dependency>
		<groupId>org.activiti</groupId>
		<artifactId>activiti-bpmn-model</artifactId>
		<version>7.0.0.Beta1</version>
	</dependency>
	<dependency>
		<groupId>org.activiti</groupId>
		<artifactId>activiti-bpmn-converter</artifactId>
		<version>7.0.0.Beta1</version>
	</dependency>
	<dependency>
		<groupId>org.activiti</groupId>
		<artifactId>activiti-json-converter</artifactId>
		<version>7.0.0.Beta1</version>
	</dependency>
	<dependency>
		<groupId>org.activiti</groupId>
		<artifactId>activiti-bpmn-layout</artifactId>
		<version>7.0.0.Beta1</version>
	</dependency>
	<dependency>
		<groupId>org.activiti.cloud</groupId>
		<artifactId>activiti-cloud-services-api</artifactId>
		<version>7.0.0.Beta1</version>
	</dependency>
	<dependency>
		<groupId>mysql</groupId>
		<artifactId>mysql-connector-java</artifactId>
		<version>5.1.40</version>
	</dependency>
	<dependency>
		<groupId>junit</groupId>
		<artifactId>junit</artifactId>
		<version>4.12</version>
	</dependency>
	<!-- log start -->
	<dependency>
		<groupId>log4j</groupId>
		<artifactId>log4j</artifactId>
		<version>${log4j.version}</version>
	</dependency>
	<dependency>
		<groupId>org.slf4j</groupId>
		<artifactId>slf4j-api</artifactId>
		<version>${slf4j.version}</version>
	</dependency>
	<dependency>
		<groupId>org.slf4j</groupId>
		<artifactId>slf4j-log4j12</artifactId>
		<version>${slf4j.version}</version>
	</dependency>
	<!-- log end -->
	<dependency>
		<groupId>org.mybatis</groupId>
		<artifactId>mybatis</artifactId>
		<version>3.4.5</version>
	</dependency>
	<dependency>
		<groupId>commons-dbcp</groupId>
		<artifactId>commons-dbcp</artifactId>
		<version>1.4</version>
	</dependency>
</dependencies>

3.3.6.3 log4j.properties

# Set root category priority to INFO and its only appender to CONSOLE.
#log4j.rootCategory=INFO, CONSOLE debug info warn error fatal
log4j.rootCategory=debug, CONSOLE, LOGFILE
# Set the enterprise logger category to FATAL and its only appender to CONSOLE.
log4j.logger.org.apache.axis.enterprise=FATAL, CONSOLE
# CONSOLE is set to be a ConsoleAppender using a PatternLayout.
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=%d{
     ISO8601} %-6r
[%15.15t] %-5p %30.30c %x - %m\n
# LOGFILE is set to be a File appender using a PatternLayout.
log4j.appender.LOGFILE=org.apache.log4j.FileAppender
log4j.appender.LOGFILE.File=d:\axis.log
log4j.appender.LOGFILE.Append=true
log4j.appender.LOGFILE.layout=org.apache.log4j.PatternLayout
log4j.appender.LOGFILE.layout.ConversionPattern=%d{
     ISO8601} %-6r
[%15.15t] %-5p %30.30c %x - %m\n

3.3.6.4 activiti.cfg.xml

在 classpath 下创建 activiti.cgf.xml 文件：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:tx="http://www.springframework.org/schema/tx"
xsi:schemaLocation="http://www.springframework.org/schema/beans
	http://www.springframework.org/schema/beans/spring-beans.xsd
	http://www.springframework.org/schema/contex
	http://www.springframework.org/schema/context/spring-context.xsd
	http://www.springframework.org/schema/tx
	http://www.springframework.org/schema/tx/spring-tx.xsd">
</beans>

在 activiti.cfg.xml 中配置数据源和 processEngineConfiguration

1. 数据源

<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource">
	<property name="driverClassName" value="com.mysql.jdbc.Driver" />
	<property name="url" value="jdbc:mysql://localhost:3306/
	itcast0711activiti" />
	<property name="username" value="root" />
	<property name="password" value="root" />
	<property name=" maxActive" value="3" />
	<property name="maxIdle" value="1" />
</bean>

2. processEngineConfiguration
   processEngineConfiguration 用来创建 ProcessEngine，在创建 ProcessEngine 时会执行数据库的操作。

<bean id="processEngineConfiguration"
class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
	<!-- 数据源 -->
	<property name="dataSource" ref="dataSource" />
	<!-- activiti数据库表处理策略 -->
	<property name="databaseSchemaUpdate" value="true"/>
</bean>

关于 processEngineConfiguration 中的 databaseSchemaUpdate 参数， 通过此参数设计 activiti
数据表的处理策略，参数如下：

false（默认）：检查数据库表的版本和依赖库的版本， 如果版本不匹配就抛出异常。
true: 构建流程引擎时，执行检查，如果需要就执行更新。 如果表不存在，就创建。
create-drop: 构建流程引擎时创建数据库表， 关闭流程引擎时删除这些表。
drop-create：先删除表再创建表。
create: 构建流程引擎时创建数据库表， 关闭流程引擎时不删除这些表。

注意：在 activiti.cfg.xml 配置文件中的 dataSource 和 processEngineConfiguration 也可以使用一次
性配置出来。

<bean id="processEngineConfiguration"
      class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
	<property name="jdbcDriver" value="com.mysql.jdbc.Driver"/>
	<property name="jdbcUrl" value="jdbc:mysql://localhost:3306/itcast0711activiti"/>
	<property name="jdbcUsername" value="root"/>
	<property name="jdbcPassword" value="root"/>
	<property name="databaseSchemaUpdate" value="true"/>
</bean>

3.3.6.5 编写程序

       创建 ProcessEngineConfiguration，通过 ProcessEngineConfiguration 创建 ProcessEngine，在创建ProcessEngine 时会自动创建数据库。

//创建ProcessEngineConfiguration
ProcessEngineConfiguration configuration =ProcessEngineConfiguration
.createProcessEngineConfigurationFromResource("activiti.cfg.xml")
//通过ProcessEngineConfiguration创建ProcessEngine，此时会创建数据库
ProcessEngine processEngine =configuration.buildProcessEngine();
System.out.println(processEngine);

说明：
1、运行以上程序段即可完成 activiti 数据库创建，通过改变 activiti.cfg.xml 中databaseSchemaUpdate 参数的值执行不同的数据表处理策略。
2 、 上 边 的 方法 createProcessEngineConfigurationFromResource 在执行时在activiti.cfg.xml 中找固定的名称 processEngineConfiguration也可以使用重载方法调用，这时可以不用限定 processEngineConfiguration 名称

此时我们查看数据库， 创建了 25 张表，结果如下：

3.3.7 数据库表的命名规则

Activiti 的表都以 ACT_开头。 第二部分是表示表的用途的两个字母标识。 用途也和服务的 API 对应。

• ACT_RE_*: RE表示 repository。 这个前缀的表包含了流程定义和流程静态资源 （图片，规则，等等）。
• ACT_RU_*: RU表示 runtime。 这些运行时的表，包含流程实例，任务，变量，异步任务，等运行中的数据。 Activiti 只在流程实例执行过程中保存这些数据， 在流程结束时就会删除这些记录。 这样运行时表可以一直很小速度很快。
• ACT_HI_*: HI表示 history。 这些表包含历史数据，比如历史流程实例， 变量，任务等等。
• ACT_GE_*: GE 表示 general。 通用数据， 用于不同场景下。

四 Activiti 服务架构图

在新版本中，我们通过实验可以发现 IdentityService， FormService 两个 Serivce 都已经删除了。所以后面我们对于这两个 Service 也不讲解了，但老版本中还是有这两个 Service，大家需要了解一下。

4.1 activiti.cfg.xml

       activiti 的引擎配置文件，包括： ProcessEngineConfiguration 的定义、数据源定义、事务管理器等，此文件其实就是一个 spring 配置文件，下面是一个基本的配置，只配置了 ProcessEngineConfiguration和数据源：

<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-3.1.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.1.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx-3.1.xsd">
	<!--数据库连接池 -->
	<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource">
		<property name="driverClassName" value="com.mysql.jdbc.Driver" />
		<property name="url" value="jdbc:mysql://localhost:3306/activiti" />
		<property name="username" value="root" />
		<property name="password" value="mysql" />
	</bean>
	<bean id="processEngineConfiguration"
		class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
		<!-- 数据源 -->
		<property name="dataSource" ref="dataSource" />
		<!-- 数据库策略 -->
		<property name="databaseSchemaUpdate" value="true"/>
	</bean>
</beans>

4.2 ProcessEngineConfiguration

流程引擎的配置类，通过 ProcessEngineConfiguration 可以创建工作流引擎 ProceccEngine，常用的两种方法如下：

4.2.1 StandaloneProcessEngineConfiguration

通过 org.activiti.engine.impl.cfg.StandaloneProcessEngineConfigurationActiviti 可以单独运行，使用它创建的 ProcessEngine， Activiti 会自己处理事务。
配置文件方式：
通常在 activiti.cfg.xml 配置文件中定义一个 id 为 processEngineConfiguration 的 bean，这里会使用 spring 的依赖注入来构建引擎。
方法如下：

<bean id="processEngineConfiguration"
	class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
	<!-- 数据源 -->
	<property name="dataSource" ref="dataSource" />
	<!-- 数据库策略 -->
	<property name="databaseSchemaUpdate" value="true"/>
</bean>

4.2.2 SpringProcessEngineConfiguration

通过 org.activiti.spring.SpringProcessEngineConfiguration 与 Spring 整合。
创建 spring 与 activiti 的整合配置文件：
activity-spring.cfg.xml（名称不固定）

<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:aop="http://www.springframework.org/schema/aop"
xmlns:tx="http://www.springframework.org/schema/tx"
xsi:schemaLocation="http://www.springframework.org/schema/beans
	http://www.springframework.org/schema/beans/spring-beans-3.1.xsd
	http://www.springframework.org/schema/mvc
	http://www.springframework.org/schema/mvc/spring-mvc-3.1.xsd
	http://www.springframework.org/schema/context
	http://www.springframework.org/schema/context/spring-context-3.1.xsd
	http://www.springframework.org/schema/aop
	http://www.springframework.org/schema/aop/spring-aop-3.1.xsd
	http://www.springframework.org/schema/tx
	http://www.springframework.org/schema/tx/spring-tx-3.1.xsd ">
<!-- 工作流引擎配置bean -->
<bean id="processEngineConfiguration"
	class="org.activiti.spring.SpringProcessEngineConfiguration">
	<!-- 数据源 -->
	<property name="dataSource" ref="dataSource" />
	<!-- 使用spring事务管理器 -->
	<property name="transactionManager" ref="transactionManager" />
	<!-- 数据库策略 -->
	<property name="databaseSchemaUpdate" value="drop-create" />
	<!-- activiti的定时任务关闭 -->
	<property name="jobExecutorActivate" value="false" />
</bean>
<!-- 流程引擎 -->
<bean id="processEngine"
class="org.activiti.spring.ProcessEngineFactoryBean">
	<property name="processEngineConfiguration" ref="processEngineConfiguration" />
</bean>
<!-- 资源服务service -->
<bean id="repositoryService" factory-bean="processEngine"
factory-method="getRepositoryService" />
<!-- 流程运行service -->
<bean id="runtimeService" factory-bean="processEngine" factory-method="getRuntimeService" />
<!-- 任务管理service -->
<bean id="taskService" factory-bean="processEngine" factory-method="getTaskService" />
<!-- 历史管理service -->
<bean id="historyService" factory-bean="processEngine" factory-method="getHistoryService" />
<!-- 用户管理service -->
<bean id="identityService" factory-bean="processEngine" factory-method="getIdentityService" />
<!-- 引擎管理service -->
<bean id="managementService" factory-bean="processEngine" factory-method="getManagementService" />
<!-- 数据源 -->
<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource">
	<property name="driverClassName" value="com.mysql.jdbc.Driver" />
	<property name="url" value="jdbc:mysql://localhost:3306/activiti" />
	<property name="username" value="root" />
	<property name="password" value="mysql" />
	<property name="maxActive" value="3" />
	<property name="maxIdle" value="1" />
</bean>
<!-- 事务管理器 -->
<bean id="transactionManager"
class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
	<property name="dataSource" ref="dataSource" />
</bean>
<!-- 通知 -->
<tx:advice id="txAdvice" transaction-manager="transactionManager">
	<tx:attributes>
		<!-- 传播行为 -->
		<tx:method name="save*" propagation="REQUIRED" />
		<tx:method name="insert*" propagation="REQUIRED" />
		<tx:method name="delete*" propagation="REQUIRED" />
		<tx:method name="update*" propagation="REQUIRED" />
		<tx:method name="find*" propagation="SUPPORTS" read-only="true" />
		<tx:method name="get*" propagation="SUPPORTS" read-only="true" />
	</tx:attributes>
</tx:advice>
<!-- 切面，根据具体项目修改切点配置 -->
<aop:config proxy-target-class="true">
	<aop:advisor advice-ref="txAdvice"
	pointcut="execution(* com.itheima.ihrm.service.impl.*.*(..))" />
</aop:config>
</beans>

4.2.3 创建 processEngineConfiguration

ProcessEngineConfiguration configuration =ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml")

上边的代码要求 activiti.cfg.xml 中必须有一个 processEngineConfiguration 的 bean也可以使用下边的方法，更改 bean 的名字：

ProcessEngineConfiguration.createProcessEngineConfigurationFromResource(String resource, String beanName);

4.3 ProcessEngine

工作流引擎，相当于一个门面接口，通过 ProcessEngineConfiguration 创建 processEngine，通过
ProcessEngine 创建各个 service 接口。

4.3.1 一般创建方式

//通过ProcessEngineConfiguration创建ProcessEngine
ProcessEngine processEngine =processEngineConfiguration.buildProcessEngine();

4.3.2简单创建方式

将 activiti.cfg.xml 文件名及路径固定，且 activiti.cfg.xml 文件中有 processEngineConfiguration 的配置，可以使用如下代码创建 processEngine:

//使用classpath下的activiti.cfg.xml中的配置创建processEngine
ProcessEngine processEngine =ProcessEngines.getDefaultProcessEngine();
System.out.println(processEngine);

4.4 Service

4.4.1 Service 创建方式

通过 ProcessEngine 创建 Service， Service 是工作流引擎提供用于进行工作流部署、执行、管理的服务接口。
方式如下：

RuntimeService runtimeService = processEngine.getRuntimeService();
RepositoryService repositoryService = processEngine.getRepositoryService();
TaskService taskService = processEngine.getTaskService();
……

4.4.2 Service 总览

RepositoryService	activiti 的资源管理类
RuntimeService	activiti 的流程运行管理类
TaskService	activiti 的任务管理类
HistoryService	activiti 的历史管理类
ManagerService	activiti 的引擎管理类

注： 红色标注为常用 service。

4.4.3 RepositoryService

       是 activiti 的资源管理类， 提供了管理和控制流程发布包和流程定义的操作。使用工作流建模工具设计的业务流程图需要使用此 service 将流程定义文件的内容部署到计算机。
       除了部署流程定义以外还可以：
       查询引擎中的发布包和流程定义。
       暂停或激活发布包，对应全部和特定流程定义。 暂停意味着它们不能再执行任何操作了，激活是对应的反向操作。
       获得多种资源，像是包含在发布包里的文件， 或引擎自动生成的流程图。
       获得流程定义的 pojo 版本， 可以用来通过 java 解析流程，而不必通过 xml。

4.4.4 RuntimeService

它是 activiti 的流程运行管理类。可以从这个服务类中获取很多关于流程执行相关的信息

4.4.5 TaskService

是 activiti 的任务管理类。可以从这个类中获取任务的信息。

4.4.6 HistoryService

是 activiti 的历史管理类，可以查询历史信息， 执行流程时，引擎会保存很多数据（根据配置），比
如流程实例启动时间，任务的参与者， 完成任务的时间，每个流程实例的执行路径，等等。 这个
服务主要通过查询功能来获得这些数据。

4.4.7 ManagementService

是 activiti 的引擎管理类， 提供了对 Activiti 流程引擎的管理和维护功能，这些功能不在工作流驱动
的应用程序中使用，主要用于 Activiti 系统的日常维护。

五 Activiti 入门体验

5.1 流程定义

5.1.1 Activiti-Designer 使用

5.1.1.1 Palette（画板）

在 eclipse 或 idea 中安装 activiti-designer 插件即可使用，画板中包括以下结点：
Connection—连接
Event—事件
Task—任务
Gateway—网关
Container—容器
Boundary event—边界事件
Intermediate event- -中间事件
流程图设计完毕保存生成.bpmn 文件。

5.1.1.2 新建流程(IDEA 工具)

首先选中存放图形的目录(本次我们选择 resources 下的 bpmn 目录)，点击菜单： New-BpmnFile，如
下图所示：

弹出如下图所示框：

起完名字 holiday 后（默认扩展名为 bpmn），就可以看到进入了流程设计页面，如图所示：

5.1.1.3 新建流程(Eclipse 工具)

首先选中存放图形的目录(本次我们选择 resources 下的 bpmn 目录)， File-New-Other 菜单，打开如
下窗口。

创建成功：

左侧区域是绘图区，右侧区域是 palette 画板区域
鼠标先点击画板的元素即可在左侧绘图。

5.1.2 绘制流程

图形绘制好后会生成两个文件：

自动生成图形，需要设置 eclipse:

5.1.3 指定流程定义 key

流程定义 key 即流程定义的标识，在 eclipse 中通过 properties 视图查看流程的 key；

建议：相同的业务流程，流程定义的 key 名字定义一样，比如，如果需要创建新的业务流程，请假
流程，则使用新的 key。

5.1.4 指定任务负责人

在 properties 视图指定每个任务结点的负责人，比如下边是填写请假单的负责人为 zhangsan

5.2 部署流程定义

部署流程定义，就是要将上边绘制的图形，即流程定义（.bpmn），部署在工作流程引擎 activiti 中，方法如下：
使用 ProcessEngine 创建 RepositoryService，代码如下：

// 获取repositoryService
RepositoryService repositoryService = processEngine.getRepositoryService();
//部署对象
Deployment deployment = repositoryService.createDeployment().addClasspathResource("diagram/myholiday.bpmn")// bpmn文件
.addClasspathResource("diagram/myholiday.png")// 图 片 文件
.name("请假申请流程").deploy();
System.out.println("流程部署id:" + deployment.getId());
System.out.println("流程部署名称:" + deployment.getName());

执行此操作后 activiti 会将上边代码中指定的 bpm 文件和图片文件保存在 activiti 数据库。

5.3 启动一个流程实例

流程定义部署在 activiti 后就可以通过工作流管理业务流程了，也就是说上边部署的请假申请流程可以使用了。
针对该流程，启动一个流程表示发起一个新的请假申请单，这就相当于 java 类与 java 对象的关系，类定义好后需要 new 创建一个对象使用，当然可以 new 多个对象。对于请假申请流程，张三发起一个请假申请单需要启动一个流程实例， 李四发起一个请假单也需要启动一个流程实例。
代码如下：

// 启动一个流程实例
@Test
public void startProcessInstance() {
     
	// 获取RunTimeService
	RuntimeService runtimeService =processEngine.getRuntimeService();
	// 根据流程定义key启动流程
	ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("myholiday01");
	System.out.println(" 流 程 定 义 id ： " +processInstance.getProcessDefinitionId());
	System.out.println("流程实例id： " + processInstance.getId());
	System.out.println(" 当 前 活 动 Id ： " +processInstance.getActivityId());
}

5.4 任务查询

流程启动后，各个任务的负责人就可以查询自己当前需要处理的任务，查询出来的任务都是该用户的待办任务。

// 查询当前个人待执行的任务
@Test
public void findPersonalTaskList() {
     
	// 任务负责人
	String assignee = "zhangsan";
	// 创建TaskService
	TaskService taskService = processEngine.getTaskService();
	List<Task> list = taskService.createTaskQuery()//
	.processDefinitionKey("myholiday01")//
	.taskAssignee(assignee)//只查询该任务负责人的任务
	.list();
	for (Task task : list) {
     
	System.out.println(" 流 程 实 例 id ： " +
	task.getProcessInstanceId());
	System.out.println("任务id： " + task.getId());
	System.out.println("任务负责人： " + task.getAssignee());
	System.out.println("任务名称： " + task.getName());
	}
}

5.5 任务处理

任务负责人查询待办任务，选择任务进行处理，完成任务。

// 完成任务
@Test
public void completTask() {
     
	//任务id
	String taskId = "8305";
	// 创建TaskService
	TaskService taskService = processEngine.getTaskService();
	//完成任务
	taskService.complete(taskId);
	System.out.println("完成任务id="+taskId);
}

六 流程定义

6.1流程定义

6.1.1 什么是流程定义

流程定义是线下按照 bpmn2.0 标准去描述 业务流程，通常使用 activiti-explorer（web 控制台）或 activiti-eclipse-designer 插件对业务流程进行建模，这两种方式都遵循 bpmn2.0 标准。这里博主使用
activiti-eclipse-designer 插件完成流程建模。使用 designer 设计器绘制流程，会生成两个文件： .bpmn和.png

6.1.2 .bpmn 文件

使用 activiti-desinger 设计业务流程，会生成.bpmn 文件，首先将 holiday.bpmn 文件改名为 holiday.xml，如下图：

.bpmn 内容如下：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL"
	xmlns:activiti="http://activiti.org/bpmn"
	xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI"
	xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC"
	xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI"
	xmlns:tns="http://www.activiti.org/test"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	expressionLanguage="http://www.w3.org/1999/XPath" id="m1539820628606" name=""
	targetNamespace="http://www.activiti.org/test"
	typeLanguage="http://www.w3.org/2001/XMLSchema">
	<process id="myProcess_1" isClosed="false" isExecutable="true" processType="None">
		<startEvent id="_2" name="StartEvent"/>
		<userTask activiti:exclusive="true" id="_3" name="UserTask"/>
		<sequenceFlow id="_4" sourceRef="_2" targetRef="_3"/>
		<userTask activiti:exclusive="true" id="_5" name="UserTask"/>
		<sequenceFlow id="_6" sourceRef="_3" targetRef="_5"/>
	</process>
	<bpmndi:BPMNDiagram
	documentation="background=#FFFFFF;count=1;horizontalcount=1;orientation=0;width=842
	.4;height=1195.2;imageableWidth=832.4;imageableHeight=1185.2;imageableX=5.0;imageab
	leY=5.0" id="Diagram-_1" name="New Diagram">
		<bpmndi:BPMNPlane bpmnElement="myProcess_1">
			<bpmndi:BPMNShape bpmnElement="_2" id="Shape-_2">
				<omgdc:Bounds height="32.0" width="32.0" x="200.0" y="70.0"/>
					<bpmndi:BPMNLabel>
					<omgdc:Bounds height="32.0" width="32.0" x="0.0" y="0.0"/>
				</bpmndi:BPMNLabel>
			</bpmndi:BPMNShape>
			<bpmndi:BPMNShape bpmnElement="_3" id="Shape-_3">
				<omgdc:Bounds height="55.0" width="85.0" x="165.0" y="175.0"/>
					<bpmndi:BPMNLabel>
					<omgdc:Bounds height="55.0" width="85.0" x="0.0" y="0.0"/>
				</bpmndi:BPMNLabel>
			</bpmndi:BPMNShape>
			<bpmndi:BPMNShape bpmnElement="_5" id="Shape-_5">
				<omgdc:Bounds height="55.0" width="85.0" x="160.0" y="295.0"/>
					<bpmndi:BPMNLabel>
					<omgdc:Bounds height="55.0" width="85.0" x="0.0" y="0.0"/>
				</bpmndi:BPMNLabel>
			</bpmndi:BPMNShape>
			<bpmndi:BPMNEdge bpmnElement="_4" id="BPMNEdge__4" sourceElement="_2"
			targetElement="_3">
				<omgdi:waypoint x="216.0" y="102.0"/>
				<omgdi:waypoint x="216.0" y="175.0"/>
				<bpmndi:BPMNLabel>
					<omgdc:Bounds height="0.0" width="0.0" x="0.0" y="0.0"/>
				</bpmndi:BPMNLabel>
			</bpmndi:BPMNEdge>
				<bpmndi:BPMNEdge bpmnElement="_6" id="BPMNEdge__6" sourceElement="_3"
				targetElement="_5">
				<omgdi:waypoint x="205.0" y="230.0"/>
				<omgdi:waypoint x="205.0" y="295.0"/>
				<bpmndi:BPMNLabel>
					<omgdc:Bounds height="0.0" width="0.0" x="0.0" y="0.0"/>
				</bpmndi:BPMNLabel>
			</bpmndi:BPMNEdge>
		</bpmndi:BPMNPlane>
	</bpmndi:BPMNDiagram>
</definitions>

BPMN 2.0 根节点是 definitions 节点。 这个元素中，可以定义多个流程定义（不过我们建议每个文件只包含一个流程定义， 可以简化开发过程中的维护难度）。 注意， definitions 元素 最少也要包含 xmlns 和 targetNamespace 的声明。 targetNamespace 可以是任意值，它用来对流程实例进行分类。
流程定义部分：定义了流程每个结点的描述及结点之间的流程流转。
流程布局定义：定义流程每个结点在流程图上的位置坐标等信息。

6.1.3 .png 图片文件

Eclipse 工具中的操作
流程图片生成的两种方式：

• 使用 activiti-designer 设计流程图时自动生成需在 eclipse 中进行配置：
  
  使用 designer 设计流程图的同时自动生成与 bpmn 文件同名的图片文件(.png)

• 由 activiti 自动生成图形
  流程图设计完毕向 activiti 中部署流程定义文件 bpmn，部署时由 activiti 自动生成流程图片。 (流程部署在下面的章节讲解)
  注意：此方法生成时如果图形中有中文，则生成的图片上显示乱码，且.bpmn 中的坐标和图片显示错位。

IDEA 工具中的操作方式

第一步：将 holiday.bpmn 文件改为扩展名 xml 的文件名称： holiday.xml
修改前的 bpmn 文件，效果如下：

第二步： 在 holiday.xml 文件上面，点右键并选择 Diagrams 菜单，再选择 Show BPMN2.0 Designer…

第三步： 打开后的效果图如下：

第四步：点击 Export To File 的小图标，如下：

打开如下窗口，注意填写文件名及扩展名，选择好保存图片的位置：

第五步：中文乱码的解决
1.打开 IDEA 安装路径，找到如下的安装目录

根据自己所安装的版本来决定，我使用的是 64 位的 idea，所以在 idea64.exe.vmoptions 文件的最后
一行追加一条命令： -Dfile.encoding=UTF-8
如下所示：

一定注意，不要有空格，否则重启 IDEA 时会打不开，然后 重启 IDEA，把原来的 png 图片删掉，再重新生成，即可解决乱码问题

6.2 流程定义部署

6.2.1 什么是流程定义部署

将线下定义的流程部署到 activiti 数据库中，这就是流程定义部署，通过调用 activiti 的 api 将流程定义的 bpmn 和 png 两个文件一个一个添加部署到 activiti 中，也可以将两个文件打成 zip 包进行部署。

6.2.2 单个文件部署方式

分别将 bpmn 文件和 png 图片文件部署。

@Test
public void deployProcess() {
     
// 获取repositoryService
RepositoryService repositoryService = processEngine.getRepositoryService();
// bpmn输入流
InputStream inputStream_bpmn = this.getClass().getClassLoader().getResourceAsStream("diagram/holiday.bpmn");
// 图片输入流
InputStream inputStream_png = this.getClass().getClassLoader().getResourceAsStream(" diagram/holiday.png");
// 流程部署对象
Deployment deployment = repositoryService.createDeployment().addInputStream("holiday.bpmn", inputStream_bpmn).addInputStream("holiday.png", inputStream_png).deploy();
System.out.println("流程部署id： " + deployment.getId());
System.out.println("流程部署名称： " + deployment.getName());
}

执行此操作后 activiti 会将上边代码中指定的 bpm 文件和图片文件保存在 activiti 数据库。

6.2.3 压缩包部署方式

将 holiday.bpmn 和 holiday.png 压缩成 zip 包。

@Test
public void deployProcessByZip() {
     
// 定义zip输入流
InputStream inputStream = this.getClass().getClassLoader().getResourceAsStream(" diagram/holiday.zip");
ZipInputStream zipInputStream = new ZipInputStream(inputStream);
// 获取repositoryService
RepositoryService repositoryService = processEngine.getRepositoryService();
// 流程部署
Deployment deployment = repositoryService.createDeployment()//.addZipInputStream(zipInputStream).deploy();
System.out.println("流程部署id： " + deployment.getId());
System.out.println("流程部署名称： " + deployment.getName());
}

执行此操作后 activiti 会将上边代码中指定的 bpm 文件和图片文件保存在 activiti 数据库。

6.2.4 操作数据表

流程定义部署后操作 activiti 数据表如下：

#流程定义部署表，记录流程部署信息
SELECT * FROM act_re_deployment 
#流程定义表，记录流程定义信息
SELECT * FROM act_re_procdef
#资源表
SELECT * FROM act_ge_bytearray 

说明：
act_re_deployment 和 act_re_procdef 一对多关系，一次部署在流程部署表生成一条记录，但一次部署可以部署多个流程定义，每个流程定义在流程定义表生成一条记录。每一个流程定义在
act_ge_bytearray 会存在两个资源记录， bpmn 和 png。
建议：一次部署一个流程，这样部署表和流程定义表是一对一的关系，方便读取流程部署及流程定义信息。

6.3 流程定义查询

查询部署的流程定义。

@Test
public void queryProceccDefinition() {
     
	// 流程定义key
	String processDefinitionKey = "holiday";
	// 获取repositoryService
	RepositoryService repositoryService = processEngine.getRepositoryService();
	// 查询流程定义
	ProcessDefinitionQuery processDefinitionQuery = repositoryService.createProcessDefinitionQuery();
	//遍历查询结果
	List<ProcessDefinition> list = processDefinitionQuery.processDefinitionKey(processDefinitionKey).orderByProcessDefinitionVersion().desc().list();
	for (ProcessDefinition processDefinition : list) {
     
		System.out.println("------------------------");
		System.out.println(" 流 程 部 署 id ： " +processDefinition.getDeploymentId());
		System.out.println("流程定义id： " + processDefinition.getId());
		System.out.println("流程定义名称： " + processDefinition.getName());
		System.out.println("流程定义key： " + processDefinition.getKey());
		System.out.println("流程定义版本： " + processDefinition.getVersion());
	}
}

6.4 流程定义删除

删除已经部署成功的流程定义。

public void deleteDeployment() {
     
	// 流程部署id
	String deploymentId = "8801";
	// 通过流程引擎获取repositoryService
	RepositoryService repositoryService = processEngine.getRepositoryService();
	//删除流程定义， 如果该流程定义已有流程实例启动则删除时出错
	repositoryService.deleteDeployment(deploymentId);
	//设置true 级联删除流程定义，即使该流程有流程实例启动也可以删除，设
	置为false非级别删除方式，如果流程
	//repositoryService.deleteDeployment(deploymentId, true);
}

说明：

1. 使用 repositoryService 删除流程定义
2. 如果该流程定义下没有正在运行的流程，则可以用普通删除。
3. 如果该流程定义下存在已经运行的流程，使用普通删除报错，可用级联删除方法将流程及相关
   记录全部删除。 项目开发中使用级联删除的情况比较多， 删除操作一般只开放给超级管理员使
   用。

6.5 流程定义资源查询

6.5.1 方式 1

通过流程定义对象获取流程定义资源，获取 bpmn 和 png。

@Test
public void getProcessResources() throws IOException {
     
	// 流程定义id
	String processDefinitionId = "";
	// 获取repositoryService
	RepositoryService repositoryService = processEngine.getRepositoryService();
	// 流程定义对象
	ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery().processDefinitionId(processDefinitionId).singleResult();
	//获取bpmn
	String resource_bpmn = processDefinition.getResourceName();
	//获取png
	String resource_png =processDefinition.getDiagramResourceName();
	// 资源信息
	System.out.println("bpmn： " + resource_bpmn);
	System.out.println("png： " + resource_png);
	File file_png = new File("d:/purchasingflow01.png");
	File file_bpmn = new File("d:/purchasingflow01.bpmn");
	// 输出bpmn
	InputStream resourceAsStream = null;
	resourceAsStream = repositoryService.getResourceAsStream(
	processDefinition.getDeploymentId(), resource_bpmn);
	FileOutputStream fileOutputStream = new FileOutputStream(file_bpmn);
	byte[] b = new byte[1024];
	int len = -1;
	while ((len = resourceAsStream.read(b, 0, 1024)) != -1) {
     
		fileOutputStream.write(b, 0, len);
	}
	// 输出图片
	resourceAsStream = repositoryService.getResourceAsStream(
	processDefinition.getDeploymentId(), resource_png);
	fileOutputStream = new FileOutputStream(file_png);
	// byte[] b = new byte[1024];
	// int len = -1;
	while ((len = resourceAsStream.read(b, 0, 1024)) != -1) {
     
		fileOutputStream.write(b, 0, len);
	}
}

6.5.2 方式 2

通过查询流程部署信息获取流程定义资源。

// 获取流程定义图片资源
@Test
public void getProcessResources() throws IOException {
     
	//流程部署id
	String deploymentId = "9001";
	// 通过流程引擎获取repositoryService
	RepositoryService repositoryService = processEngine.getRepositoryService();
	//读取资源名称
	List<String> resources =repositoryService.getDeploymentResourceNames(deploymentId);
	String resource_image = null;
	//获取图片
	for(String resource_name :resources){
     
		if(resource_name.indexOf(".png")>=0){
     
			resource_image = resource_name;
	    }
    }
	//图片输入流
	InputStream inputStream =
	repositoryService.getResourceAsStream(deploymentId, resource_image);
	File exportFile = new File("d:/holiday.png");
	FileOutputStream fileOutputStream = new FileOutputStream(exportFile);
	byte[] buffer = new byte[1024];
	int len = -1;
	//输出图片
	while((len = inputStream.read(buffer))!=-1){
     
		fileOutputStream.write(buffer, 0, len);
	}
	inputStream.close();
	fileOutputStream.close();
}

说明：

1. deploymentId 为流程部署 ID
2. resource_name 为 act_ge_bytearray 表中 NAME_列的值
3. 使用 repositoryService 的 getDeploymentResourceNames方法可以获取指定部署下得所有文件的名称
4. 使用 repositoryService 的 getResourceAsStream 方法传入部署 ID和资源图片名称可以获取部署下指定名称文件的输入流
5. 最后的将输入流中的图片资源进行输出。

6.6 流程历史信息的查看

即使流程定义已经删除了，流程执行的历史信息通过前面的分析，依然保存在 activiti 的 act_hi_*相
关的表中。所以我们还是可以查询流程执行的历史信息，可以通过 HistoryService 来查看相关的历史
记录。

public void testHistoric01(){
     
	HistoryService historyService = pe.getHistoryService();
	HistoricActivityInstanceQuery query =
	historyService.createHistoricActivityInstanceQuery();
	query.processInstanceId("1501");
	List<HistoricActivityInstance> list = query.list();
	for(HistoricActivityInstance ai :list){
     
		System.out.println(ai.getActivityId());
		System.out.println(ai.getActivityName());
		System.out.println(ai.getProcessDefinitionId());
		System.out.println(ai.getProcessInstanceId());
		System.out.println("==============================");
	}
}

七 流程实例

7.1 什么是流程实例

参与者（可以是用户也可以是程序）按照流程定义内容发起一个流程，这就是一个流程实例。是动
态的。流程定义和流程实例的图解：

7.2启动流程实例

流程定义部署在 activiti 后，就可以在系统中通过 activiti 去管理该流程的执行，执行流程表示流程的一次执行。比如部署系统请假流程后，如果某用户要申请请假，这时就需要执行这个流程，如果另外一个用户也要申请请假，则也需要执行该流程，每个执行互不影响，每个执行是单独的流程实例。

执行流程首先需要启动流程实例。

@Test
public void startProcessInstance() {
     
	// 流程定义key
	String processDefinitionKey = "";
	// 获取RunTimeService
	RuntimeService runtimeService = processEngine.getRuntimeService();
	// 根据流程定义key启动流程
	ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey);
	System.out.println(" 流 程 定 义 id ： " +
	processInstance.getProcessDefinitionId());
	System.out.println("流程实例id： " + processInstance.getId());
	System.out.println("当前活动Id： " + processInstance.getActivityId());
}

7.3Businesskey(业务标识)

启动流程实例时，指定的businesskey，就会在act_ru_execution流程实例的执行表中存储businesskey。

Businesskey：业务标识，通常为业务表的主键，业务标识和流程实例一一对应。业务标识来源于业务系统。存储业务标识就是根据业务标识来关联查询业务系统的数据。
比如： 请假流程启动一个流程实例，就可以将请假单的 id 作为业务标识存储到 activiti 中，将来查询activiti 的流程实例信息就可以获取请假单的 id 从而关联查询业务系统数据库得到请假单信息。

代码：

// 根据流程定义的key启动一个流程实例
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey,
businessKey);

Activiti 中存储业务标识：

7.4 操作数据库表

启动流程实例，操作如下数据库表：

#流程实例执行表，记录当前流程实例的执行情况
SELECT * FROM act_ru_execution

说明：
流程实例执行，如果当前只有一个分支时，一个流程实例只有一条记录且执行表的主键 id 和流程实
例 id 相同，如果当前有多个分支正在运行，则该执行表中有多条记录，存在执行表的主键和流程实例
id 不相同的记录。 不论当前有几个分支，总会有一条记录的执行表的主键和流程实例 id 相同。
一个流程实例运行完成，此表中与流程实例相关的记录删除。

#任务执行表，记录当前执行的任务
SELECT * FROM act_ru_task 

说明：启动流程实例，流程当前执行到第一个任务结点，此表会插入一条记录表示当前任务的执行
情况，如果任务完成则记录删除。

#任务参与者，记录当前参与任务的用户或组
SELECT * FROM act_ru_identitylink 

#流程实例历史表
SELECT * FROM act_hi_procinst 

流程实例启动，会在此表插入一条记录，流程实例运行完成记录也不会删除。

#任务历史表，记录所有任务
SELECT * FROM act_hi_taskinst 

开始一个任务，不仅在 act_ru_task 表插入记录，也会在历史任务表插入一条记录，任务历史表的主
键就是任务 id，任务完成此表记录不删除。

#活动历史表，记录所有活动
SELECT * FROM act_hi_actinst 

活动包括任务，所以此表中不仅记录了任务，还记录了流程执行过程的其它活动，比如开始事件、结束事件。

7.5 查询流程实例

流程在运行过程中可以查询流程实例的状态，当前运行结点等信息。

@Test
public void queryProcessInstance() {
     
	// 流程定义key
	String processDefinitionKey = "holiday";
	// 获取RunTimeService
	RuntimeService runtimeService = processEngine.getRuntimeService();
	List<ProcessInstance> list = runtimeService.createProcessInstanceQuery().processDefinitionKey(processDefinitionKey).list();
	for (ProcessInstance processInstance : list) {
     
		System.out.println("----------------------------");
		System.out.println("流程实例id： "+ processInstance.getProcessInstanceId());
		System.out.println("所属流程定义id： "+ processInstance.getProcessDefinitionId());
		System.out.println("是否执行完成： " + processInstance.isEnded());
		System.out.println("是否暂停： " + processInstance.isSuspended());
		System.out.println(" 当 前 活 动 标 识 ： " + processInstance.getActivityId());
	}
}

7.5.1 关联 businessKey

需求：
在 activiti 实际应用时，查询流程实例列表时可能要显示出业务系统的一些相关信息，比如：查询当
前运行的请假流程列表需要将请假单名称、 请假天数等信息显示出来， 请假天数等信息在业务系统
中存在，而并没有在 activiti 数据库中存在，所以是无法通过 activiti 的 api 查询到请假天数等信息。

实现：
在查询流程实例时，通过 businessKey（业务标识 ）关联查询业务系统的请假单表，查询出请假天
数等信息。
通过下面的代码就可以获取 activiti 中所对应实例保存的业务 Key。而这个业务 Key 一般都会保存相
关联的业务操作表的主键，再通过主键 ID 去查询业务信息，比如通过请假单的 ID，去查询更多的
请假信息（请假人，请假时间，请假天数，请假事由等）

String businessKey = processInstance.getBusinessKey();

在 activiti 的 act_ru_execution 表，字段 BUSINESS_KEY 就是存放业务 KEY 的。

7.6 挂起、激活流程实例

某些情况可能由于流程变更需要将当前运行的流程暂停而不是直接删除，流程暂停后将不会继续执行。

7.6.1 全部流程实例挂起

操作流程定义为挂起状态，该流程定义下边所有的流程实例全部暂停：
流程定义为挂起状态，该流程定义将不允许启动新的流程实例，同时该流程定义下所有的流程实例将
全部挂起暂停执行。

// 挂起激活流程定义
@Test
public void suspendOrActivateProcessDefinition() {
     
	// 流程定义id
	String processDefinitionId = "";
	RepositoryService repositoryService = processEngine.getRepositoryService();
	// 获得流程定义
	ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery().processDefinitionId(processDefinitionId).singleResult();
	//是否暂停
	boolean suspend = processDefinition.isSuspended();
	if(suspend){
     
		//如果暂停则激活，这里将流程定义下的所有流程实例全部激活
		repositoryService.activateProcessDefinitionById(processDefinitionId,true, null);
		System.out.println("流程定义： "+processDefinitionId+"激活");
	}else{
     
		//如果激活则挂起，这里将流程定义下的所有流程实例全部挂起
		repositoryService.suspendProcessDefinitionById(processDefinitionId,true, null);
		System.out.println("流程定义： "+processDefinitionId+"挂起");
	}
}

7.6.2 单个流程实例挂起

操作流程实例对象，针对单个流程执行挂起操作，某个流程实例挂起则此流程不再继续执行， 完成该流程实例的当前任务将报异常。

@Test
public void suspendOrActiveProcessInstance() {
     
	// 流程实例id
	String processInstanceId = "";
	// 获取RunTimeService
	RuntimeService runtimeService = processEngine.getRuntimeService();
	//根据流程实例id查询流程实例
	ProcessInstance processInstance =runtimeService.createProcessInstanceQuery().processInstanceId(processInstanceId).singleResult();
	boolean suspend = processInstance.isSuspended();
	if(suspend){
     
		//如果暂停则激活
		runtimeService.activateProcessInstanceById(processInstanceId);
		System.out.println("流程实例： "+processInstanceId+"激活");
	}else{
     
		//如果激活则挂起
		runtimeService.suspendProcessInstanceById(processInstanceId);
		System.out.println("流程实例： "+processInstanceId+"挂起");
	}
}

八 个人任务

8.1 分配任务负责人

8.1.1 固定分配

在进行业务流程建模时指定固定的任务负责人

在 properties 视图中，填写 Assignee 项为任务负责人。

8.1.1.1 注意事项

由于固定分配方式，任务只管一步一步执行任务，执行到每一个任务将按照 bpmn 的配置去分配任务负责人。

2.1.2 表达式分配

2.1.2.1 UEL 表达式

Activiti 使用 UEL 表达式， UEL 是 java EE6 规范的一部分， UEL（Unified Expression Language）即统一表达式语言， activiti 支持两个 UEL 表达式： UEL-value 和 UEL-method。

• UEL-value 定义如下：
  
  assignee 这个变量是 activiti 的一个流程变量。
  或：
  
  user 也是 activiti 的一个流程变量， user.assignee 表示通过调用 user 的 getter 方法获取值。

• UEL-method 方式如下：
  
  userBean 是 spring 容器中的一个 bean，表示调用该 bean 的 getUserId()方法。

• UEL-method 与 UEL-value 结合
  再比如：
  ${ldapService.findManagerForEmployee(emp)}
  ldapService 是 spring 容器的一个 bean，findManagerForEmployee 是该 bean 的一个方法，emp 是 activiti流程变量， emp 作为参数传到 ldapService.findManagerForEmployee 方法中。

• 其它
  表达式支持解析基础类型、 bean、 list、 array 和 map，也可作为条件判断。
  如下：
  ${order.price > 100 && order.price < 250}

8.1.2.2 使用流程变量分配任务

• 定义任务分配流程变量
  
• 设置流程变量
  在启动流程实例时设置流程变量，如下：

//启动流程实例时设计流程变量
//定义流程变量
Map<String, Object> variables = new HashMap<String, Object>();
//设置流程变量assignee
variables.put("assignee", "张三");
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey, variables);

8.1.2.3 注意事项

由于使用了表达式分配，必须保证在任务执行过程表达式执行成功，比如：
某个任务使用了表达式${order.price > 100 && order.price < 250}，当执行该任务时必须保证 order 在
流程变量中存在，否则 activiti 异常。

8.1.3 监听器分配

任务监听器是发生对应的任务相关事件时执行自定义 java 逻辑 或表达式。
任务相当事件包括：

Create：任务创建后触发
Assignment：任务分配后触发
Delete：任务完成后触发
All：所有事件发生都触发
java 逻辑 或表达式：
表达式参考上边的介绍的 UEL 表达式，这里主要介绍监听类使用。

定义任务监听类，且类必须实现 org.activiti.engine.delegate.TaskListener 接口

public class MyTaskListener implements TaskListener {
     
	@Override
	public void notify(DelegateTask delegateTask) {
     
		//这里指定任务负责人
		delegateTask.setAssignee("张三");
	}
}

8.1.3.1 注意事项

使用监听器分配方式，按照监听事件去执行监听类的 notify 方法，方法如果不能正常执行也会影响任务的执行。

8.2查询任务

查询任务负责人的待办任务：

// 查询当前个人待执行的任务
@Test
public void findPersonalTaskList() {
     
	// 流程定义key
	String processDefinitionKey = "holiday";
	// 任务负责人
	String assignee = "张三丰";
	// 创建TaskService
	TaskService taskService = processEngine.getTaskService();
	List<Task> list = taskService.createTaskQuery()
	.processDefinitionKey(processDefinitionKey)
	.includeProcessVariables().taskAssignee(assignee).list();
	for (Task task : list) {
     
		System.out.println("----------------------------");
		System.out.println("流程实例id： " + task.getProcessInstanceId());
		System.out.println("任务id： " + task.getId());
		System.out.println("任务负责人： " + task.getAssignee());
		System.out.println("任务名称： " + task.getName());
	}
}

8.2.1 关联 businessKey

需求：
在 activiti 实际应用时，查询待办任务可能要显示出业务系统的一些相关信息，比如：查询待审批请
假单任务列表需要将请假单的日期、 请假天数等信息显示出来， 请假天数等信息在业务系统中存在，
而并没有在 activiti 数据库中存在，所以是无法通过 activiti 的 api 查询到请假天数等信息。

实现：
在查询待办任务时，通过 businessKey（业务标识 ）关联查询业务系统的请假单表，查询出请假天
数等信息。

8.3办理任务

指定任务 id，调用 TaskService 完成任务：

// 完成任务
@Test
public void completTask() {
     
	//任务id
	String taskId = "10305";
	// 创建TaskService
	TaskService taskService = processEngine.getTaskService();
	taskService.complete(taskId);
	System.out.println("完成任务");
}

注意：在实际应用中，完成任务前需要校验任务的负责人是否具有该任务的办理权限。

九 流程变量

9.1 什么是流程变量

流程变量在 activiti 中是一个非常重要的角色，流程运转有时需要靠流程变量，业务系统和 activiti结合时少不了流程变量，流程变量就是 activiti 在管理工作流时根据管理需要而设置的变量。比如在请假流程流转时如果请假天数大于 3 天则由总经理审核，否则由人事直接审核， 请假天数就可以设置为流程变量，在流程流转时使用。

注意：虽然流程变量中可以存储业务数据可以通过 activiti 的 api 查询流程变量从而实现查询业务数据，但是不建议这样使用，因为业务数据查询由业务系统负责， activiti 设置流程变量是为了流程执行需要而创建。

9.2流程变量类型

注意：如果将 pojo 存储到流程变量中，必须实现序列化接口 serializable，为了防止由于新增字段无
法反序列化，需要生成 serialVersionUID。

9.3 流程变量作用域

流程变量的作用域默认是一个流程实例(processInstance)，也可以是一个任务(task)或一个执行实例
(execution)，这三个作用域流程实例的范围最大，可以称为 global 变量，任务和执行实例仅仅是针对
一个任务和一个执行实例范围，范围没有流程实例大， 称为 local 变量。

如下：
一个流程实例
Global 变量： userId（变量名）： zhangsan（变量值）
变量名不允许重复

global 变量中变量名不允许重复，设置相同名称的变量，后设置的值会覆盖前设置的变量值。
Local 变量由于在不同的任务或不同的执行实例中，作用域互不影响，变量名可以相同没有影响。
Local 变量名也可以和 global 变量名相同，没有影响。

9.4 流程变量的使用方法

第一步：设置流程变量
第二步：通过 UEL 表达式使用流程变量

1. 可以在 assignee 处设置 UEL 表达式，表达式的值为任务的负责人
   比如： ${assignee}， assignee 就是一个流程变量名称
   Activiti 获取 UEL 表达式的值 ，即流程变量 assignee 的值 ，将 assignee 的值作为任务的负责人进行任务分配
2. 可以在连线上设置 UEL 表达式，决定流程走向
   比如： $price>=10000和${price<10000}: price 就是一个流程变量名称， uel 表达式结果类型为布尔类型

如果 UEL 表达式是 true，要决定 流程执行走向。

9.5 使用 Global 变量控制流程

9.5.1 需求：

员工创建请假申请单，由部门经理审核，部门经理审核通过后请假 3 天及以下由人事经理直接审核， 3 天以上先由总经理审核，总经理审核通过再由人事经理存档。

9.5.2流程程定义

请假天数大于等于 3 连线条件：

请假天数小于 3 连线条件：

9.5.3 设置 global 流程变量

在部门经理审核前设置流程变量，变量值为请假单信息（包括请假天数），部门经理审核后可以根据
流程变量的值决定流程走向。

9.5.3.1 启动流程时设置

在启动流程时设置流程变量，变量的作用域是整个流程实例。
通过 map设置流程变量， map 中可以设置多个变量，这个 key 就是流程变量的名字。

// 启动流程时设置流程变量
@Test
public void startProcessInstance() {
     
	// 流程定义key
	String processDefinitionKey = "";
	Holiday holiday = new Holiday();
	holiday.setNum(3);
	// 定义流程变量
	Map<String, Object> variables = new HashMap<String, Object>();
	//变量名是num，变量值是holiday.getNum(),变量名也可以是一个对象
	variables.put("num", holiday.getNum());
	RuntimeService runtimeService = processEngine.getRuntimeService();
	ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey, variables);
	System.out.println(" 流 程 实 例 id:" + processInstance.getProcessInstanceId());
}

说明：
startProcessInstanceByKey(processDefinitionKey, variables)流程变量作用域是一个流
程实例，流程变量使用 Map 存储，同一个流程实例设置变量 map 中 key 相同，后者覆盖前者。

9.5.3.2 任务办理时设置

在完成任务时设置流程变量，该流程变量只有在该任务完成后其它结点才可使用该变量，它的作用域是整个流程实例，如果设置的流程变量的 key 在流程实例中已存在相同的名字则后设置的变量替换前边设置的变量。

这里需要在创建请假单任务完成时设置流程变量

// 办理任务时设置流程变量
@Test
public void completTask() {
     
	//任务id
	String taskId = "";
	TaskService taskService = processEngine.getTaskService();
	Holiday holiday = new Holiday();
	holiday.setNum(4);
	// 定义流程变量
	Map<String, Object> variables = new HashMap<String, Object>();
	//变量名是holiday，变量值是holiday对象
	variables.put("holiday", holiday);
	taskService.complete(taskId, variables);
}

说明：
通过当前任务设置流程变量，需要指定当前任务 id，如果当前执行的任务 id 不存在则抛出异常。
任务办理时也是通过 map设置流程变量，一次可以设置多个变量。

9.5.3.3 通过当前流程实例设置

通过流程实例 id 设置全局变量，该流程实例必须未执行完成。

public void setGlobalVariableByExecutionId(){
     
	//当前流程实例执行 id，通常设置为当前执行的流程实例
	String executionId="2601";
	RuntimeService runtimeService = processEngine.getRuntimeService();
	Holiday holiday = new Holiday();
	holiday.setNum(3);
	//通过流程实例 id设置流程变量
	runtimeService.setVariable(executionId, "holiday", holiday);
	//一次设置多个值
	//runtimeService.setVariables(executionId, variables)
}

注意：
executionId 必须当前未结束 流程实例的执行 id，通常此 id 设置流程实例 的 id。
也可以通过 runtimeService.getVariable()获取流程变量

9.5.3.4 通过当前任务设置

@Test
public void setGlobalVariableByTaskId(){
     
	//当前待办任务id
	String taskId="1404";
	TaskService taskService = processEngine.getTaskService();
	Holiday holiday = new Holiday();
	holiday.setNum(3);
	//通过任务设置流程变量
	taskService.setVariable(taskId, "holiday", holiday);
	//一次设置多个值
	//taskService.setVariables(taskId, variables)
}

注意：
任务id必须是当前待办任务id， act_ru_task中存在。 如果该任务已结束，报错：

也可以通过 taskService.getVariable()获取流程变量。

9.5.4测试

• 正常测试：
  设置流程变量的值大于等于 3 天
  设计流程变量的值小于 3 天

• 异常测试：
  流程变量不存在
  流程变量的值为空 NULL， price 属性为空
  UEL 表达式都不符合条件
  不设置连线的条件

9.5.5注意事项

1. 如果 UEL 表达式中流程变量名不存在则报错。
2. 如果 UEL 表达式中流程变量值为空 NULL，流程不按 UEL 表达式去执行，而流程结束 。
3. 如果 UEL 表达式都不符合条件，流程结束
4. 如果连线不设置条件，会走 flow 序号小的那条线

操作数据库表

设置流程变量会在当前执行流程变量表插入记录，同时也会在历史流程变量表也插入记录。

SELECT * FROM act_ru_variable #当前流程变量表
记录当前运行流程实例可使用的流程变量，包括 global 和 local 变量
Id_：主键
Type_：变量类型
Name_：变量名称
Execution_id_：所属流程实例执行 id， global 和 local 变量都存储
Proc_inst_id_：所属流程实例 id， global 和 local 变量都存储
Task_id_：所属任务 id， local 变量存储
Bytearray_： serializable 类型变量存储对应 act_ge_bytearray 表的 id
Double_： double 类型变量值
Long_： long 类型变量值
Text_： text 类型变量值

SELECT * FROM act_hi_varinst #历史流程变量表
记录所有已创建的流程变量，包括 global 和 local 变量
字段意义参考当前流程变量表。

9.6设置 local 流程变量

9.6.1 任务办理时设置

任务办理时设置 local 流程变量，当前运行的流程实例只能在该任务结束前使用，任务结束该变量无法在当前流程实例使用，可以通过查询历史任务查询。

// 办理任务时设置local流程变量
@Test
public void completTask() {
     
	//任务id
	String taskId = "";
	TaskService taskService = processEngine.getTaskService();
	// 定义流程变量
	Map<String, Object> variables = new HashMap<String, Object>();
	Holiday holiday = new Holiday ();
	holiday.setNum(3);
	// 定义流程变量
	Map<String, Object> variables = new HashMap<String, Object>();
	//变量名是holiday，变量值是holiday对象
	variables.put("holiday", holiday);
	// 设置local变量，作用域为该任务
	taskService.setVariablesLocal(tasked, variables);
	taskService.complete(taskId);
}

说明：
设置作用域为任务的 local 变量，每个任务可以设置同名的变量，互不影响。

9.6.2 通过当前任务设置

@Test
public void setLocalVariableByTaskId(){
     
	//当前待办任务id
	String taskId="1404";
	TaskService taskService = processEngine.getTaskService();
	Holiday holiday = new Holiday ();
	holiday.setNum(3);
	//通过任务设置流程变量
	taskService.setVariableLocal(taskId, "holiday", holiday);
	//一次设置多个值
	//taskService.setVariablesLocal(taskId, variables)
}

注意：
任务 id 必须是当前待办任务 id， act_ru_task 中存在。

9.6.3 Local 变量测试 1

如果上边例子中设置 global 变量改为设置 local 变量是否可行？为什么？

Local 变量在任务结束后无法在当前流程实例执行中使用，如果后续的流程执行需要用到此变量则会
报错。

9.6.4 Local 变量测试 2

在部门经理审核、总经理审核、人事经理审核时设置 local 变量，可通过 historyService 查询每个历
史任务时将流程变量的值也查询出来。

代码如下：

// 创建历史任务查询对象
HistoricTaskInstanceQuery historicTaskInstanceQuery =historyService.createHistoricTaskInstanceQuery();
// 查询结果包括 local变量
historicTaskInstanceQuery.includeTaskLocalVariables();
for (HistoricTaskInstance historicTaskInstance : list) {
     
	System.out.println("==============================");
	System.out.println(" 任 务 id ： " + historicTaskInstance.getId());
	System.out.println(" 任 务 名 称 ： " + historicTaskInstance.getName());
	System.out.println(" 任 务 负 责 人 ： " + historicTaskInstance.getAssignee());
	System.out.println(" 任 务 local 变 量 ： "+ historicTaskInstance.getTaskLocalVariables());
}

注意：查询历史流程变量，特别是查询 pojo 变量需要经过反序列化，不推荐使用。

十 组任务

10.1 Candidate-users 候选人

10.1.1需求

在流程定义中在任务结点的 assignee 固定设置任务负责人，在流程定义时将参与者固定设置在.bpmn 文件中，如果临时任务负责人变更则需要修改流程定义，系统可扩展性差。针对这种情况可以给任务设置多个候选人，可以从候选人中选择参与者来完成任务。

设置任务候选人

在流程图中任务节点的配置中设置 candidate-users(候选人)，多个候选人之间用逗号分开。

查看 bpmn 文件：

我们可以看到部门经理的审核人已经设置为 zhangsan,lishi 这样的一组候选人，可以使用activiti:candiateUsers=”用户 1,用户 2,用户 3”的这种方式来实现设置一组候选人。

办理组任务

10.1.1.1 组任务办理流程

第一步：查询组任务
指定候选人，查询该候选人当前的待办任务。
候选人不能办理任务。

第二步：拾取(claim)任务
该组任务的所有候选人都能拾取。
将候选人的组任务，变成个人任务。原来候选人就变成了该任务的负责人。
***如果拾取后不想办理该任务？
需要将已经拾取的个人任务归还到组里边，将个人任务变成了组任务。

第三步：查询个人任务
查询方式同个人任务部分，根据 assignee 查询用户负责的个人任务。

第四步：办理个人任务

10.1.1.2 用户查询组任务

根据候选人查询组任务

@Test
public void findGroupTaskList() {
     
	// 流程定义key
	String processDefinitionKey = "holiday4";
	// 任务候选人
	String candidateUser = "zhangsan";
	// 创建TaskService
	TaskService taskService = processEngine.getTaskService();
	//查询组任务
	List<Task> list = taskService.createTaskQuery()//
	.processDefinitionKey(processDefinitionKey)//
	.taskCandidateUser(candidateUser)//根据候选人查询
	.list();
	for (Task task : list) {
     
		System.out.println("----------------------------");
		System.out.println("流程实例id： " + task.getProcessInstanceId());
		System.out.println("任务id： " + task.getId());
		System.out.println("任务负责人： " + task.getAssignee());
		System.out.println("任务名称： " + task.getName());
	}
}

10.1.1.3 用户拾取组任务

候选人员拾取组任务后该任务变为自己的个人任务。

@Test
public void claimTask(){
     
	TaskService taskService = processEngine.getTaskService();
	//要拾取的任务id
	String taskId = "6302";
	//任务候选人id
	String userId = "lisi";
	//拾取任务
	//即使该用户不是候选人也能拾取(建议拾取时校验是否有资格)
	//校验该用户有没有拾取任务的资格
	Task task = taskService.createTaskQuery()//
	.taskId(taskId)
	.taskCandidateUser(userId)//根据候选人查询
	.singleResult();
	if(task!=null){
     
		taskService.claim(taskId, userId);
		System.out.println("任务拾取成功");
	}
}

说明： 即使该用户不是候选人也能拾取， 建议拾取时校验是否有资格；组任务拾取后，该任务已有负责人，通过候选人将查询不到该任务

10.1.1.4 用户查询个人待办任务

查询方式同个人任务查询

@Test
public void findPersonalTaskList() {
     
	// 流程定义key
	String processDefinitionKey = "holiday4";
	// 任务负责人
	String assignee = "zhangsan";
	// 创建TaskService
	TaskService taskService = processEngine.getTaskService();
	List<Task> list = taskService.createTaskQuery()//
	.processDefinitionKey(processDefinitionKey)//
	.taskAssignee(assignee).list();
	for (Task task : list) {
     
		System.out.println("----------------------------");
		System.out.println(" 流 程 实 例 id ： " +
		task.getProcessInstanceId());
		System.out.println("任务id： " + task.getId());
		System.out.println("任务负责人： " + task.getAssignee());
		System.out.println("任务名称： " + task.getName());
	}
}

10.1.1.5 用户办理个人任务

同个人任务办理

/**完成任务*/
@Test
public void completeTask(){
     
	//任务ID
	String taskId = "12304";
	processEngine.getTaskService().complete(taskId);
	System.out.println("完成任务： "+taskId);
}

说明：建议完成任务前校验该用户是否是该任务的负责人。

10.1.1.6 归还组任务

如果个人不想办理该组任务，可以归还组任务，归还后该用户不再是该任务的负责人

// 归还组任务，由个人任务变为组任务，还可以进行任务交接
@Test
public void setAssigneeToGroupTask() {
     
	// 查询任务使用TaskService
	TaskService taskService = processEngine.getTaskService();
	// 当前待办任务
	String taskId = "6004";
	// 任务负责人
	String userId = "zhangsan2";
	// 校验userId是否是taskId的负责人，如果是负责人才可以归还组任务
	Task task = taskService.createTaskQuery().taskId(taskId)
	.taskAssignee(userId).singleResult();
	if (task != null) {
     
		// 如果设置为null，归还组任务,该 任务没有负责人
		taskService.setAssignee(taskId, null);
	}
}

说明： 建议归还任务前校验该用户是否是该任务的负责人，也可以通过 setAssignee 方法将任务委托给其它用户负责，注意被委托的用户可以不是候选人（建议不要这样使用）

10.1.1.7 任务交接

任务交接,任务负责人将任务交给其它候选人办理该任务

@Test
public void setAssigneeToCandidateUser() {
     
	// 查询任务使用TaskService
	TaskService taskService = processEngine.getTaskService();
	// 当前待办任务
	String taskId = "6004";
	// 任务负责人
	String userId = "zhangsan2";
	// 校验userId是否是taskId的负责人，如果是负责人才可以归还组任务
	Task task = taskService.createTaskQuery().taskId(taskId)
	.taskAssignee(userId).singleResult();
	if (task != null) {
     
		// 将此任务交给其它候选人办理该 任务
		String candidateuser = "zhangsan";
		// 根据候选人和组任务id查询，如果有记录说明该 候选人有资格拾取该 任务
		Task task2 = taskService.createTaskQuery().taskId(taskId)
		.taskCandidateUser(candidateuser).singleResult();
		if (task2 != null) {
     
			// 才可以交接
			taskService.setAssignee(taskId, candidateuser);
		}
	}
}

10.1.1.8 数据库表操作

SELECT * FROM act_ru_task #任务执行表，记录当前执行的任务，由于该任务当前是组任务，所有
assignee 为空，当拾取任务后该字段就是拾取用户的 id

SELECT * FROM act_ru_identitylink #任务参与者，记录当前参考任务用户或组，当前任务如果设置
了候选人，会向该表插入候选人记录，有几个候选就插入几个

与 act_ru_identitylink 对应的还有一张历史表 act_hi_identitylink，向 act_ru_identitylink 插入记录的同
时也会向历史表插入记录。任务完成

十一 网关

11.1 排他网关

11.1.1 什么是排他网关：

排他网关（也叫异或（XOR）网关，或叫基于数据的排他网关），用来在流程中实现决策。 当流程
执行到这个网关，所有分支都会判断条件是否为 true，如果为 true 则执行该分支，注意，排他网关只会选择一个为 true 的分支执行。 (即使有两个分支条件都为 true， 排他网关也会只选择一条分支去执行)
为什么要用排他网关？
不用排他网关也可以实现分支，如下图：

上图中，在连线的 condition 条件上设置分支条件。
缺点：
如果条件都不满足，不使用排他网关，流程就结束了(是异常结束)。
如果 使用排他网关决定分支的走向，如下：

如果从网关出去的线所有条件都不满足则系统抛出异常。

org.activiti.engine.ActivitiException: No outgoing sequence flow of the
exclusive gateway 'exclusivegateway1' could be selected for continuing
the process
at
org.activiti.engine.impl.bpmn.behavior.ExclusiveGatewayActivityBehav
ior.leave(ExclusiveGatewayActivityBehavior.java:85)

说明 ：经过排他网关必须要有一条且只有一条分支走。

11.1.2流程定义

图标：

11.1.3测试

在部门经理审核后，走排他网关，从排他网关出来的分支有两条，一条是判断请假天数是否大于 3天，另一条是判断请假天数是否小于等于 3 天。
设置分支条件时，如果所有分支条件都不是 true，报错：
org.activiti.engine.ActivitiException: No outgoing sequence flow of the exclusive gateway
‘exclusivegateway1’ could be selected for continuing the process
at
org.activiti.engine.impl.bpmn.behavior.ExclusiveGatewayActivityBehavior.leave(ExclusiveGatewayActivit
yBehavior.java:85)

11.2 并行网关

11.2.1什么是并行网关

并行网关允许将流程分成多条分支，也可以把多条分支汇聚到一起，并行网关的功能是基于进入和外出顺序流的：

• fork 分支：
  并行后的所有外出顺序流，为每个顺序流都创建一个并发分支。
• join 汇聚：
  所有到达并行网关，在此等待的进入分支， 直到所有进入顺序流的分支都到达以后， 流程就会通
  过汇聚网关。
  注意，如果同一个并行网关有多个进入和多个外出顺序流， 它就同时具有分支和汇聚功能。 这时，网关会先汇聚所有进入的顺序流，然后再切分成多个并行分支。

与其他网关的主要区别是，并行网关不会解析条件。 即使顺序流中定义了条件，也会被忽略。

例子：

说明：
财务结算和入库是两个 execution 分支，在 act_ru_execution 表有两条记录分别是财务结算和入库，
act_ru_execution 还有一条记录表示该流程实例。
待财务结算和入库任务全部完成，在汇聚点汇聚，通过 parallelGateway 并行网关。
并行网关在业务应用中常用于会签任务，会签任务即多个参与者共同办理的任务。

11.2.2流程定义

图标：

11.2.3测试

当执行到并行网关数据库跟踪如下：
当前任务表： SELECT * FROM act_ru_task #当前任务表

上图中：有两个(多个)任务当前执行。
通过流程实例执行表： SELECT * FROM act_ru_execution #流程实例的执行表

上图中，说明当前流程实例有多个分支(两个)在运行。
对并行任务的执行：
并行任务执行不分前后，由任务的负责人去执行即可。

当完成并任务中一个任务后：
已完成的任务在当前任务表 act_ru_task_已被删除。
在流程实例执行表： SELECT * FROM act_ru_execution 有中多个分支存在且有并行网关的汇聚结点。

有并行网关的汇聚结点：说明有一个分支已经到汇聚，等待其它的分支到达。
当所有分支任务都完成，都到达汇聚结点后：
流程实例执行表： SELECT * FROM act_ru_execution，执行流程实例不存在，说明流程执行结束。
总结：所有分支到达汇聚结点，并行网关执行完成。

11.3 包含网关

11.3.1 什么是包含网关

包含网关可以看做是排他网关和并行网关的结合体。 和排他网关一样，你可以在外出顺序流上定义条件，包含网关会解析它们。 但是主要的区别是包含网关可以选择多于一条顺序流，这和并行网关一样。
包含网关的功能是基于进入和外出顺序流的：

• 分支：
  所有外出顺序流的条件都会被解析，结果为 true 的顺序流会以并行方式继续执行， 会为每个顺序流创建一个分支。
• 汇聚：
  所有并行分支到达包含网关，会进入等待状态， 直到每个包含流程 token 的进入顺序流的分支都到达。 这是与并行网关的最大不同。换句话说，包含网关只会等待被选中执行了的进入顺序流。 在汇聚之后，流程会穿过包含网关继续执行。

11.3.2 流程定义：

企业体检流程，公司全体员工进行常规项检查、抽血化验，公司管理层除常规检查和抽血化验还要进行增加项检查。

图标：

员工类型：
通过流程变量 userType 来表示，如果等于 1 表示普通员工，如果等于 2 表示领导

注意：通过包含网关的每个分支的连线上设置 condition 条件。

11.3.3测试

如果包含网关设置的条件中，流程变量不存在，报错;
org.activiti.engine.ActivitiException: Unknown property used in expression: ${userType==‘1’ ||
userType==‘2’}

需要在流程启动时设置流程变量 userType
当执行到包含网关：
流程实例执行表： SELECT * FROM act_ru_execution

第一条记录：包含网关分支。
后两条记录：两个分支：常规项体检，抽血化验
当前任务表： ACT_RU_TASK

上图中，常规项体检，抽血化验都是当前的任务，在并行执行。
如果有一个分支执行到汇聚：

先走到汇聚结点的分支，要等待其它分支走到汇聚。
等所有分支走到汇聚，包含网关就执行完成。

包含网关执行完成，分支和汇聚就从 act_ru_execution 删除。

小结：在分支时，需要判断条件， 符合条件的分支，将会执行，符合条件的分支最终才进行汇聚。

十二 总结

什么是工作流？
就是通过计算机对业务流程进行自动化管理，实现多个参与者按照预定义的流程去自动执行业务流程。

什么 activiti？
Activiti 是一个工作流的引擎，开源的架构，基本 bpmn2.0 标准进行流程定义，它的是前身是 jbpm。Activiti 通过是要嵌入到业务系统开发使用。

如何使用 activiti 开发？

• 第一步：部署 activiti 的环境。
  环境包括： jar 包和数据库（25 张表）
  业务系统通过 spring 和 activiti 整合进行开发。

• 第二步：使用 activiti 提供流程设计器（和 idea 或 eclipse 集成的 designer）工具进行流程定义
  流程定义生成两个文件： .bpmn 和.png（不是必须的）。

• 第三步；将流程定义文件部署到 activiti 的数据库
  SELECT * FROM act_re_deployment #流程定义部署表
  一次部署插入一条记录，记录流程定义的部署信息

SELECT * FROM act_re_procdef #流程定义表
一次部署流程定义信息，如果一次部署两个流程定义，插入两条记录
建议：一次部署只部署一个流程定义，这样 act_re_deployment 和 act_re_procdef 一对一关系
常用两个方法：单个文件部署和 zip 文件部署。
建议单个文件部署。

• 第四步： 启动一个流程实例
  业务系统就可以按照流程定义去执行业务流程，执行前需要启动一个流程实例根据流程定义来启动一个流程实例。
  指定一个流程定义的 key 启动一个流程实例， activiti 根据 key 找最新版本的流程定义。
  指定一个流程定义的 id 启动一个流程实例。
  启动一个实例需要指定 businesskey（业务标识）， businessKey 是 activiti 和业务系统整合时桥梁。
  比如： 请假流程， businessKey 就是请假单 id。
  启动一个实例还可以指定流程变量，流程变量是全局变量（生命期是整个流程实例，流程实例结束，变量就消失）

• 第五步：查询待办任务
  查询个人任务：使用 taskService，根据 assignee 查询该用户当前的待办任务。
  查询组任务：使用 taskService，根据 candidateuser 查询候选用户当前的待办组任务。

• 第六步：办理任务
  办理个人任务：调用 taskService 的 complete 方法完成任务。
  如果是组任务，需要先拾取任务，调用 taskService 的 claim 方法拾取任务，拾取任务之后组任务就变成了个人任务（该任务就有负责人）。
  网关：
  排他网关：任务执行之后的分支，经过排他网关分支只有一条有效。
  并行网关：任务执行后，可以多条分支，多条分支总会汇聚，汇聚完成，并行网关结束。
  包含网关：是排他网关和并行网关结合体。