Activiti工作流详细讲解完整教程.doc

.
Activiti教程详解完整教程
1. Activiti介绍

Activiti是由Alfresco软件在2021年5月17日发布的业务流程管理(BPM)框架,它是覆盖了业务流程管理.工作流.效劳协作等领域的一个开源.灵活的.易扩展的可执行流程语言框架。
Activiti基于Apache许可的开源BPM平台.创始人Tom Baeyens是JBoss JBPM的工程架构师.它的特色是提供了eclipse插件.开发人员可以通过插件直接绘画出业务流程图。

1.1 工作流引擎
ProcessEngine对象.这是Activiti工作的核心。负责生成流程运行时的各种实例及数据.监控和管理流程的运行。

1.2 BPMN
业务流程建模与标注〔Business Process Model and Notation,BPMN〕.描述流程的根本符号.包括这些图元如何组合成一个业务流程图(Business Process Diagram)
2. 准备环境
2.1 Activiti软件环境
1)
2) 支持的数据库有:h2,mysql,oracle,mysql,db2等
3) 支持Activiti运行的jar包.可以通过maven依赖引入
4) .
2.2安装流程设计器(eclipse插件)
1〕翻开Help àInstall New Software àAdd
输入 Name: Activiti Designer

输入完成后.单击OK按钮等待下载完成后安装。
安装完成后在菜单项选择项中会出现Activiti的目录选项

2.3 设置eclipse activit插件的画流程图 选项
翻开菜单Windows --> Preferences --> Activiti -->Save 下流程图片的生成方式

勾选上Create process definition image when saving the diagram操作.勾选上这个操作后在画流程图后保存eclipse会自动生成对应的流程图片。
2.4 准备开发环境
2.4.1 创立maven web工程.在maven中添加Activiti依赖
在eclipse左边工作栏右键New选择创立Maven Project工程.创立一个名为ActivitiTest的工程

点击Finish完成。
右键工程选择Properties.选择Project Facets 勾选上图中的选项.点击Apply.再点击OK

然后将工程转换成web工程,右键工程选择Properties,在Project Facets中做如下勾选,然后点击Appy应用和OK确定

然后右键工程Properties .选择Deployment Assembly,将test相关目录Remove掉之保存main下面需要发布的内容.如下列图

然后点击Appply和OK

<dependencies>
<dependency>
<groupId>org.Activiti</groupId>
<artifactId>Activiti-engine</artifactId>
<version></version>
</dependency>
<dependency>
<groupId>org.Activiti</groupId>
<artifactId>Activiti-spring</artifactId>
<version></version>
</dependency>
<dependency>
<groupId></groupId>
<artifactId>groovy-all</artifactId>
<version></version>
</dependency>

<dependency>
<groupId></groupId>
<artifactId>slf4j-api</artifactId>
<version></version>
</dependency>
<dependency>
<groupId></groupId>
<artifactId>slf4j-jdk14</artifactId>
<version></version>
</dependency>

<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version></version>
<scope>test</scope>
</dependency>

<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version></version>
</dependency>
</dependencies>
然后在命令行下mvn compile 编译当前工程.将需要的包下载到本地仓库
2.4.2 初始化数据库
1〕src/main/resource目录下创立Activiti文件,内容如下

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

:// springframework.org/schema/aop :// springframework.org/schema/aop/spring-aop-3.0.xsd">

<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/test?useUnicode=true&amp;characterEncoding=utf8" />
<property name="jdbcUsername" value="root" />
<property name="jdbcPassword" value="root" />
<property name="databaseSchemaUpdate" value="true"/>
</bean>

</beans>

jdbcUrl为你电脑数据库的url
jdbcUsername为数据库用户名
jdbcPassword为数据库密码

2)在main/java目录下创立任意目录和类
编写创立Activiti数据表方法
public class CreateTable {

/****
* 创立流程表
* */
@Test
public void createTable() {
ProcessEngine processEngine = ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("Activiti.cfg.xml")
.buildProcessEngine();

System.out.println("------processEngine:" + processEngine);
}
}

然后运行该测试方法.如果运行成功.在数据库中应该会产生25张Activiti的相关数据表

2.4.3 Activiti表说明
下面是概括了几个常用的数据表

流程部署相关表
act_re_deployement 部署对象表
act_rep_procdef 流程定义表
act_ge_bytearray 资源文件表
act_ge_prperty 主键生成策略表〔对于部署对象表的主键ID〕

流程实例相关表
act_ru_execution 正在执行的执行对象表〔包含执行对象ID和流程实例ID.如果有多个线程可能流程实例ID不一样〕
act_hi_procinst 流程实例历史表
act_hi_actinst 存放历史所有完成的任务

Task 任务相关表
act_ru_task 代办任务表 〔只对应节点是UserTask的〕
act_hi_taskinst 代办任务历史表 〔只对应节点是UserTask的〕

act_hi_actinst 所有节点活动历史表 〔对应流程的所有节点的活动历史.从开始节点一直到结束节点中间的所有节点的活动都会被记录〕

流程变量表
act_ru_variable 正在执行的流程变量表
act_hi_variable 流程变量历史表

3.1 ProcessEngine
说明:
1) 在Activiti中最核心的类.其他的类都是由他而来。
2) 产生方式
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

3〕可以产生RepositoryService
RepositoryService repositoryService =processEngine.getRepositoryService();

4) 可以产生 RuntimeService
RuntimeService runtimeService = processEngine.getRuntimeService();

5) 可以产生TaskService
TaskService taskService =processEngine.getTaskService();

各个Service的作用
RepositoryService
管理流程定义
RuntimeService
执行管理.包括启动.推进.删除流程实例等操作
TaskService
任务管理

3.2 RepositoryService
Activiti的仓库效劳类。所谓的仓库指流程定义文档的两个文件：bpmn文件和流程图片
该service可以用来删除部署的流程定义。
3.3 RuntimeService
是Activiti的流程执行效劳类.可以从这个效劳类中获取很多关于流程执行的相关的信息。
3.4 TaskService
是Activiti的任务效劳类。可以从这个类中获取任务的相关信息.如当前正在执行的个人待办和用户组待办任务。
3.5 HistoryService
是Activiti的查询历史信息的类.在一个流程执行完成后.这个对象为我们提供查询历史信息.可以跟踪流程实例对应所有待办节点的运行情况。
3.6 ProcessDefinition
流程定义类.可以从这里获得资源文件等。
3.7 ProcessInstance
代表流程定义的执行实例.当一个部署的流程图启动后.该流程只有一条流程实例数据.但是它的流程任务可以有多个.每个任务对应流程图中相应的流程节点。

创立流程图方法
点击ActivitiTest工程.在src/main/java目录下创立一个diagrams目录用来存放流程图
在当前工程右键选择Activiti Diagram流程图输入流程图名称HelloWorld.然后点击OK.

在控制面板的右边栏有相关的画图图标操作

其中一个流程必须包含一个开始节点和一个结束节点.结束节点可以有多个。
然后使用StartEvent, UserTask,EndEvent画出下面的流程图.然后用Connection中的SequenceFlow连线连接起来。

.如下列图

4.3 指定流程图名称.ID和UserTask的处理人
1〕选中第一个节点.在 General中的name属性中输入当前节点的名称,在Main config中的Assignee中输入该节点的处理人.然后以此类推将3个节点的值设置完成。

.

2〕然后在流程图旁边的空白出点击一下.输入流程的ID和Name值.然后保存

4.4 将流程图部署到Activiti的数据表中

启动完成后在act_re_deployment流程部署表和act_re_procdef流程定义表中会有对应的数据信息.
4.5 启动流程实例
其中runtimeService.startProcessInstanceByKey("HelloWorldKey");中的HelloWorldKey对应流程图中的ID值,在数据表中对应act_re_procdef流程定义表中的key字段

启动完流程后在act_ru_execution表中会产生一条数据.这条数据为当前流程正在执行的任务.其中act_id_字段的值对应流程图节点的ID值

在act_ru_task表中会产生一条任务数据,execution_id_对应act_ru_execution主键.proc_inst_id_为流程实例ID.name_值为流程节点名称.assignee_字段为该待办当前的处理人

4.6 查询待办任务

指定查询张三的待办.可以查询出待办为第一个节点的处理任务。

4.7 完成待办任务

其中taskId对应act_ru_task表的主键ID.因为当前待办任务为第一个节点提交申请.当执行完这个待办后下一条待办数据将会流转到审批【部门经理】那.然后以此类推可以将部门经理和总经理的待办任务全部查询和执行完成。

1〕查询流程定义

2) 删除流程定义

6.1 设置流程变量
1〕设置流程变量有多种方式.可以在流程启动.和任务执行的时候设置

b. 通过taskService或者runtimeService设置

提示：如果设置的流程变量值是一个对象类型.这个对象必须实现序列化Serializable操作,并且要为该对象类指定一个 版本ID

6.2 获取流程变量

见工程操作

在画流程图的时候可以对流程的连线设置表达式.然后在执行的时候设置流程变量值.然后Activiti会根据对应的值走对应的节点

点击一条连线.在Main config中的Condition属性值中设置${message=='同意'}.另外一条线设置为${message=='不同意'}.然后在代码中设置对应流程变量值。

见工程操作

如下列图,其中黑色的叉叉对应eclipse画流程图图标中的ExclusiveGateWay图标

然后对每条线的Condition属性指定对应的表达式.然后在执行任务时候设置对应的流程变量

Activiti会根据变量的值来判断对应连线中的表达式走对应的流程节点路线。

见工程操作

十字图标对应图标中的ParallelGateway

并行网关不需要指定连线的表达式.当流程流转到并行任务时会出发多个任务.当多个任务完成后在会将流程流转到下一个节点

见工程操作

10.1 在Assignee中指定任务具体的处理人

10.2 在Assignee中指定任务的处理人或角色变量

当指定Assignee为一个变量值后需要在代码中设置对应的处理人.比方在启动的时候设置userId的值

在工程中可以将起草人的处理变量设置为userId.审批人的处理变量设置为appUserId.然后通过业务模块和登录人来获取对应模块的审批人。

10.3 为任务节点设置一个监听类来设置当前节点的处理人
如果设置了监听类就不需要在设置Assignee的值
1〕创立一个监听器类.需要实现TaskListener接口

2) 点击任务节点.选择Listener选项卡.点击New .将Event的值改为create
然后选择创立的TaskListenerImpl实现类

然后当任务到达该节点后Activiti会触发监听实现类的notify方法

11.1 在任务节点中设置Candidate user 候选人

设置的候选处理人用英文输入法的逗号隔开.当任务到达该节点后.设置的候选人其中任何一个人都可以处理当前待办.处理完成后待办结束。

11.2 在Candidate user中设置一个变量作为处理人

然后通过启动或者执行流程向下传递的时候设置该流程变量值

11.3 通过监听类来设置待办处理人
如果设置了监听类就不需要在设置Assignee的值

和个人任务的监听类一样实现TaskListener接口.然后设置CandidateUser的值

实用文档.