工作流引擎 Activiti 保姆级教程
大家好，我是老趙！
一、工作流介紹
1.1 概念
工作流(Workflow)，就是通過計(jì)算機(jī)對業(yè)務(wù)流程自動化執(zhí)行管理。它主要解決的是“使在多個(gè)參與者之間按照某種預(yù)定義的規(guī)則自動進(jìn)行傳遞文檔、信息或任務(wù)的過程，從而實(shí)現(xiàn)某個(gè)預(yù)期的業(yè)務(wù)目標(biāo)，或者促使此目標(biāo)的實(shí)現(xiàn)”。
1.2 工作流系統(tǒng)
一個(gè)軟件系統(tǒng)中具有工作流的功能，我們把它稱為工作流系統(tǒng)，一個(gè)系統(tǒng)中工作流的功能是什么？就是對系統(tǒng)的業(yè)務(wù)流程進(jìn)行自動化管理，所以工作流是建立在業(yè)務(wù)流程的基礎(chǔ)上，所以一個(gè)軟件的系統(tǒng)核心根本上還是系統(tǒng)的業(yè)務(wù)流程，工作流只是協(xié)助進(jìn)行業(yè)務(wù)流程管理。即使沒有工作流業(yè)務(wù)系統(tǒng)也可以開發(fā)運(yùn)行，只不過有了工作流可以更好的管理業(yè)務(wù)流程，提高系統(tǒng)的可擴(kuò)展性。
1.3 適用行業(yè)
消費(fèi)品行業(yè)，制造業(yè)，電信服務(wù)業(yè)，銀證險(xiǎn)等金融服務(wù)業(yè)，物流服務(wù)業(yè)，物業(yè)服務(wù)業(yè)，物業(yè)管理，大中型進(jìn)出口貿(mào)易公司，政府事業(yè)機(jī)構(gòu)，研究院所及教育服務(wù)業(yè)等，特別是大的跨國企業(yè)和集團(tuán)公司。
1.4 具體應(yīng)用
1、關(guān)鍵業(yè)務(wù)流程： 訂單、報(bào)價(jià)處理、合同審核、客戶電話處理、供應(yīng)鏈管理等
2、行政管理類： 出差申請、加班申請、請假申請、用車申請、各種辦公用品申請、購買申請、日報(bào)周報(bào)等凡是原來手工流轉(zhuǎn)處理的行政表單。
3、人事管理類： 員工培訓(xùn)安排、績效考評、職位變動處理、員工檔案信息管理等。
4、財(cái)務(wù)相關(guān)類： 付款請求、應(yīng)收款處理、日常報(bào)銷處理、出差報(bào)銷、預(yù)算和計(jì)劃申請等。
5、客戶服務(wù)類： 客戶信息管理、客戶投訴、請求處理、售后服務(wù)管理等。
6、特殊服務(wù)類： ISO系列對應(yīng)流程、質(zhì)量管理對應(yīng)流程、產(chǎn)品數(shù)據(jù)信息管理、貿(mào)易公司報(bào)關(guān)處理、物流公司貨物跟蹤處理等各種通過表單逐步手工流轉(zhuǎn)完成的任務(wù)均可應(yīng)用工作流軟件自動規(guī)范地實(shí)施。
1.5 實(shí)現(xiàn)方式
在沒有專門的工作流引擎之前，我們之前為了實(shí)現(xiàn)流程控制，通常的做法就是采用狀態(tài)字段的值來跟蹤流程的變化情況。這樣不同角色的用戶，通過狀態(tài)字段的取值來決定記錄是否顯示。
針對有權(quán)限可以查看的記錄，當(dāng)前用戶根據(jù)自己的角色來決定審批是否合格的操作。如果合格將狀態(tài)字段設(shè)置一個(gè)值，來代表合格；當(dāng)然如果不合格也需要設(shè)置一個(gè)值來代表不合格的情況。
這是一種最為原始的方式。通過狀態(tài)字段雖然做到了流程控制，但是當(dāng)我們的流程發(fā)生變更的時(shí)候，這種方式所編寫的代碼也要進(jìn)行調(diào)整。
那么有沒有專業(yè)的方式來實(shí)現(xiàn)工作流的管理呢？并且可以做到業(yè)務(wù)流程變化之后，我們的程序可以不用改變，如果可以實(shí)現(xiàn)這樣的效果，那么我們的業(yè)務(wù)系統(tǒng)的適應(yīng)能力就得到了極大提升。
二、Activiti7概述
2.1 介紹
Alfresco軟件在2010年5月17日宣布Activiti業(yè)務(wù)流程管理（BPM）開源項(xiàng)目的正式啟動，其首席架構(gòu)師由業(yè)務(wù)流程管理BPM的專家 Tom Baeyens擔(dān)任，Tom Baeyens就是原來jbpm的架構(gòu)師，而jbpm是一個(gè)非常有名的工作流引擎，當(dāng)然activiti也是一個(gè)工作流引擎。
Activiti是一個(gè)工作流引擎， activiti可以將業(yè)務(wù)系統(tǒng)中復(fù)雜的業(yè)務(wù)流程抽取出來，使用專門的建模語言BPMN2.0進(jìn)行定義，業(yè)務(wù)流程按照預(yù)先定義的流程進(jìn)行執(zhí)行，實(shí)現(xiàn)了系統(tǒng)的流程由activiti進(jìn)行管理，減少業(yè)務(wù)系統(tǒng)由于流程變更進(jìn)行系統(tǒng)升級改造的工作量，從而提高系統(tǒng)的健壯性，同時(shí)也減少了系統(tǒng)開發(fā)維護(hù)成本。
官方網(wǎng)站：https://www.activiti.org/
經(jīng)歷的版本:
目前最新版本：Activiti7.0.0.Beta
2.1.1 BPM
BPM（Business Process Management），即業(yè)務(wù)流程管理，是一種規(guī)范化的構(gòu)造端到端的業(yè)務(wù)流程，以持續(xù)的提高組織業(yè)務(wù)效率。常見商業(yè)管理教育如EMBA、MBA等均將BPM包含在內(nèi)。
2.1.2 BPM軟件
BPM軟件就是根據(jù)企業(yè)中業(yè)務(wù)環(huán)境的變化，推進(jìn)人與人之間、人與系統(tǒng)之間以及系統(tǒng)與系統(tǒng)之間的整合及調(diào)整的經(jīng)營方法與解決方案的IT工具。
通過BPM軟件對企業(yè)內(nèi)部及外部的業(yè)務(wù)流程的整個(gè)生命周期進(jìn)行建模、自動化、管理監(jiān)控和優(yōu)化，使企業(yè)成本降低，利潤得以大幅提升。
BPM軟件在企業(yè)中應(yīng)用領(lǐng)域廣泛，凡是有業(yè)務(wù)流程的地方都可以BPM軟件進(jìn)行管理，比如企業(yè)人事辦公管理、采購流程管理、公文審批流程管理、財(cái)務(wù)管理等。
2.1.3 BPMN
BPMN（Business Process Model AndNotation）- 業(yè)務(wù)流程模型和符號 是由BPMI（BusinessProcess Management Initiative）開發(fā)的一套標(biāo)準(zhǔn)的業(yè)務(wù)流程建模符號，使用BPMN提供的符號可以創(chuàng)建業(yè)務(wù)流程。
2004年5月發(fā)布了BPMN1.0規(guī)范.BPMI于2005年9月并入OMG（The Object Management Group對象管理組織)組織。OMG于2011年1月發(fā)布BPMN2.0的最終版本。
具體發(fā)展歷史如下:
BPMN 是目前被各 BPM 廠商廣泛接受的 BPM 標(biāo)準(zhǔn)。Activiti 就是使用 BPMN 2.0 進(jìn)行流程建模、流程執(zhí)行管理，它包括很多的建模符號，比如：Event
用一個(gè)圓圈表示，它是流程中運(yùn)行過程中發(fā)生的事情。
活動用圓角矩形表示，一個(gè)流程由一個(gè)活動或多個(gè)活動組成
Bpmn圖形其實(shí)是通過xml表示業(yè)務(wù)流程，上邊的.bpmn文件使用文本編輯器打開：
2.2 使用步驟
部署activiti
Activiti是一個(gè)工作流引擎（其實(shí)就是一堆jar包API），業(yè)務(wù)系統(tǒng)訪問(操作)activiti的接口，就可以方便的操作流程相關(guān)數(shù)據(jù)，這樣就可以把工作流環(huán)境與業(yè)務(wù)系統(tǒng)的環(huán)境集成在一起。
流程定義
使用activiti流程建模工具(activity-designer)定義業(yè)務(wù)流程(.bpmn文件) 。
.bpmn文件就是業(yè)務(wù)流程定義文件，通過xml定義業(yè)務(wù)流程。
流程定義部署
activiti部署業(yè)務(wù)流程定義（.bpmn文件）。
使用activiti提供的api把流程定義內(nèi)容存儲起來，在Activiti執(zhí)行過程中可以查詢定義的內(nèi)容
Activiti執(zhí)行把流程定義內(nèi)容存儲在數(shù)據(jù)庫中
啟動一個(gè)流程實(shí)例
流程實(shí)例也叫：ProcessInstance
啟動一個(gè)流程實(shí)例表示開始一次業(yè)務(wù)流程的運(yùn)行。
在員工請假流程定義部署完成后，如果張三要請假就可以啟動一個(gè)流程實(shí)例，如果李四要請假也啟動一個(gè)流程實(shí)例，兩個(gè)流程的執(zhí)行互相不影響。
用戶查詢待辦任務(wù)(Task)
因?yàn)楝F(xiàn)在系統(tǒng)的業(yè)務(wù)流程已經(jīng)交給activiti管理，通過activiti就可以查詢當(dāng)前流程執(zhí)行到哪了，當(dāng)前用戶需要辦理什么任務(wù)了，這些activiti幫我們管理了，而不需要開發(fā)人員自己編寫在sql語句查詢。
用戶辦理任務(wù)
用戶查詢待辦任務(wù)后，就可以辦理某個(gè)任務(wù)，如果這個(gè)任務(wù)辦理完成還需要其它用戶辦理，比如采購單創(chuàng)建后由部門經(jīng)理審核，這個(gè)過程也是由activiti幫我們完成了。
流程結(jié)束
當(dāng)任務(wù)辦理完成沒有下一個(gè)任務(wù)結(jié)點(diǎn)了，這個(gè)流程實(shí)例就完成了。
三、Activiti環(huán)境
3.1 開發(fā)環(huán)境
Jdk1.8或以上版本
Mysql 5及以上的版本
Tomcat8.5
IDEA
注意：activiti的流程定義工具插件可以安裝在IDEA下，也可以安裝在Eclipse工具下
3.2 Activiti環(huán)境
我們使用：Activiti7.0.0.Beta1 默認(rèn)支持spring5
3.2.1 下載activiti7
Activiti下載地址：http://activiti.org/download.html ，Maven的依賴如下：
<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運(yùn)行需要有數(shù)據(jù)庫的支持，支持的數(shù)據(jù)庫有：h2, mysql, oracle, postgres, mssql, db2。
3.2.2 流程設(shè)計(jì)器IDEA下安裝
在IDEA的File菜單中找到子菜單”Settings”,后面我們再選擇左側(cè)的“plugins”菜單，如下圖所示：
此時(shí)我們就可以搜索到actiBPM插件，它就是Activiti Designer的IDEA版本，我們點(diǎn)擊Install安裝。
安裝好后，頁面如下：
提示需要重啟idea，點(diǎn)擊重啟。
重啟完成后，再次打開Settings 下的 Plugins（插件列表），點(diǎn)擊右側(cè)的Installed（已安裝的插件），在列表中看到actiBPM，就說明已經(jīng)安裝成功了，如下圖所示：
后面的課程里，我們會使用這個(gè)流程設(shè)計(jì)器進(jìn)行Activiti的流程設(shè)計(jì)。
3.3 Activiti的數(shù)據(jù)庫支持
Activiti 在運(yùn)行時(shí)需要數(shù)據(jù)庫的支持，使用25張表，把流程定義節(jié)點(diǎn)內(nèi)容讀取到數(shù)據(jù)庫表中，以供后續(xù)使用。
3.3.1 Activiti 支持的數(shù)據(jù)庫
activiti 支持的數(shù)據(jù)庫和版本如下：
3.3.2 在MySQL生成表
3.3.2.1 創(chuàng)建數(shù)據(jù)庫
創(chuàng)建 mysql 數(shù)據(jù)庫 activiti （名字任意）：
CREATE?DATABASE?activiti?DEFAULT?CHARACTER?SET?utf8;3.3.2.2 使用java代碼生成表
創(chuàng)建 java 工程
使用idea 創(chuàng)建 java 的maven工程，取名：activiti01。
加入 maven 依賴的坐標(biāo)（jar 包）
首先需要在 java 工程中加入 ProcessEngine 所需要的 jar 包，包括：
activiti-engine-7.0.0.beta1.jar
activiti 依賴的 jar 包：mybatis、 alf4j、 log4j 等
activiti 依賴的 spring 包
mysql數(shù)據(jù)庫驅(qū)動
第三方數(shù)據(jù)連接池 dbcp
單元測試 Junit-4.12.jar
我們使用 maven 來實(shí)現(xiàn)項(xiàng)目的構(gòu)建，所以應(yīng)當(dāng)導(dǎo)入這些 jar 所對應(yīng)的坐標(biāo)到 pom.xml 文件中。
完整的依賴內(nèi)容如下：
<properties><slf4j.version>1.6.6</slf4j.version><log4j.version>1.2.12</log4j.version><activiti.version>7.0.0.Beta1</activiti.version> </properties> <dependencies><dependency><groupId>org.activiti</groupId><artifactId>activiti-engine</artifactId><version>${activiti.version}</version></dependency><dependency><groupId>org.activiti</groupId><artifactId>activiti-spring</artifactId><version>${activiti.version}</version></dependency><!--?bpmn?模型處理?--><dependency><groupId>org.activiti</groupId><artifactId>activiti-bpmn-model</artifactId><version>${activiti.version}</version></dependency><!--?bpmn?轉(zhuǎn)換?--><dependency><groupId>org.activiti</groupId><artifactId>activiti-bpmn-converter</artifactId><version>${activiti.version}</version></dependency><!--?bpmn?json數(shù)據(jù)轉(zhuǎn)換?--><dependency><groupId>org.activiti</groupId><artifactId>activiti-json-converter</artifactId><version>${activiti.version}</version></dependency><!--?bpmn?布局?--><dependency><groupId>org.activiti</groupId><artifactId>activiti-bpmn-layout</artifactId><version>${activiti.version}</version></dependency><!--?activiti?云支持?--><dependency><groupId>org.activiti.cloud</groupId><artifactId>activiti-cloud-services-api</artifactId><version>${activiti.version}</version></dependency><!--?mysql驅(qū)動?--><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>5.1.40</version></dependency><!--?mybatis?--><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><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> </dependencies>添加log4j日志配置
我們使用log4j日志包，可以對日志進(jìn)行配置
在resources 下創(chuàng)建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=f:\act\activiti.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添加activiti配置文件
我們使用activiti提供的默認(rèn)方式來創(chuàng)建mysql的表。
默認(rèn)方式的要求是在 resources 下創(chuàng)建 activiti.cfg.xml 文件，注意：默認(rèn)方式目錄和文件名不能修改，因?yàn)閍ctiviti的源碼中已經(jīng)設(shè)置，到固定的目錄讀取固定文件名的文件。
<?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/beanshttp://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 中進(jìn)行配置
默認(rèn)方式要在在activiti.cfg.xml中bean的名字叫processEngineConfiguration，名字不可修改
在這里有2中配置方式：一種是單獨(dú)配置數(shù)據(jù)源，一種是不單獨(dú)配置數(shù)據(jù)源
1、直接配置processEngineConfiguration
processEngineConfiguration 用來創(chuàng)建 ProcessEngine，在創(chuàng)建 ProcessEngine 時(shí)會執(zhí)行數(shù)據(jù)庫的操作。
<?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/beanshttp://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"><!--?默認(rèn)id對應(yīng)的值?為processEngineConfiguration?--><!--?processEngine?Activiti的流程引擎?--><bean?id="processEngineConfiguration"class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"><property?name="jdbcDriver"?value="com.mysql.jdbc.Driver"/><property?name="jdbcUrl"?value="jdbc:mysql:///activiti"/><property?name="jdbcUsername"?value="root"/><property?name="jdbcPassword"?value="123456"/><!--?activiti數(shù)據(jù)庫表處理策略?--><property?name="databaseSchemaUpdate"?value="true"/></bean> </beans>2、配置數(shù)據(jù)源后，在processEngineConfiguration 引用
首先配置數(shù)據(jù)源
<?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/beanshttp://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"><!--?這里可以使用?鏈接池?dbcp--><bean?id="dataSource"?class="org.apache.commons.dbcp.BasicDataSource"><property?name="driverClassName"?value="com.mysql.jdbc.Driver"?/><property?name="url"?value="jdbc:mysql:///activiti"?/><property?name="username"?value="root"?/><property?name="password"?value="123456"?/><property?name="maxActive"?value="3"?/><property?name="maxIdle"?value="1"?/></bean><bean?id="processEngineConfiguration"class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"><!--?引用數(shù)據(jù)源?上面已經(jīng)設(shè)置好了--><property?name="dataSource"?ref="dataSource"?/><!--?activiti數(shù)據(jù)庫表處理策略?--><property?name="databaseSchemaUpdate"?value="true"/></bean> </beans>java類編寫程序生成表
創(chuàng)建一個(gè)測試類，調(diào)用activiti的工具類，生成acitivti需要的數(shù)據(jù)庫表。
直接使用activiti提供的工具類ProcessEngines，會默認(rèn)讀取classpath下的activiti.cfg.xml文件，讀取其中的數(shù)據(jù)庫配置，創(chuàng)建 ProcessEngine，在創(chuàng)建ProcessEngine 時(shí)會自動創(chuàng)建表。
代碼如下：
package?com.itheima.activiti01.test;import?org.activiti.engine.ProcessEngine; import?org.activiti.engine.ProcessEngineConfiguration; import?org.junit.Test;public?class?TestDemo?{/***?生成?activiti的數(shù)據(jù)庫表*/@Testpublic?void?testCreateDbTable()?{//使用classpath下的activiti.cfg.xml中的配置創(chuàng)建processEngineProcessEngine?processEngine?=?ProcessEngines.getDefaultProcessEngine();System.out.println(processEngine);} }說明：
運(yùn)行以上程序段即可完成 activiti 表創(chuàng)建，通過改變 activiti.cfg.xml 中databaseSchemaUpdate 參數(shù)的值執(zhí)行不同的數(shù)據(jù)表處理策略。
上 邊 的 方法 getDefaultProcessEngine方法在執(zhí)行時(shí)，從activiti.cfg.xml 中找固定的名稱 processEngineConfiguration 。
在測試程序執(zhí)行過程中，idea的控制臺會輸出日志，說明程序正在創(chuàng)建數(shù)據(jù)表，類似如下，注意紅線內(nèi)容：
執(zhí)行完成后我們查看數(shù)據(jù)庫， 創(chuàng)建了 25 張表，結(jié)果如下：
到這，我們就完成activiti運(yùn)行需要的數(shù)據(jù)庫和表的創(chuàng)建。
3.4 表結(jié)構(gòu)介紹
3.4.1 表的命名規(guī)則和作用
看到剛才創(chuàng)建的表，我們發(fā)現(xiàn)Activiti 的表都以 ACT_ 開頭。
第二部分是表示表的用途的兩個(gè)字母標(biāo)識。用途也和服務(wù)的 API 對應(yīng)。
ACT_RE ：'RE’表示 repository。這個(gè)前綴的表包含了流程定義和流程靜態(tài)資源 （圖片，規(guī)則，等等）。
ACT_RU：'RU’表示 runtime。這些運(yùn)行時(shí)的表，包含流程實(shí)例，任務(wù)，變量，異步任務(wù)，等運(yùn)行中的數(shù)據(jù)。Activiti 只在流程實(shí)例執(zhí)行過程中保存這些數(shù)據(jù)， 在流程結(jié)束時(shí)就會刪除這些記錄。這樣運(yùn)行時(shí)表可以一直很小速度很快。
ACT_HI：'HI’表示 history。這些表包含歷史數(shù)據(jù)，比如歷史流程實(shí)例， 變量，任務(wù)等等。
ACT_GE ：GE 表示 general。通用數(shù)據(jù)， 用于不同場景下
3.4.2 Activiti數(shù)據(jù)表介紹
四、Activiti類關(guān)系圖
上面我們完成了Activiti數(shù)據(jù)庫表的生成，java代碼中我們調(diào)用Activiti的工具類，下面來了解Activiti的類關(guān)系
4.1 類關(guān)系圖
在新版本中，我們通過實(shí)驗(yàn)可以發(fā)現(xiàn)IdentityService，FormService兩個(gè)Serivce都已經(jīng)刪除了。
所以后面我們對于這兩個(gè)Service也不講解了，但老版本中還是有這兩個(gè)Service，同學(xué)們需要了解一下
4.2 activiti.cfg.xml
activiti的引擎配置文件，包括：ProcessEngineConfiguration的定義、數(shù)據(jù)源定義、事務(wù)管理器等，此文件其實(shí)就是一個(gè)spring配置文件。
4.3 流程引擎配置類
流程引擎的配置類（ProcessEngineConfiguration），通過ProcessEngineConfiguration可以創(chuàng)建工作流引擎ProceccEngine，常用的兩種方法如下：
4.3.1 StandaloneProcessEngineConfiguration
使用StandaloneProcessEngineConfigurationActiviti可以單獨(dú)運(yùn)行，來創(chuàng)建ProcessEngine，Activiti會自己處理事務(wù)。
配置文件方式：
通常在activiti.cfg.xml配置文件中定義一個(gè)id為 processEngineConfiguration 的bean。
方法如下：
<bean?id="processEngineConfiguration"class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"><!--配置數(shù)據(jù)庫相關(guān)的信息--><!--數(shù)據(jù)庫驅(qū)動--><property?name="jdbcDriver"?value="com.mysql.jdbc.Driver"/><!--數(shù)據(jù)庫鏈接--><property?name="jdbcUrl"?value="jdbc:mysql:///activiti"/><!--數(shù)據(jù)庫用戶名--><property?name="jdbcUsername"?value="root"/><!--數(shù)據(jù)庫密碼--><property?name="jdbcPassword"?value="123456"/><!--actviti數(shù)據(jù)庫表在生成時(shí)的策略??true?-?如果數(shù)據(jù)庫中已經(jīng)存在相應(yīng)的表，那么直接使用，如果不存在，那么會創(chuàng)建--><property?name="databaseSchemaUpdate"?value="true"/></bean>還可以加入連接池:
<?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/beanshttp://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"><bean?id="dataSource"?class="org.apache.commons.dbcp.BasicDataSource"><property?name="driverClassName"?value="com.mysql.jdbc.Driver"/><property?name="url"?value="jdbc:mysql:///activiti"/><property?name="username"?value="root"/><property?name="password"?value="123456"/><property?name="maxActive"?value="3"/><property?name="maxIdle"?value="1"/></bean><!--在默認(rèn)方式下?bean的id??固定為?processEngineConfiguration--><bean?id="processEngineConfiguration"class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"><!--引入上面配置好的?鏈接池--><property?name="dataSource"?ref="dataSource"/><!--actviti數(shù)據(jù)庫表在生成時(shí)的策略??true?-?如果數(shù)據(jù)庫中已經(jīng)存在相應(yīng)的表，那么直接使用，如果不存在，那么會創(chuàng)建--><property?name="databaseSchemaUpdate"?value="true"/></bean> </beans>4.3.2 SpringProcessEngineConfiguration
通過org.activiti.spring.SpringProcessEngineConfiguration 與Spring整合。
創(chuàng)建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"><!--?數(shù)據(jù)源?--><property?name="dataSource"?ref="dataSource"?/><!--?使用spring事務(wù)管理器?--><property?name="transactionManager"?ref="transactionManager"?/><!--?數(shù)據(jù)庫策略?--><property?name="databaseSchemaUpdate"?value="drop-create"?/><!--?activiti的定時(shí)任務(wù)關(guān)閉?--><property?name="jobExecutorActivate"?value="false"?/></bean><!--?流程引擎?--><bean?id="processEngine"?class="org.activiti.spring.ProcessEngineFactoryBean"><property?name="processEngineConfiguration"?ref="processEngineConfiguration"?/></bean><!--?資源服務(wù)service?--><bean?id="repositoryService"?factory-bean="processEngine"factory-method="getRepositoryService"?/><!--?流程運(yùn)行service?--><bean?id="runtimeService"?factory-bean="processEngine"factory-method="getRuntimeService"?/><!--?任務(wù)管理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"?/><!--?數(shù)據(jù)源?--><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><!--?事務(wù)管理器?--><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: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><!--?切面，根據(jù)具體項(xiàng)目修改切點(diǎn)配置?--><aop:config?proxy-target-class="true"><aop:advisor?advice-ref="txAdvice"??pointcut="execution(*?com.itheima.ihrm.service.impl.*.(..))"*?/></aop:config> </beans>創(chuàng)建processEngineConfiguration
ProcessEngineConfiguration?configuration?=?ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml")上邊的代碼要求activiti.cfg.xml中必須有一個(gè)processEngineConfiguration的bean
也可以使用下邊的方法，更改bean 的名字：
ProcessEngineConfiguration.createProcessEngineConfigurationFromResource(String?resource,?String?beanName);4.4 工作流引擎創(chuàng)建
工作流引擎（ProcessEngine），相當(dāng)于一個(gè)門面接口，通過ProcessEngineConfiguration創(chuàng)建processEngine，通過ProcessEngine創(chuàng)建各個(gè)service接口。
4.4.1 默認(rèn)創(chuàng)建方式
將activiti.cfg.xml文件名及路徑固定，且activiti.cfg.xml文件中有 processEngineConfiguration的配置， 可以使用如下代碼創(chuàng)建processEngine:
//直接使用工具類?ProcessEngines，使用classpath下的activiti.cfg.xml中的配置創(chuàng)建processEngine ProcessEngine?processEngine?=?ProcessEngines.getDefaultProcessEngine(); System.out.println(processEngine);4.4.2 一般創(chuàng)建方式
//先構(gòu)建ProcessEngineConfiguration ProcessEngineConfiguration?configuration?=?ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml"); //通過ProcessEngineConfiguration創(chuàng)建ProcessEngine，此時(shí)會創(chuàng)建數(shù)據(jù)庫 ProcessEngine?processEngine?=?configuration.buildProcessEngine();4.5 Servcie服務(wù)接口
Service是工作流引擎提供用于進(jìn)行工作流部署、執(zhí)行、管理的服務(wù)接口，我們使用這些接口可以就是操作服務(wù)對應(yīng)的數(shù)據(jù)表
4.5.1 Service創(chuàng)建方式
通過ProcessEngine創(chuàng)建Service
方式如下：
RuntimeService?runtimeService?=?processEngine.getRuntimeService(); RepositoryService?repositoryService?=?processEngine.getRepositoryService(); TaskService?taskService?=?processEngine.getTaskService();4.5.2 Service總覽
簡單介紹：
RepositoryService
是activiti的資源管理類，提供了管理和控制流程發(fā)布包和流程定義的操作。使用工作流建模工具設(shè)計(jì)的業(yè)務(wù)流程圖需要使用此service將流程定義文件的內(nèi)容部署到計(jì)算機(jī)。
除了部署流程定義以外還可以：查詢引擎中的發(fā)布包和流程定義。
暫停或激活發(fā)布包，對應(yīng)全部和特定流程定義。暫停意味著它們不能再執(zhí)行任何操作了，激活是對應(yīng)的反向操作。獲得多種資源，像是包含在發(fā)布包里的文件， 或引擎自動生成的流程圖。
獲得流程定義的pojo版本， 可以用來通過java解析流程，而不必通過xml。
RuntimeService
Activiti的流程運(yùn)行管理類。可以從這個(gè)服務(wù)類中獲取很多關(guān)于流程執(zhí)行相關(guān)的信息
TaskService
Activiti的任務(wù)管理類。可以從這個(gè)類中獲取任務(wù)的信息。
HistoryService
Activiti的歷史管理類，可以查詢歷史信息，執(zhí)行流程時(shí)，引擎會保存很多數(shù)據(jù)（根據(jù)配置），比如流程實(shí)例啟動時(shí)間，任務(wù)的參與者， 完成任務(wù)的時(shí)間，每個(gè)流程實(shí)例的執(zhí)行路徑，等等。這個(gè)服務(wù)主要通過查詢功能來獲得這些數(shù)據(jù)。
ManagementService
Activiti的引擎管理類，提供了對 Activiti 流程引擎的管理和維護(hù)功能，這些功能不在工作流驅(qū)動的應(yīng)用程序中使用，主要用于 Activiti 系統(tǒng)的日常維護(hù)。
五、Activiti入門
在本章內(nèi)容中，我們來創(chuàng)建一個(gè)Activiti工作流，并啟動這個(gè)流程。
創(chuàng)建Activiti工作流主要包含以下幾步：
定義流程，按照BPMN的規(guī)范，使用流程定義工具，用流程符號把整個(gè)流程描述出來
部署流程，把畫好的流程定義文件，加載到數(shù)據(jù)庫中，生成表的數(shù)據(jù)
啟動流程，使用java代碼來操作數(shù)據(jù)庫表中的內(nèi)容
5.1 流程符號
BPMN 2.0是業(yè)務(wù)流程建模符號2.0的縮寫。
它由Business Process Management Initiative這個(gè)非營利協(xié)會創(chuàng)建并不斷發(fā)展。作為一種標(biāo)識，BPMN 2.0是使用一些符號來明確業(yè)務(wù)流程設(shè)計(jì)流程圖的一整套符號規(guī)范，它能增進(jìn)業(yè)務(wù)建模時(shí)的溝通效率。
目前BPMN2.0是最新的版本，它用于在BPM上下文中進(jìn)行布局和可視化的溝通。
接下來我們先來了解在流程設(shè)計(jì)中常見的 符號。
BPMN2.0的基本符合主要包含：
事件 Event
活動 Activity
活動是工作或任務(wù)的一個(gè)通用術(shù)語。一個(gè)活動可以是一個(gè)任務(wù)，還可以是一個(gè)當(dāng)前流程的子處理流程；其次，你還可以為活動指定不同的類型。常見活動如下：
網(wǎng)關(guān) GateWay
網(wǎng)關(guān)用來處理決策，有幾種常用網(wǎng)關(guān)需要了解：
排他網(wǎng)關(guān) (x)
——只有一條路徑會被選擇。流程執(zhí)行到該網(wǎng)關(guān)時(shí)，按照輸出流的順序逐個(gè)計(jì)算，當(dāng)條件的計(jì)算結(jié)果為true時(shí)，繼續(xù)執(zhí)行當(dāng)前網(wǎng)關(guān)的輸出流；
如果多條線路計(jì)算結(jié)果都是 true，則會執(zhí)行第一個(gè)值為 true 的線路。如果所有網(wǎng)關(guān)計(jì)算結(jié)果沒有true，則引擎會拋出異常。
排他網(wǎng)關(guān)需要和條件順序流結(jié)合使用，default 屬性指定默認(rèn)順序流，當(dāng)所有的條件不滿足時(shí)會執(zhí)行默認(rèn)順序流。
并行網(wǎng)關(guān) (+)
——所有路徑會被同時(shí)選擇
拆分 —— 并行執(zhí)行所有輸出順序流，為每一條順序流創(chuàng)建一個(gè)并行執(zhí)行線路。
合并 —— 所有從并行網(wǎng)關(guān)拆分并執(zhí)行完成的線路均在此等候，直到所有的線路都執(zhí)行完成才繼續(xù)向下執(zhí)行。
包容網(wǎng)關(guān) (+)
—— 可以同時(shí)執(zhí)行多條線路，也可以在網(wǎng)關(guān)上設(shè)置條件
拆分 —— 計(jì)算每條線路上的表達(dá)式，當(dāng)表達(dá)式計(jì)算結(jié)果為true時(shí)，創(chuàng)建一個(gè)并行線路并繼續(xù)執(zhí)行
合并 —— 所有從并行網(wǎng)關(guān)拆分并執(zhí)行完成的線路均在此等候，直到所有的線路都執(zhí)行完成才繼續(xù)向下執(zhí)行。
事件網(wǎng)關(guān) (+)
—— 專門為中間捕獲事件設(shè)置的，允許設(shè)置多個(gè)輸出流指向多個(gè)不同的中間捕獲事件。當(dāng)流程執(zhí)行到事件網(wǎng)關(guān)后，流程處于等待狀態(tài)，需要等待拋出事件才能將等待狀態(tài)轉(zhuǎn)換為活動狀態(tài)。
流向 Flow
流是連接兩個(gè)流程節(jié)點(diǎn)的連線。常見的流向包含以下幾種：
5.2 流程設(shè)計(jì)器使用
Activiti-Designer使用
Palette（畫板）
在idea中安裝插件即可使用，畫板中包括以下結(jié)點(diǎn)：
Connection—連接
Event—事件
Task—任務(wù)
Gateway—網(wǎng)關(guān)
Container—容器
Boundary event—邊界事件
Intermediate event- -中間事件
流程圖設(shè)計(jì)完畢保存生成.bpmn文件
新建流程(IDEA工具)
首先選中存放圖形的目錄(選擇resources下的bpmn目錄)，點(diǎn)擊菜單：New -> BpmnFile，如圖：
彈出如下圖所示框，輸入evection 表示 出差審批流程：
起完名字evection后（默認(rèn)擴(kuò)展名為bpmn），就可以看到流程設(shè)計(jì)頁面，如圖所示：
左側(cè)區(qū)域是繪圖區(qū)，右側(cè)區(qū)域是palette畫板區(qū)域
鼠標(biāo)先點(diǎn)擊畫板的元素即可在左側(cè)繪圖
繪制流程
使用滑板來繪制流程，通過從右側(cè)把圖標(biāo)拖拽到左側(cè)的畫板，最終效果如下：
指定流程定義Key
流程定義key即流程定義的標(biāo)識，通過properties視圖查看流程的key
指定任務(wù)負(fù)責(zé)人
在properties視圖指定每個(gè)任務(wù)結(jié)點(diǎn)的負(fù)責(zé)人，如：填寫出差申請的負(fù)責(zé)人為 zhangsan
經(jīng)理審批負(fù)責(zé)人為 jerry
總經(jīng)理審批負(fù)責(zé)人為 jack
財(cái)務(wù)審批負(fù)責(zé)人為 rose
六、流程操作
6.1 流程定義
概述
流程定義是線下按照bpmn2.0標(biāo)準(zhǔn)去描述 業(yè)務(wù)流程，通常使用idea中的插件對業(yè)務(wù)流程進(jìn)行建模。IDEA插件介紹：IDEA 值得推薦的十幾款優(yōu)秀插件，狂，拽，屌！
使用idea下的designer設(shè)計(jì)器繪制流程，并會生成兩個(gè)文件：.bpmn和.png
.bpmn文件
使用activiti-desinger設(shè)計(jì)業(yè)務(wù)流程，會生成.bpmn文件，上面我們已經(jīng)創(chuàng)建好了bpmn文件
BPMN 2.0根節(jié)點(diǎn)是definitions節(jié)點(diǎn)。這個(gè)元素中，可以定義多個(gè)流程定義（不過我們建議每個(gè)文件只包含一個(gè)流程定義， 可以簡化開發(fā)過程中的維護(hù)難度）。
注意，definitions元素 最少也要包含xmlns 和 targetNamespace的聲明。targetNamespace可以是任意值，它用來對流程實(shí)例進(jìn)行分類。
流程定義部分：定義了流程每個(gè)結(jié)點(diǎn)的描述及結(jié)點(diǎn)之間的流程流轉(zhuǎn)。
流程布局定義：定義流程每個(gè)結(jié)點(diǎn)在流程圖上的位置坐標(biāo)等信息。
生成.png圖片文件
IDEA工具中的操作方式
1、修改文件后綴為xml
首先將evection.bpmn文件改名為evection.xml，如下圖：
evection.xml修改前的bpmn文件，效果如下：
2、使用designer設(shè)計(jì)器打開.xml文件
在evection.xml文件上面，點(diǎn)右鍵并選擇Diagrams菜單，再選擇Show BPMN2.0 Designer…
3、查看打開的文件
打開后，卻出現(xiàn)亂碼，如圖：
4、解決中文亂碼
1、打開Settings，找到File Encodings，把encoding的選項(xiàng)都選擇UTF-8
2、打開IDEA安裝路徑，找到如下的安裝目錄
根據(jù)自己所安裝的版本來決定，我使用的是64位的idea，所以在idea64.exe.vmoptions文件的最后一行追加一條命令： -Dfile.encoding=UTF-8
如下所示：
一定注意，不要有空格，否則重啟IDEA時(shí)會打不開，然后 重啟IDEA。
如果以上方法已經(jīng)做完，還出現(xiàn)亂碼，就再修改一個(gè)文件，并在文件的末尾添加：-Dfile.encoding=UTF-8，然后重啟idea，如圖：
最后重新在evection.xml文件上面，點(diǎn)右鍵并選擇Diagrams菜單，再選擇Show BPMN2.0 Designer…，看到生成圖片，如圖：
到此，解決亂碼問題
5、導(dǎo)出為圖片文件
點(diǎn)擊Export To File的小圖標(biāo)，打開如下窗口，注意填寫文件名及擴(kuò)展名，選擇好保存圖片的位置：
然后，我們把png文件拷貝到resources下的bpmn目錄，并且把evection.xml改名為evection.bpmn。
6.2 流程定義部署
概述
將上面在設(shè)計(jì)器中定義的流程部署到activiti數(shù)據(jù)庫中，就是流程定義部署。
通過調(diào)用activiti的api將流程定義的bpmn和png兩個(gè)文件一個(gè)一個(gè)添加部署到activiti中，也可以將兩個(gè)文件打成zip包進(jìn)行部署。
單個(gè)文件部署方式
分別將bpmn文件和png圖片文件部署。
public?class?ActivitiDemo?{/***?部署流程定義*/@Testpublic?void?testDeployment(){ //????????1、創(chuàng)建ProcessEngineProcessEngine?processEngine?=?ProcessEngines.getDefaultProcessEngine(); //????????2、得到RepositoryService實(shí)例RepositoryService?repositoryService?=?processEngine.getRepositoryService(); //????????3、使用RepositoryService進(jìn)行部署Deployment?deployment?=?repositoryService.createDeployment().addClasspathResource("bpmn/evection.bpmn")?//?添加bpmn資源.addClasspathResource("bpmn/evection.png")??//?添加png資源.name("出差申請流程").deploy(); //????????4、輸出部署信息System.out.println("流程部署id："?+?deployment.getId());System.out.println("流程部署名稱："?+?deployment.getName());} }執(zhí)行此操作后activiti會將上邊代碼中指定的bpm文件和圖片文件保存在activiti數(shù)據(jù)庫。
壓縮包部署方式
將evection.bpmn和evection.png壓縮成zip包。
@Testpublic?void?deployProcessByZip()?{//?定義zip輸入流InputStream?inputStream?=?this.getClass().getClassLoader().getResourceAsStream("bpmn/evection.zip");ZipInputStream?zipInputStream?=?new?ZipInputStream(inputStream);//?獲取repositoryServiceRepositoryService?repositoryService?=?processEngine.getRepositoryService();//?流程部署Deployment?deployment?=?repositoryService.createDeployment().addZipInputStream(zipInputStream).deploy();System.out.println("流程部署id："?+?deployment.getId());System.out.println("流程部署名稱："?+?deployment.getName());}執(zhí)行此操作后activiti會將上邊代碼中指定的bpm文件和圖片文件保存在activiti數(shù)據(jù)庫。
操作數(shù)據(jù)表
流程定義部署后操作activiti的3張表如下：
act_re_deployment 流程定義部署表，每部署一次增加一條記錄
act_re_procdef 流程定義表，部署每個(gè)新的流程定義都會在這張表中增加一條記錄
act_ge_bytearray 流程資源表
接下來我們來看看，寫入了什么數(shù)據(jù)：
SELECT?*?FROM?act_re_deployment?#流程定義部署表，記錄流程部署信息結(jié)果：
SELECT?*?FROM?act_re_procdef?#流程定義表，記錄流程定義信息結(jié)果：
注意，KEY 這個(gè)字段是用來唯一識別不同流程的關(guān)鍵字
SELECT?*?FROM?act_ge_bytearray?#資源表結(jié)果：
注意：
act_re_deployment和act_re_procdef一對多關(guān)系，一次部署在流程部署表生成一條記錄，但一次部署可以部署多個(gè)流程定義，每個(gè)流程定義在流程定義表生成一條記錄。每一個(gè)流程定義在act_ge_bytearray會存在兩個(gè)資源記錄，bpmn和png。
建議：一次部署一個(gè)流程，這樣部署表和流程定義表是一對一有關(guān)系，方便讀取流程部署及流程定義信息。
6.3 啟動流程實(shí)例
流程定義部署在activiti后就可以通過工作流管理業(yè)務(wù)流程了，也就是說上邊部署的出差申請流程可以使用了。
針對該流程，啟動一個(gè)流程表示發(fā)起一個(gè)新的出差申請單，這就相當(dāng)于java類與java對象的關(guān)系，類定義好后需要new創(chuàng)建一個(gè)對象使用，當(dāng)然可以new多個(gè)對象。對于請出差申請流程，張三發(fā)起一個(gè)出差申請單需要啟動一個(gè)流程實(shí)例，出差申請單發(fā)起一個(gè)出差單也需要啟動一個(gè)流程實(shí)例。
代碼如下：
/***?啟動流程實(shí)例*/@Testpublic?void?testStartProcess(){ //????????1、創(chuàng)建ProcessEngineProcessEngine?processEngine?=?ProcessEngines.getDefaultProcessEngine(); //????????2、獲取RunTimeServiceRuntimeService?runtimeService?=?processEngine.getRuntimeService(); //????????3、根據(jù)流程定義Id啟動流程ProcessInstance?processInstance?=?runtimeService.startProcessInstanceByKey("myEvection"); //????????輸出內(nèi)容System.out.println("流程定義id："?+?processInstance.getProcessDefinitionId());System.out.println("流程實(shí)例id："?+?processInstance.getId());System.out.println("當(dāng)前活動Id："?+?processInstance.getActivityId());}輸出內(nèi)容如下：
操作數(shù)據(jù)表
act_hi_actinst 流程實(shí)例執(zhí)行歷史
act_hi_identitylink 流程的參與用戶歷史信息
act_hi_procinst 流程實(shí)例歷史信息
act_hi_taskinst 流程任務(wù)歷史信息
act_ru_execution 流程執(zhí)行信息
act_ru_identitylink 流程的參與用戶信息
act_ru_task 任務(wù)信息
6.4 任務(wù)查詢
流程啟動后，任務(wù)的負(fù)責(zé)人就可以查詢自己當(dāng)前需要處理的任務(wù)，查詢出來的任務(wù)都是該用戶的待辦任務(wù)。
/***?查詢當(dāng)前個(gè)人待執(zhí)行的任務(wù)*/@Testpublic?void?testFindPersonalTaskList()?{ //????????任務(wù)負(fù)責(zé)人String?assignee?=?"zhangsan";ProcessEngine?processEngine?=?ProcessEngines.getDefaultProcessEngine(); //????????創(chuàng)建TaskServiceTaskService?taskService?=?processEngine.getTaskService(); //????????根據(jù)流程key?和?任務(wù)負(fù)責(zé)人?查詢?nèi)蝿?wù)List<Task>?list?=?taskService.createTaskQuery().processDefinitionKey("myEvection")?//流程Key.taskAssignee(assignee)//只查詢該任務(wù)負(fù)責(zé)人的任務(wù).list();for?(Task?task?:?list)?{System.out.println("流程實(shí)例id："?+?task.getProcessInstanceId());System.out.println("任務(wù)id："?+?task.getId());System.out.println("任務(wù)負(fù)責(zé)人："?+?task.getAssignee());System.out.println("任務(wù)名稱："?+?task.getName());}}輸出結(jié)果如下：
流程實(shí)例id：2501 任務(wù)id：2505 任務(wù)負(fù)責(zé)人：zhangsan 任務(wù)名稱：創(chuàng)建出差申請6.5 流程任務(wù)處理
任務(wù)負(fù)責(zé)人查詢待辦任務(wù)，選擇任務(wù)進(jìn)行處理，完成任務(wù)。
//?完成任務(wù)@Testpublic?void?completTask(){ //????????獲取引擎ProcessEngine?processEngine?=?ProcessEngines.getDefaultProcessEngine(); //????????獲取taskServiceTaskService?taskService?=?processEngine.getTaskService();//????????根據(jù)流程key?和?任務(wù)的負(fù)責(zé)人?查詢?nèi)蝿?wù) //????????返回一個(gè)任務(wù)對象Task?task?=?taskService.createTaskQuery().processDefinitionKey("myEvection")?//流程Key.taskAssignee("zhangsan")??//要查詢的負(fù)責(zé)人.singleResult();//????????完成任務(wù),參數(shù)：任務(wù)idtaskService.complete(task.getId());}6.6 流程定義信息查詢
查詢流程相關(guān)信息，包含流程定義，流程部署，流程定義版本
/***?查詢流程定義*/@Testpublic?void?queryProcessDefinition(){//????????獲取引擎ProcessEngine?processEngine?=?ProcessEngines.getDefaultProcessEngine(); //????????repositoryServiceRepositoryService?repositoryService?=?processEngine.getRepositoryService(); //????????得到ProcessDefinitionQuery?對象ProcessDefinitionQuery?processDefinitionQuery?=?repositoryService.createProcessDefinitionQuery(); //??????????查詢出當(dāng)前所有的流程定義 //??????????條件：processDefinitionKey =evection //??????????orderByProcessDefinitionVersion?按照版本排序 //????????desc倒敘 //????????list?返回集合List<ProcessDefinition>?definitionList?=?processDefinitionQuery.processDefinitionKey("myEvection").orderByProcessDefinitionVersion().desc().list(); //??????輸出流程定義信息for?(ProcessDefinition?processDefinition?:?definitionList)?{System.out.println("流程定義?id="+processDefinition.getId());System.out.println("流程定義?name="+processDefinition.getName());System.out.println("流程定義?key="+processDefinition.getKey());System.out.println("流程定義?Version="+processDefinition.getVersion());System.out.println("流程部署ID?="+processDefinition.getDeploymentId());}}輸出結(jié)果：
流程定義id：myEvection:1:4 流程定義名稱：出差申請單 流程定義key：myEvection 流程定義版本：16.7 流程刪除
public?void?deleteDeployment()?{//?流程部署idString?deploymentId?=?"1";ProcessEngine?processEngine?=?ProcessEngines.getDefaultProcessEngine();//?通過流程引擎獲取repositoryServiceRepositoryService?repositoryService?=?processEngine.getRepositoryService();//刪除流程定義，如果該流程定義已有流程實(shí)例啟動則刪除時(shí)出錯(cuò)repositoryService.deleteDeployment(deploymentId);//設(shè)置true?級聯(lián)刪除流程定義，即使該流程有流程實(shí)例啟動也可以刪除，設(shè)置為false非級別刪除方式，如果流程//repositoryService.deleteDeployment(deploymentId,?true);}說明：
使用repositoryService刪除流程定義，歷史表信息不會被刪除
如果該流程定義下沒有正在運(yùn)行的流程，則可以用普通刪除。
如果該流程定義下存在已經(jīng)運(yùn)行的流程，使用普通刪除報(bào)錯(cuò)，可用級聯(lián)刪除方法將流程及相關(guān)記錄全部刪除。
先刪除沒有完成流程節(jié)點(diǎn)，最后就可以完全刪除流程定義信息
項(xiàng)目開發(fā)中級聯(lián)刪除操作一般只開放給超級管理員使用.
6.8 流程資源下載
現(xiàn)在我們的流程資源文件已經(jīng)上傳到數(shù)據(jù)庫了，如果其他用戶想要查看這些資源文件，可以從數(shù)據(jù)庫中把資源文件下載到本地。
解決方案有：
jdbc對blob類型，clob類型數(shù)據(jù)讀取出來，保存到文件目錄
使用activiti的api來實(shí)現(xiàn)
使用commons-io.jar 解決IO的操作
引入commons-io依賴包
<dependency><groupId>commons-io</groupId><artifactId>commons-io</artifactId><version>2.6</version> </dependency>通過流程定義對象獲取流程定義資源，獲取bpmn和png
import?org.apache.commons.io.IOUtils;@Testpublic?void?deleteDeployment(){ //????????獲取引擎ProcessEngine?processEngine?=?ProcessEngines.getDefaultProcessEngine(); //????????獲取repositoryServiceRepositoryService?repositoryService?=?processEngine.getRepositoryService(); //????????根據(jù)部署id?刪除部署信息,如果想要級聯(lián)刪除，可以添加第二個(gè)參數(shù)，truerepositoryService.deleteDeployment("1");}public?void??queryBpmnFile()?throws?IOException?{ //????????1、得到引擎ProcessEngine?processEngine?=?ProcessEngines.getDefaultProcessEngine(); //????????2、獲取repositoryServiceRepositoryService?repositoryService?=?processEngine.getRepositoryService(); //??????? 3、得到查詢器：ProcessDefinitionQuery，設(shè)置查詢條件,得到想要的流程定義ProcessDefinition?processDefinition?=?repositoryService.createProcessDefinitionQuery().processDefinitionKey("myEvection").singleResult(); //????????4、通過流程定義信息，得到部署IDString?deploymentId?=?processDefinition.getDeploymentId(); //????????5、通過repositoryService的方法，實(shí)現(xiàn)讀取圖片信息和bpmn信息 //????????png圖片的流InputStream?pngInput?=?repositoryService.getResourceAsStream(deploymentId,?processDefinition.getDiagramResourceName()); //????????bpmn文件的流InputStream?bpmnInput?=?repositoryService.getResourceAsStream(deploymentId,?processDefinition.getResourceName()); //????????6、構(gòu)造OutputStream流File?file_png?=?new?File("d:/evectionflow01.png");File?file_bpmn?=?new?File("d:/evectionflow01.bpmn");FileOutputStream?bpmnOut?=?new?FileOutputStream(file_bpmn);FileOutputStream?pngOut?=?new?FileOutputStream(file_png); //????????7、輸入流，輸出流的轉(zhuǎn)換IOUtils.copy(pngInput,pngOut);IOUtils.copy(bpmnInput,bpmnOut); //????????8、關(guān)閉流pngOut.close();bpmnOut.close();pngInput.close();bpmnInput.close();}說明：
deploymentId為流程部署ID
resource_name為act_ge_bytearray表中NAME_列的值
使用repositoryService的getDeploymentResourceNames方法可以獲取指定部署下得所有文件的名稱
使用repositoryService的getResourceAsStream方法傳入部署ID和資源圖片名稱可以獲取部署下指定名稱文件的輸入流
最后的將輸入流中的圖片資源進(jìn)行輸出。
6.9 流程歷史信息的查看
即使流程定義已經(jīng)刪除了，流程執(zhí)行的歷史信息通過前面的分析，依然保存在activiti的act_hi_*相關(guān)的表中。所以我們還是可以查詢流程執(zhí)行的歷史信息，可以通過HistoryService來查看相關(guān)的歷史記錄。
/***?查看歷史信息*/@Testpublic?void?findHistoryInfo(){ //??????獲取引擎ProcessEngine?processEngine?=?ProcessEngines.getDefaultProcessEngine(); //????????獲取HistoryServiceHistoryService?historyService?=?processEngine.getHistoryService(); //????????獲取?actinst表的查詢對象HistoricActivityInstanceQuery?instanceQuery?=?historyService.createHistoricActivityInstanceQuery(); //????????查詢 actinst表，條件：根據(jù) InstanceId 查詢 //????????instanceQuery.processInstanceId("2501"); //????????查詢 actinst表，條件：根據(jù) DefinitionId 查詢instanceQuery.processDefinitionId("myEvection:1:4"); //????????增加排序操作,orderByHistoricActivityInstanceStartTime?根據(jù)開始時(shí)間排序?asc?升序instanceQuery.orderByHistoricActivityInstanceStartTime().asc(); //????????查詢所有內(nèi)容List<HistoricActivityInstance>?activityInstanceList?=?instanceQuery.list(); //????????輸出for?(HistoricActivityInstance?hi?:?activityInstanceList)?{System.out.println(hi.getActivityId());System.out.println(hi.getActivityName());System.out.println(hi.getProcessDefinitionId());System.out.println(hi.getProcessInstanceId());System.out.println("<==========================>");}}總結(jié)
基本功能介紹以及完成了，如果還需要更加高級的功能比如掛起、激活流程實(shí)例、流程變量等請參考
https://andyoung.blog.csdn.net/article/details/118345330
工作流引擎 Activiti 與 Spring boot 結(jié)合會是開發(fā)跟簡單，不如來看下
https://andyoung.blog.csdn.net/article/details/118372175
來源：https://blog.csdn.net/agonie201218/
article/details/118198535
精彩推薦
總結(jié)
以上是生活随笔為你收集整理的工作流引擎 Activiti 保姆级教程的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： catia 安装打开闪退_安装CATIA
- 下一篇： 简单的LaTeX数学表达式教程