2022年Activiti入门教程 .pdf

《2022年Activiti入门教程 .pdf》由会员分享，可在线阅读，更多相关《2022年Activiti入门教程 .pdf（16页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、Activiti 入门使用名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 1 页，共 16 页 - - - - - - - - - 1. 初识 Activiti 1.1. 工作流与工作流引擎工作流 （workflow ）就是工作流程的计算模型，即将工作流程中的工作如何前后组织在一起的逻辑和规则在计算机中以恰当的模型进行表示并对其实施计算。它主要解决的是“ 使在多个参与者之间按照某种预定义的规则传递文档、信息或任务的过程自动进行，从而实现某个预期的业务目标，或者促使此目标的实现” 。

2、（我的理解就是：将部分或者全部的工作流程、逻辑让计算机帮你来处理，实现自动化）所谓工作流引擎是指workflow作为应用系统的一部分，并为之提供对各应用系统有决定作用的根据角色、分工和条件的不同决定信息传递路由、内容等级等核心解决方案。例如开发一个系统最关键的部分不是系统的界面，也不是和数据库之间的信息交换，而是如何根据业务逻辑开发出符合实际需要的程序逻辑并确保其稳定性、易维护性和弹性。比如你的系统中有一个任务流程，一般情况下这个任务的代码逻辑、流程你都要自己来编写。 实现它是没有问题的。 但是谁能保证逻辑编写的毫无纰漏？经过无数次的测试与改进，这个流程没有任何漏洞也是可以实现的，但是明显就会

3、拖慢整个项目的进度。工作流引擎解决的就是这个问题：如果应用程序缺乏强大的逻辑层，势必变得容易出错（信息的路由错误、死循环等等）。1.2. BPMN2.0 规范BPMN （Business Process Model and Notation）-业务流程模型与符号。BPMN是一套流程建模的标准，主要目标是被所有业务用户容易理解的符号，支持从创建流程轮廓的业务分析到这些流程的最终实现，知道最终用户的管理监控。通俗一点其实就是一套规范，画流程模型的规范。流程模型包括：流程图、协作图、编排图、会话图。详细信息请google。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - -

4、- - - - - - - - - 名师精心整理 - - - - - - - 第 2 页，共 16 页 - - - - - - - - - 1.3. Activiti概述1.3.1. Activiti 由来学习过 Activiti的朋友都知道，Activiti的创始人也就是JBPM（也是一个优秀的BPM引擎）的创始人，从Jboss离职后开发了一个新的BPM 引擎： Activiti 。所以， Activiti 有很多地方都有JBPM 的影子。所以，据说学习过JBPM 的朋友学起Activiti来非常顺手。由于本人之前没有工作流及JBPM 的相关基础，刚开始学习Activiti 的时候可以说是无

5、比痛苦的，根本不知道从何下手，这里也建议大家先进行工作流及BPMN2.0 规范的学习，有了一定的基础后，再着手学习Activiti 。1.3.2. Activiti 简介Activiti是一个开源的工作流引擎，它实现了BPMN 2.0 规范，可以发布设计好的流程定义，并通过api 进行流程调度。Activiti 作为一个遵从Apache 许可的工作流和业务流程管理开源平台，其核心是基于Java 的超快速、超稳定的BPMN 2.0 流程引擎，强调流程服务的可嵌入性和可扩展性，同时更加 强调面向业务人员。Activiti 流程引擎重点关注在系统开发的易用性和轻量性上。每一项BPM 业务功能Acti

6、viti 流程引擎都以服务的形式提供给开发人员。通过使用这些服务，开发人员能够构建出功能丰富、轻便且高效的BPM 应用程序。1.4. 文档说明以上部分对工作流、BPMN 、Activiti的概念做了一个简单的介绍，目的是了解Activiti究竟是什么，能做些什么及在学习Activiti 之前需要了解的知识与技术。其中大部分文字来自 Copy 网上的各种资料与文档，通过总结而来的。具体的更详细的内容需自己google，参考一些官方的文档与手册。本文档之后内容如下：1)下载与使用2)核心组件与说明名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - -

7、- - - 名师精心整理 - - - - - - - 第 3 页，共 16 页 - - - - - - - - - 3)入门示例4)Eclipse 中的 Activiti插件的使用本文档旨在为初学Activiti的朋友提供 入门级别 的参考，不会对其原理及其结构进行深层次的探究（更多是因为目前自身理解还不是很透彻），只是为大家理清思路，方便以后更深层次的学习。 本文档还有一个重要的特点，那就是根据自己看官方手册的经验，教大家如何看手册从而更有效率！由于是初学， 很多术语或解释难免理解有偏差，所以一定要看官方提供的文档与手册，那才是学习的最佳途径！2. 开始学习2.1. 必要的准备2.1.1.

8、下载与了解目录下载Activiti ：下载路径，也就是官方网站的地址：http:/activiti.org/download.html。下载后解压（我所使用的是5.12 版本的， Activiti 更新速度飞快，几乎每两个月就会有一个更新的小版本） ，看到如下目录：1)database ：里面存放的是Activiti 使用到的数据库信息的sql 文件，它支持的数据库类型如下图，使用时只需执行你自己的数据库类型的文件即可。如：你的数据库是mysql，那么就执行activiti.mysql.create.*.sql即可。2)docs：毫无疑问，api 文档是也。3)libs：使用 Activiti

9、所需要的所有的jar 包和源文件。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 4 页，共 16 页 - - - - - - - - - 4)wars：官方给我们提供的示例Demo，通过使用Demo 可以更加快速的了解Activiti 。2.1.2. 其他准备使用 Activiti ，首先当然要有jdk 了！ 6+版本就可以了。其次，要有一款IDE，我们当然会使用Eclipse，这里使用Juno 版本。然后， web 容器当然也要有，这里使用Tomcat6.0版本。然后就是Acti

10、viti 的 Eclipse 插件了，这个后面再介绍。2.1.3. 一分钟入门（见用户手册）所谓的一分钟入门就是通过运行你下载的包里的wars 文件夹里的activiti-explorer.war文件，以便更快的了解Activiti 。将文件拷贝至Tomcat 的 webapps目录，启动tomcat，输入http:/localhost:8080/activiti-explorer。然后你就可以开整了！总算是有一点微小的进展了。这里需要说明的就是，这个Demo 默认采用的是h2 内存数据库，如果想用你自己的数据库，就需要修改web 应用 WEB-INF/classes 目录下的db.prope

11、rties。然后，按上面说的，把database 里的create 文件夹里的数据库文件导入你自己的数据库（如果没有修改db.properties，就不用导入了） 。Demo 的具体解释与数据库配置的具体信息详见官方手册，手册已经说的很清楚了。这里需要重点了解activiti.cfg.xml的配置以及如何构建ProcessEngine （配置文件构建方式、代码构建方式） 。对 Demo 的使用介绍在官方文档的后面才开始介绍，这里建议应用跑起来之后，先自己试试手（可看后面介绍Demo 如何使用的章节） ，看看如何跑一个流程、整个流程是怎么流的、并随时关注数据库表里的数据的变化等，对以后的学习很有

12、帮助！2.2. 核心组件介绍2.2.1. 关键对象1.Deployment：流程部署对象，部署一个流程时创建。2.ProcessDefinitions：流程定义，部署成功后自动创建。3.ProcessInstances ：流程实例，启动流程时创建。4.Task：任务，在Activiti中的 Task 仅指有角色参与的任务，即定义中的UserTask。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 5 页，共 16 页 - - - - - - - - - 5.Execution：执行计

13、划，流程实例和流程执行中的所有节点都是Execution，如 UserTask、ServiceTask 等。2.2.2. 服务接口1.ProcessEngine：流程引擎的抽象，通过它我们可以获得我们需要的一切服务。2.RepositoryService：Activiti中每一个不同版本的业务流程的定义都需要使用一些定义文件，部署文件和支持数据(例如 BPMN2.0 XML 文件，表单定义文件，流程定义图像文件等 )，这些文件都存储在Activiti内建的Repository 中。 RepositoryService 提供了对repository 的存取服务。3.RuntimeService：

14、在 Activiti中，每当一个流程定义被启动一次之后，都会生成一个相应的流程对象实例。RuntimeService 提供了启动流程、查询流程实例、设置获取流程实例变量等功能。此外它还提供了对流程部署，流程定义和流程实例的存取服务。4.TaskService: 在 Activiti中业务流程定义中的每一个执行节点被称为一个Task，对流程中的数据存取，状态变更等操作均需要在Task 中完成。 TaskService 提供了对用户Task 和 Form 相关的操作。它提供了运行时任务查询、领取、完成、删除以及变量设置等功能。5.IdentityService: Activiti中内置了用户以及组

15、管理的功能，必须使用这些用户和组的信息才能获取到相应的Task。IdentityService 提供了对Activiti 系统中的用户和组的管理功能。6.ManagementService: ManagementService 提供了对Activiti流程引擎的管理和维护功能，这些功能不在工作流驱动的应用程序中使用，主要用于Activiti系统的日常维护。7.HistoryService: HistoryService用于获取正在运行或已经完成的流程实例的信息，与RuntimeService 中获取的流程信息不同，历史信息包含已经持久化存储的永久信息，并已经被针对查询优化。现在至少要知道有这些

16、对象和接口。并结合Activiti Api这一章节来看，你就会对部署流程、启动流程、 执行任务等操作有一个基本的概念。之后编写一个简单的单元测试，主要为了测试 activiti.cfg.xml配置的是否正确，流程是否可以被部署即可。至 于 与Spring的 集 成 ， 一 定 要 熟 悉 基 于 Spring配 置Activiti ， 以 及事 务 的 处 理 。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 6 页，共 16 页 - - - - - - - - - 3. 入门示例（

17、参考手册中10 分钟教程）3.1. 概述下面开始编写一个示例。这个Demo 为一个“月度报表申请”流程。由“sales(销售 )”组的用户制作月度报表，提交给“management(经理 )”组的用户，经理审批该报表，最后结束。流程图如下：这个 Demo 完成之后， 我们会进行两个测试。一个是代码中的单元测试，就是跑一遍流程，看一下流程在跑的过程中输出的信息；一个是我们将编辑好的bpmn20.xml 文件通过我们之前一分钟入门的示例activiti-explorer应用导入进去， 查看它的流程图，并完整执行一遍流程。在编写这个Demo 之前，至少要了解Activiti 与 Spring 如何集

18、成、 XxxService 各自的任务与作用，并完成上一章的Demo。3.2. 流程文件xxx.bpmn20.xml 首先，我们就来编写这个流程的bpmn20.xml 文件。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 7 页，共 16 页 - - - - - - - - - Write monthly financial report for publication to shareholders. sales Verify monthly financial report co

19、mposed by the accountancy department. This financial report is going to be sent to all the company shareholders. management 这里对部分代码进行解释。1)文件的开头部分，这里的id 对于 Activiti来说，应该叫做key。创建流程实例时，会根据此 id 来得到这个流程。2)开始流程。3)顺序流（就是连接各个节点的指向线）名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - -

20、- 第 8 页，共 16 页 - - - - - - - - - sourceRef 和 targetRef 分别为起始节点和目标节点。4)描述用户任务id 为该用户任务的标识。documentation 为该用户任务的描述。5)分配用户可以把任务分配给指定的用户，也可以分配给指定的组，并且可以有多个，详见用户手册。3.3. Spring 配置文件这里配置了数据源、事务管理、流程引擎及几个必要的xxxService 。这里数据源使用的是dbcp。数据库信息就配置成你自己本地数据库的信息，如果不会配置。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - -

21、- - - - - 名师精心整理 - - - - - - - 第 9 页，共 16 页 - - - - - - - - - 注： bpmn20.xml 文件中用到了两个用户组（sales 、management） ，是因为我们启动Tomcat运行 activiti-explorer应用初始化时自动就会往数据库里添加一些数据，其中用户组的表中就会添加几条记录， 其中就包括这两个组，所以不用管它怎么来的，总之数据库里有这两个组就对了。 而应用默认使用的是内存数据库，服务一停止数据也就没有了。所以为了进行单元测试，需要按前面讲的修改数据库配置的方法：名师资料总结 - - -精品资料欢迎下载 - -

22、- - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 10 页，共 16 页 - - - - - - - - - 把 activiti-explorer应用的数据库配置改成你自己的本地数据库的信息，我使用的是Mysql数据库。再启动tomcat 运行应用（目的就是为了让数据库有数据），这时你的本地数据库就有数据了，可以编写测试用例进行单元测试了。3.4. 编写测试用例1)读取 Spring 配置文件，注入流程所需的Service 2)编写测试方法Testpublicvoid monthtest() / 部署流程定义repositorySe

23、rvice.createDeployment().addClasspathResource(myProcess.bpmn20.xml).deploy(); / 启动流程实例 String procId = runtimeService.startProcessInstanceByKey(financialReport).getId(); / 获得第一个任务 List tasks = taskService.createTaskQuery().taskCandidateGroup(sales).list(); for (Task task : tasks) System.out .println

24、(Following task is available for sales group: + task.getName(); / 认领任务这里由 foozie认领，因为 fozzie是sales 组的成员taskService.claim(task.getId(), fozzie); / 查看 fozzie现在是否能够获取到该任务 tasks = taskService.createTaskQuery().taskAssignee(fozzie).list(); for (Task task : tasks) 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - -

25、- - - - - - - - 名师精心整理 - - - - - - - 第 11 页，共 16 页 - - - - - - - - - System.out .println(Task for fozzie: + task.getName(); / 执行 ( 完成 ) 任务taskSplete(task.getId(); / 现在 fozzie的可执行任务数就为0了 System.out .println(Number of tasks for fozzie: + taskService.createTaskQuery().taskAssignee(fozzie).count(); / 获得

26、第二个任务 tasks = taskService.createTaskQuery().taskCandidateGroup(management).list(); for (Task task : tasks) System.out .println(Following task is available for accountancy group: + task.getName(); / 认领任务这里由 kermit认领，因为 kermit是management 组的成员taskService.claim(task.getId(), kermit); / 完成第二个任务结束流程for (T

27、ask task : tasks) taskSplete(task.getId(); / 核实流程是否结束, 输出流程结束时间 HistoricProcessInstance historicProcessInstance = historyService.createHistoricProcessInstanceQuery() .processInstanceId(procId).singleResult(); System.out .println(Process instance end time: + historicProcessInstance.getEndTime(); 3)运行

28、示例， Demo 完成。这就是一个最简单的流程，通过这个流程，了解到Activiti中流程是怎么流的，我们怎么控制它。3.5. 导入 activiti-explorer 1)单元测试完成后，我们可以将该bpmn20.xml 文件导入之前我们部署的activiti-explorer应用中：点击流程的流程设计工作区，点击导入，将刚才我们编写的文件导入进去。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 12 页，共 16 页 - - - - - - - - - 2)导入之后在右上角点击部

29、署。3)在已部署流程定义中我们可以看到这个流程，及它的流程图。4)点击启动流程， 该流程就会被启动，再点击任务中，列队就会有该任务了，而且是分配给 sales的，这正是我们定义流程时所分配给的用户组啊。注意，现在只有sales组的用户才可以看到此任务！5)sales组的用户进入之后点击“签收”，该任务就分配给该用户了，然后该用户就可以进行处理，也就是在代办任务和受邀里。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 13 页，共 16 页 - - - - - - - - - 6)进去

30、之后点击完成任务，该任务就流到下一个节点，也就是流转到management组中去了，要由 management 组的用户去处理。7)于是这时候，队列中management 组就有一个新的任务了，等待management 组的成员来“签收”，并完成任务。该流程也就结束了。8)此时就可以查看历史任务了，就是我们这里的“已归档”。用户完成的任务会在这里显示。这就是整个Demo 的编写、测试过程。这样一个小小的流程基本能够体现出Activiti的功能及使用方法。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - -

31、 - - - 第 14 页，共 16 页 - - - - - - - - - 4. Eclipse中的 Activiti 插件Activiti 有一个 Eclipse 插件， Activiti Eclipse Designer ，可用于图形化建模、测试、部署BPMN 2.0 的流程。这样就不用我们自己去编写繁琐的流程文件了。具体安装方法见手册。4.1. 安装打开 Help - Install New Software .在如下面板中, 点击 Add 按钮 , 然后填入下列字段: Name: Activiti BPMN 2.0 designer Location: http:/activiti.

32、org/designer/update/然后一步步的安装就可以了。4.2. 使用至于如何使用，文档中介绍的非常详细，这里基于我初次使用的经验，强调几点：1)安装之后将 “保存 bpmn 文件时创建图片文件”勾选上。 这样你每次保存bpmn 文件时，会为你自动创建图片文件。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 15 页，共 16 页 - - - - - - - - - 2)节点的所有属性可在properties 控制台中设置。3)在使用设计器之前，先去钻研BPNM2.0 规范吧， 了解 BPNM 结构（可参看用户手册） ，才能画出符合逻辑且完美的流程图。该例为使用Activiti Eclipse Designer设计的“请假”流程图。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 16 页，共 16 页 - - - - - - - - -