Activiti工作流入門詳解完整教程

Activiti入門教程詳解完整教程Activiti介紹Activiti是由Alfresco軟件在2010年5月17日發(fā)布的業(yè)務(wù)流程管理(BPM)框架,它是覆蓋了業(yè)務(wù)流程管理，工作流，服務(wù)協(xié)作等領(lǐng)域的一個開源，靈活的，易擴(kuò)展的可執(zhí)行流程語言框架。Activiti基于Apache許可的開源BPM平臺，創(chuàng)始人TomBaeyens是JBossJBPM的項目架構(gòu)師，它的特色是提供了eclipse插件，開發(fā)人員可以通過插件直接繪畫出業(yè)務(wù)流程圖。工作流引擎ProcessEngine對象，這是Activiti工作的核心。負(fù)責(zé)生成流程運行時的各種實例及數(shù)據(jù)，監(jiān)控和管理流程的運行。BPMN業(yè)務(wù)流程建模與標(biāo)注（BusinessProcessModelandNotation,BPMN），描述流程的基本符號，包括這些圖元如何組合成一個業(yè)務(wù)流程圖(BusinessProcessDiagram)準(zhǔn)備環(huán)境Activiti軟件環(huán)境JDK1.6或者更高版本支持的數(shù)據(jù)庫有:h2,mysql,oracle,mysql,db2等支持Activiti運行的jar包，可以通過maven依賴引入開發(fā)環(huán)境為Eclipse3.7或者以上版本，myeclipse為8.6版本2.2安裝流程設(shè)計器(eclipse插件)1）打開HelpInstallNewSoftwareAdd輸入Name:ActivitiDesigner Location:http://A/designer/update/輸入完成后，單擊OK按鈕等待下載完成后安裝。安裝完成后在菜單選項中會出現(xiàn)Activiti的目錄選項2.3設(shè)置eclipseactivit插件的畫流程圖選項打開菜單Windows-->Preferences-->Activiti-->Save下流程圖片的生成方式勾選上Createprocessdefinitionimagewhensavingthediagram操作，勾選上這個操作后在畫流程圖后保存eclipse會自動生成對應(yīng)的流程圖片。2.4準(zhǔn)備開發(fā)環(huán)境2.4.1創(chuàng)建mavenweb項目，在maven中添加Activiti依賴在eclipse左邊工作欄右鍵New選擇創(chuàng)建MavenProject項目，創(chuàng)建一個名為ActivitiTest的項目點擊Finish完成。右鍵項目選擇Properties，選擇ProjectFacets勾選上圖中的選項，點擊Apply，再點擊OK然后將項目轉(zhuǎn)換成web項目,右鍵項目選擇Properties,在ProjectFacets中做如下勾選,然后點擊Appy應(yīng)用和OK確定然后右鍵項目Properties，選擇DeploymentAssembly,將test相關(guān)目錄Remove掉之保留main下面需要發(fā)布的內(nèi)容，如下圖然后點擊Appply和OK然后在pom.xml文件中添加以下依賴<dependencies><dependency><groupId>org.Activiti</groupId><artifactId>Activiti-engine</artifactId><version>5.21.0</version></dependency><dependency><groupId>org.Activiti</groupId><artifactId>Activiti-spring</artifactId><version>5.21.0</version></dependency><dependency><groupId>org.codehaus.groovy</groupId><artifactId>groovy-all</artifactId><version>2.4.3</version></dependency><dependency><groupId>org.slf4j</groupId><artifactId>slf4j-api</artifactId><version>1.7.6</version></dependency><dependency><groupId>org.slf4j</groupId><artifactId>slf4j-jdk14</artifactId><version>1.7.6</version></dependency><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>3.8.1</version><scope>test</scope></dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>5.1.38</version></dependency></dependencies>然后在命令行下mvncompile編譯當(dāng)前項目，將需要的包下載到本地倉庫2.4.2初始化數(shù)據(jù)庫1）src/main/resource目錄下創(chuàng)建Activiti.cfg.xml文件,內(nèi)容如下<?xmlversion="1.0"encoding="UTF-8"?><beansxmlns="/schema/beans"xmlns:xsi="/2001/XMLSchema-instance"xmlns:context="/schema/context"xmlns:tx="/schema/tx"xmlns:jee="/schema/jee"xmlns:aop="/schema/aop"xsi:schemaLocation="/schema/beans/schema/beans/spring-beans-3.0.xsd/schema/context/schema/context/spring-context-3.0.xsd/schema/tx/schema/tx/spring-tx-3.0.xsd/schema/jee/schema/jee/spring-jee-3.0.xsd/schema/aop/schema/aop/spring-aop-3.0.xsd"><beanid="processEngineConfiguration"class="org.Activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"><propertyname="jdbcDriver"value="com.mysql.jdbc.Driver"/><propertyname="jdbcUrl"value="jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=utf8"/><propertyname="jdbcUsername"value="root"/><propertyname="jdbcPassword"value="root"/><propertyname="databaseSchemaUpdate"value="true"/></bean></beans>jdbcUrl為你電腦數(shù)據(jù)庫的urljdbcUsername為數(shù)據(jù)庫用戶名jdbcPassword為數(shù)據(jù)庫密碼2)在main/java目錄下創(chuàng)建任意目錄和類編寫創(chuàng)建Activiti數(shù)據(jù)表方法publicclassCreateTable{/**** *創(chuàng)建流程表 **/@TestpublicvoidcreateTable(){ ProcessEngineprocessEngine=ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("Activiti.cfg.xml") .buildProcessEngine(); System.out.println("------processEngine:"+processEngine); }}然后運行該測試方法，如果運行成功，在數(shù)據(jù)庫中應(yīng)該會產(chǎn)生25張Activiti的相關(guān)數(shù)據(jù)表2.4.3Activiti表說明下面是概括了幾個常用的數(shù)據(jù)表流程部署相關(guān)表act_re_deployement部署對象表act_rep_procdef流程定義表act_ge_bytearray資源文件表act_ge_prperty主鍵生成策略表（對于部署對象表的主鍵ID）流程實例相關(guān)表act_ru_execution正在執(zhí)行的執(zhí)行對象表（包含執(zhí)行對象ID和流程實例ID，如果有多個線程可能流程實例ID不一樣）act_hi_procinst流程實例歷史表act_hi_actinst存放歷史所有完成的任務(wù)Task任務(wù)相關(guān)表act_ru_task代辦任務(wù)表（只對應(yīng)節(jié)點是UserTask的）act_hi_taskinst代辦任務(wù)歷史表（只對應(yīng)節(jié)點是UserTask的）act_hi_actinst所有節(jié)點活動歷史表（對應(yīng)流程的所有節(jié)點的活動歷史，從開始節(jié)點一直到結(jié)束節(jié)點中間的所有節(jié)點的活動都會被記錄）流程變量表act_ru_variable正在執(zhí)行的流程變量表act_hi_variable流程變量歷史表3.核心API3.1ProcessEngine說明:1)在Activiti中最核心的類，其他的類都是由他而來。2)產(chǎn)生方式ProcessEngineprocessEngine=ProcessEngines.getDefaultProcessEngine();3）可以產(chǎn)生RepositoryServiceRepositoryServicerepositoryService=processEngine.getRepositoryService();4)可以產(chǎn)生RuntimeServiceRuntimeServiceruntimeService=processEngine.getRuntimeService();5)可以產(chǎn)生TaskServiceTaskServicetaskService=processEngine.getTaskService();各個Service的作用RepositoryService管理流程定義RuntimeService執(zhí)行管理，包括啟動，推進(jìn)，刪除流程實例等操作TaskService任務(wù)管理3.2RepositoryServiceActiviti的倉庫服務(wù)類。所謂的倉庫指流程定義文檔的兩個文件：bpmn文件和流程圖片該service可以用來刪除部署的流程定義。3.3RuntimeService是Activiti的流程執(zhí)行服務(wù)類，可以從這個服務(wù)類中獲取很多關(guān)于流程執(zhí)行的相關(guān)的信息。3.4TaskService是Activiti的任務(wù)服務(wù)類?？梢詮倪@個類中獲取任務(wù)的相關(guān)信息，如當(dāng)前正在執(zhí)行的個人待辦和用戶組待辦任務(wù)。3.5HistoryService是Activiti的查詢歷史信息的類，在一個流程執(zhí)行完成后，這個對象為我們提供查詢歷史信息，可以跟蹤流程實例對應(yīng)所有待辦節(jié)點的運行情況。3.6ProcessDefinition流程定義類，可以從這里獲得資源文件等。3.7ProcessInstance代表流程定義的執(zhí)行實例，當(dāng)一個部署的流程圖啟動后，該流程只有一條流程實例數(shù)據(jù)，但是它的流程任務(wù)可以有多個，每個任務(wù)對應(yīng)流程圖中相應(yīng)的流程節(jié)點。4.入門HelloWorld程序4.1創(chuàng)建流程圖方法點擊ActivitiTest項目，在src/main/java目錄下創(chuàng)建一個diagrams目錄用來存放流程圖在當(dāng)前項目右鍵選擇ActivitiDiagram流程圖輸入流程圖名稱HelloWorld，然后點擊OK，在控制面板的右邊欄有相關(guān)的畫圖圖標(biāo)操作其中一個流程必須包含一個開始節(jié)點和一個結(jié)束節(jié)點，結(jié)束節(jié)點可以有多個。然后使用StartEvent,UserTask,EndEvent畫出下面的流程圖，然后用Connection中的SequenceFlow連線連接起來。4.2創(chuàng)建流程圖，如下圖4.3指定流程圖名稱，ID和UserTask的處理人1）選中第一個節(jié)點，在General中的name屬性中輸入當(dāng)前節(jié)點的名稱,在Mainconfig中的Assignee中輸入該節(jié)點的處理人，然后以此類推將3個節(jié)點的值設(shè)置完成。，2）然后在流程圖旁邊的空白出點擊一下，輸入流程的ID和Name值，然后保存4.4將流程圖部署到Activiti的數(shù)據(jù)表中啟動完成后在act_re_deployment流程部署表和act_re_procdef流程定義表中會有對應(yīng)的數(shù)據(jù)信息.4.5啟動流程實例其中runtimeService.startProcessInstanceByKey("HelloWorldKey");中的HelloWorldKey對應(yīng)流程圖中的ID值,在數(shù)據(jù)表中對應(yīng)act_re_procdef流程定義表中的key字段啟動完流程后在act_ru_execution表中會產(chǎn)生一條數(shù)據(jù)，這條數(shù)據(jù)為當(dāng)前流程正在執(zhí)行的任務(wù)，其中act_id_字段的值對應(yīng)流程圖節(jié)點的ID值在act_ru_task表中會產(chǎn)生一條任務(wù)數(shù)據(jù),execution_id_對應(yīng)act_ru_execution主鍵，proc_inst_id_為流程實例ID，name_值為流程節(jié)點名稱，assignee_字段為該待辦當(dāng)前的處理人4.6查詢待辦任務(wù)指定查詢張三的待辦，可以查詢出待辦為第一個節(jié)點的處理任務(wù)。4.7完成待辦任務(wù)其中taskId對應(yīng)act_ru_task表的主鍵ID，因為當(dāng)前待辦任務(wù)為第一個節(jié)點提交申請，當(dāng)執(zhí)行完這個待辦后下一條待辦數(shù)據(jù)將會流轉(zhuǎn)到審批【部門經(jīng)理】那，然后以此類推可以將部門經(jīng)理和總經(jīng)理的待辦任務(wù)全部查詢和執(zhí)行完成。5.查詢和刪除流程定義1）查詢流程定義2)刪除流程定義6.流程變量操作6.1設(shè)置流程變量1）設(shè)置流程變量有多種方式，可以在流程啟動，和任務(wù)執(zhí)行的時候設(shè)置a.啟動流程的時候設(shè)置b.通過taskService或者runtimeService設(shè)置提示：如果設(shè)置的流程變量值是一個對象類型，這個對象必須實現(xiàn)序列化Serializable操作,并且要為該對象類指定一個版本ID6.2獲取流程變量見工程操作7.流程連線在畫流程圖的時候可以對流程的連線設(shè)置表達(dá)式，然后在執(zhí)行的時候設(shè)置流程變量值，然后Activiti會根據(jù)對應(yīng)的值走對應(yīng)的節(jié)點點擊一條連線，在Mainconfig中的Condition屬性值中設(shè)置${message=='同意'}，另外一條線設(shè)置為${message=='不同意'}，然后在代碼中設(shè)置對應(yīng)流程變量值。見工程操作8.排他網(wǎng)關(guān)如下圖,其中黑色的叉叉對應(yīng)eclipse畫流程圖圖標(biāo)中的ExclusiveGateWay圖標(biāo)然后對每條線的Condition屬性指定對應(yīng)的表達(dá)式，然后在執(zhí)行任務(wù)時候設(shè)置對應(yīng)的流程變量Activiti會根據(jù)變量的值來判斷對應(yīng)連線中的表達(dá)式走對應(yīng)的流程節(jié)點路線。見工程操作9.并行網(wǎng)關(guān)十字圖標(biāo)對應(yīng)圖標(biāo)中的ParallelGateway并行網(wǎng)關(guān)不需要指定連線的表達(dá)式，當(dāng)流程流轉(zhuǎn)到并行任務(wù)時會出發(fā)多個任務(wù)，當(dāng)多個任務(wù)完成后在會將流程