2021-01-23
Activiti工作流-核心技术
1:工作流的概念
工作流管理系统的目标:管理工作的流程以确保工作在正确的时间被期望的人员所执行——在自动化进行的业务过程中插入人工的执行和干预。
2:安装插件
在eclispe中开发
- 有在线安装和离线安装两种方式,但是两种安装都需要用到网络。有可能两种安装方式都不成功,因为需要考虑eclipse版本,与插件版本问题。(我在安装过程中,在线安装,是失败的,但是离线安装成功了,很迷)
方式一(在线安装):
在有网络的情况下,安装流程设计器步骤如下:
打开 Help -> Install New Software. 在如下面板中:
在如下Install界面板中,**点击Add按钮**:
配置新装插件的地址和名称
然后填入下列字段
Name: Activiti BPMN 2.0 designer
Location: http://activiti.org/designer/update/
回到Install界面,在面板正中列表中把所有展示出来的项目都勾上:
点击复选框
在Detail部分记得选中 “Contact all updates sites..” , 因为它会检查所有当前安装所需要的插件并可以被Eclipse下载.
安装完以后,点击新建工程new->Other…打开面板,如果看到下图内容:
方式二(离线安装):
可以在没有网络的情况下,安装流程设计器步骤如下:
解压:
将解压开的jars里面三个jar放入到 eclipse/plugins 中
以下内容就是要连接到网络了
1)打开 Help -> Install New Software. 在如下面板中:
2)在如下Install界面板中,点击Add按钮:
配置新装插件的地址和名称
3)然后填入下列
Location 选择刚刚解压的Activiti Designer 中的 zip包
4)回到Install界面,在面板正中列表中把所有展示出来的项目都勾上:
5)点击复选框
在Detail部分记得选中 “Contact all updates sites..” , 因为它会检查所有当前安装所需要的插件并可以被Eclipse下载.
验证方式跟方式一 一样。
3:Activiti介绍
Activiti5是由Alfresco软件在2010年5月17日发布的业务流程管理(BPM)框架,它是覆盖了业务流程管理、工作流、服务协作等领域的一个开源的、灵活的、易扩展的可执行流程语言框架。Activiti基于Apache许可的开源BPM平台,创始人Tom Baeyens是JBoss jBPM的项目架构师,它特色是提供了eclipse插件,开发人员可以通过插件直接绘画出业务
流程图。
3.1:工作流引擎
ProcessEngine对象,这是Activiti工作的核心。负责生成流程运行时的各种实例及数据、监控和管理流程的运行。
3.2:BPMN
业务流程建模与标注(Business Process Model and Notation,BPMN) ,描述流程的基本符号,包括这些图元如何组合成一个业务流程图(Business Process Diagram)``
3.3:数据库(先学后看)
Activiti数据库支持:
Activiti的后台是有数据库的支持,所有的表都以ACT_开头。 第二部分是表示表的用途的两个字母标识。 用途也和服务的API对应。
ACT_RE_*: ‘RE’表示repository。 这个前缀的表包含了流程定义和流程静态资源 (图片,规则,等等)。
ACT_RU_*: ‘RU’表示runtime。 这些运行时的表,包含流程实例,任务,变量,异步任务,等运行中的数据。 Activiti只在流程实例执行过程中保存这些数据, 在流程结束时就会删除这些记录。 这样运行时表可以一直很小速度很快。
ACT_ID_*: ‘ID’表示identity。 这些表包含身份信息,比如用户,组等等。
ACT_HI_*: ‘HI’表示history。 这些表包含历史数据,比如历史流程实例, 变量,任务等等。
ACT_GE_*: 通用数据, 用于不同场景下,如存放资源文件。
表结构操作:
3.3.1:资源库流程规则表
act_re_deployment 部署信息表
act_re_model 流程设计模型部署表
act_re_procdef 流程定义数据表
3.3.2:运行时数据库表
act_ru_execution 运行时流程执行实例表
act_ru_identitylink 运行时流程人员表,主要存储任务节点与参与者的相关信息
act_ru_task 运行时任务节点表
act_ru_variable 运行时流程变量数据表
3.3.3:历史数据库表
act_hi_actinst 历史节点表
act_hi_attachment 历史附件表
act_hi_comment 历史意见表
act_hi_identitylink 历史流程人员表
act_hi_detail 历史详情表,提供历史变量的查询
act_hi_procinst 历史流程实例表
act_hi_taskinst 历史任务实例表
act_hi_varinst 历史变量表
3.3.4:组织机构表
act_id_group 用户组信息表
act_id_info 用户扩展信息表
act_id_membership 用户与用户组对应信息表
act_id_user 用户信息表
这四张表很常见,基本的组织机构管理,关于用户认证方面建议还是自己开发一套,组件自带的功能太简单,使用中有很多需求难以满足
3.3.5:通用数据表
act_ge_bytearray 二进制数据表
act_ge_property 属性数据表存储整个流程引擎级别的数据,初始化表结构时,会默认插入三条记录,
3.4:activiti.cfg.xml(activiti的配置文件)
Activiti核心配置文件,配置流程引擎创建工具的基本参数和数据库连接池参数。
定义数据库配置参数:
jdbcUrl: 数据库的JDBC URL。
jdbcDriver: 对应不同数据库类型的驱动。
jdbcUsername: 连接数据库的用户名。
jdbcPassword: 连接数据库的密码。
基于JDBC参数配置的数据库连接 会使用默认的MyBatis连接池。 下面的参数可以用来配置连接池(来自MyBatis参数):
jdbcMaxActiveConnections: 连接池中处于被使用状态的连接的最大值。默认为10。
jdbcMaxIdleConnections: 连接池中处于空闲状态的连接的最大值。
jdbcMaxCheckoutTime: 连接被取出使用的最长时间,超过时间会被强制回收。 默认为20000(20秒)。
jdbcMaxWaitTime: 这是一个底层配置,让连接池可以在长时间无法获得连接时, 打印一条日志,并重新尝试获取一个连接。(避免因为错误配置导致沉默的操作失败)。 默认为20000(20秒)。
4.4:准备Activiti5开发环境
1:添加Activiti5的jar包
注意:一定不要忘记添加mysql 数据库的jar包,否则万劫不复!
2:初始化数据库
1)JDBC方式
1 | import org.activiti.engine.ProcessEngine; |
注意建表策略
在Activiti中,在创建核心的流程引擎对象时会自动建表。如果程序正常执行,mysql会自动建库,然后创建23张表。
2)Spring方式
添加并制定配置文件
在Actiiti5中定制流程必定会操作到数据库,如果都像上面那样写一大段代码会非常麻烦,所以我们可以把数据库连接配置写入配置文件。
activiti.cfg.xml(名字必须是这个)
1 | <beans xmlns="http://www.springframework.org/schema/beans" |
1 | package com.gec.test; |
createProcessEngineConfigurationFromResource的参数值为我们添加的配置文件activiti.cfg.xml的名称,执行java代码,流程引擎对象创建成功运行后数据库会自动建表。
3)快速创建方式(开发中常用)
配置文件名为:activiti.cfg.xml(名字必须是这个)
掌握
1 | package com.gec.test; |
运行成功:
表也创建成功
思考:凭什么这么一句代码就可以创建出 ProcessEngine对象呢?
自动加载了activiti.cfg.xml文件。
5:核心API
5.1:ProcessEngine
说明:
在Activiti中最核心的类,其他的类都是由他而来!!!
- 产生方式:
在前面看到了两种创建ProcessEngine(流程引擎)的方式,而这里要简化很多,调用ProcessEngines的getDefaultProceeEngine方法时会自动加载classpath下名为activiti.cfg.xml文件。
- 可以产生RepositoryService(部署流程)
- 可以产生RuntimeService(启动流程)
- 可以产生TaskService(对任务操作)
各个Service的作用:
RepositoryService | 管理流程定义 |
---|---|
RuntimeService | 执行管理,包括启动、推进、删除流程实例等操作 |
TaskService | 任务管理 |
HistoryService | 历史管理(执行完的数据的管理) |
IdentityService | 组织机构管理 |
FormService | 一个可选服务,任务表单管理 |
ManagerService | 管理服务 |
5.2:RepositoryService
是Activiti的仓库服务类。所谓的仓库指流程定义文档的两个文件:bpmn文件和流程图片。
- 产生方式
- 可以产生DeploymentBuilder,用来定义流程部署的相关参数
- 删除流程定义
5.3:RuntimeService
是activiti的流程执行服务类。可以从这个服务类中获取很多关于流程执行相关的信息。
5.4:TaskService
是activiti的任务服务类。可以从这个类中获取任务的信息。
5.5:HistoryService
是activiti的查询历史信息的类。在一个流程执行完成后,这个对象为我们提供查询历史信息。
5.6:ProcessDefinition
流程定义类。可以从这里获得资源文件等。
5.7:ProcessInstance
代表流程定义的执行实例。如范冰冰请了一天的假,她就必须发出一个流程实例的申请。一个流程实例包括了所有的运行节点。我们可以利用这个对象来了解当前流程实例的进度等信息。流程实例就表示一个流程从开始到结束的最大的流程分支,即一个流程中流程实例只有一个。
5.8:Execution
Activiti用这个对象去描述流程执行的每一个节点。在没有并发的情况下,Execution就是同ProcessInstance。流程按照流程定义的规则执行一次的过程,就可以表示执行对象Execution。
如图为ProcessInstance的源代码:
从源代码中可以看出ProcessInstance就是Execution。但在现实意义上有所区别:
在单线流程中,如上图的贷款流程,ProcessInstance与Execution是一致的。
这个例子有一个特点:wire money(汇钱)和archive(存档)是并发执行的。 这个时候,总线路代表ProcessInstance,而分线路中每个活动代表Execution。
总结:
*** **一个流程中,执行对象可以存在多个,但是流程实例只能有一个。
*** **当流程按照规则只执行一次的时候,那么流程实例就是执行对象。
6:HelloWorld程序(模拟流程的执行)
6.1绘制流程图:
注意:绘制流程图之前,请仔细先检查自己的Ecplise中有没有勾选保存img图片选项,具体操作(参考课件上面步骤),切记!切记!切记!!
勾选上,当保存流程时,会自动生成png格式的流程图。
在项目中新建
创建任务节点
给任务节点分配待办人
流程Id
保存流程图
6.2:部署流程定义
发布流程
1 | // 使用流程引擎配置对象(交给spring:activiti.cfg.xml中创建了)创建 流程引擎对象 |
这里使用RepositoryService部署流程定义
addClasspathResource表示从类路径下加载资源文件,一次只能加载一个文件
观察打印结果:
思考:部署流程定义这一步,到底做了哪些事情?以及操作了数据库哪些表呢?
解析:
先获取流程引擎对象:在创建时会自动加载classpath下的activiti.cfg.xml
首先获得默认的流程引擎,通过流程引擎获取了一个RepositoryService对象(仓库对象)
由仓库的服务对象产生一个部署对象配置对象,用来封装部署操作的相关配置。
这是一个链式编程,在部署配置对象中设置显示名,上传流程定义规则文件
向数据库表中存放流程定义的规则信息。
这一步在数据库中将操作三张表:
1.act_re_procdef(流程定义表) :Process defintion
存放流程定义的属性信息,部署每个新的流程定义都会在这张表中增加一条记录。
注意:当流程定义的key相同的情况下,使用的是版本升级
2.act_re_deploymen(部署对象表)
存放流程定义的显示名和部署时间,每部署一次增加一条记录
3)act_ge_bytearray(资源文件表)
存储流程定义相关的部署信息。即流程定义文档的存放地。每部署一次就会增加两条记录,一条是关于bpmn规则文件的,一条是图片的(如果部署时只指定了bpmn一个文件,activiti会在部署时解析bpmn文件内容自动生成流程图)。两个文件不是很大,都是以二进制形式存储在数据库中。
小海豚软件中可看到BYTES_字段存储内容。
6.3:启动流程实例
1 |
|
这里使用RuntimeService启动流程实例
1 | SELECT * FROM act_hi_procinst; -- 流程实例历史表 |
思考:流程定义和流程是流程实例的关系是?
流程定义相当于 类(模板)
流程实例相当于 对象(具体的)
6.4:查看我的个人任务
获取当前代办人的任务列表
这里使用TaskService完成任务的查询
1 |
|
这里使用TaskService完成任务的查询
6.5:完成我的个人任务
这里使用TaskService完成任务的办理
1 |
|
注意:当所有的流程走完了后,那么在
act_ru_execution; – 流程实例的执行对象表
act_ru_task; – 正在运行任务(节点)
以上两种表中看不到任何信息了,都将成为历史数据,所以需要查看另外一张表!
- act-hi-taskinst 历史任务记录表!
7.流程定义详解
7.1.设计流程定义文档-画流程图
7.2.bpmn文件
BPMN 2.0根节点是definitions节点。 这个元素中,可以定义多个流程定义(不过我们建议每个文件只包含一个流程定义, 可以简化开发过程中的维护难度)。 一个空的流程定义看起来像下面这样。注意:definitions元素 最少也要包含xmlns 和 targetNamespace的声明。 targetNamespace可以是任意值,它用来对流程实例进行分类。
说明:流程定义文档有两部分组成:
- bpmn文件
流程规则文件。在部署后,每次系统启动时都会被解析,把内容封装成流程定义放入项目缓存中。Activiti框架结合这个xml文件自动管理流程,流程的执行就是按照bpmn文件定义的规则执行的,bpmn文件是给计算机执行用的。
- 展示流程图的图片
在系统里需要展示流程的进展图片,图片是给用户看的。
7.3.部署流程定义
在activiti中一共支持两种方式进行流程部署
(classpath路径加载文件)
(zip格式文件)
7.3.1.classpath方式加载
上面演示的就是用calsspath路径加载文件,就不过多赘述。
7.3.2.zip格式加载
将helloworld.bpmn + helloworld.png => helloworld.zip
压缩成zip格式的文件,使用zip的输入流用作部署流程定义
1 | // 部署流程定义 zip方式加载 |
7.4.查询流程定义
1 | // 获取所有的流程定义列表信息 |
查看流程定义列表,实际上操作的查看如下表
act_re_procdef