Activiti工作流詳解完整教程.doc

Activiti教程詳解完整教程1. Activiti介紹Activiti是由Alfresco軟件在2010年5月17日發(fā)布的業(yè)務(wù)流程管理(BPM)框架,它是覆蓋了業(yè)務(wù)流程管理，工作流，服務(wù)協(xié)作等領(lǐng)域的一個(gè)開源，靈活的，易擴(kuò)展的可執(zhí)行流程語言框架。Activiti基于Apache許可的開源BPM平臺(tái)，創(chuàng)始人Tom Baeyens是JBoss JBPM的項(xiàng)目架構(gòu)師，它的特色是提供了eclipse插件，開發(fā)人員可以通過插件直接繪畫出業(yè)務(wù)流程圖。1.1 工作流引擎ProcessEngine對(duì)象，這是Activiti工作的核心。負(fù)責(zé)生成流程運(yùn)行時(shí)的各種實(shí)例及數(shù)據(jù)，監(jiān)控和管理流程的運(yùn)行。1.2 BPMN業(yè)務(wù)流程建模與標(biāo)注（Business Process Model and Notation,BPMN），描述流程的基本符號(hào)，包括這些圖元如何組合成一個(gè)業(yè)務(wù)流程圖(Business Process Diagram)2. 準(zhǔn)備環(huán)境2.1 Activiti軟件環(huán)境1) JDK1.6或者更高版本2) 支持的數(shù)據(jù)庫有:h2,mysql,oracle,mysql,db2等3) 支持Activiti運(yùn)行的jar包，可以通過maven依賴引入4) 開發(fā)環(huán)境為Eclipse3.7或者以上版本，myeclipse為8.6版本2.2安裝流程設(shè)計(jì)器(eclipse插件)1）打開Help Install New Software Add 輸入 Name: Activiti Designer Location: http:/A/designer/update/輸入完成后，單擊OK按鈕等待下載完成后安裝。安裝完成后在菜單選項(xiàng)中會(huì)出現(xiàn)Activiti的目錄選項(xiàng)2.3 設(shè)置eclipse activit插件的畫流程圖 選項(xiàng)打開菜單Windows - Preferences - Activiti -Save 下流程圖片的生成方式勾選上Create process definition image when saving the diagram操作，勾選上這個(gè)操作后在畫流程圖后保存eclipse會(huì)自動(dòng)生成對(duì)應(yīng)的流程圖片。2.4 準(zhǔn)備開發(fā)環(huán)境2.4.1 創(chuàng)建maven web項(xiàng)目，在maven中添加Activiti依賴在eclipse左邊工作欄右鍵New選擇創(chuàng)建Maven Project項(xiàng)目，創(chuàng)建一個(gè)名為ActivitiTest的項(xiàng)目點(diǎn)擊Finish完成。右鍵項(xiàng)目選擇Properties，選擇Project Facets 勾選上圖中的選項(xiàng)，點(diǎn)擊Apply，再點(diǎn)擊OK然后將項(xiàng)目轉(zhuǎn)換成web項(xiàng)目,右鍵項(xiàng)目選擇Properties,在Project Facets中做如下勾選,然后點(diǎn)擊Appy應(yīng)用和OK確定然后右鍵項(xiàng)目Properties ，選擇Deployment Assembly,將test相關(guān)目錄Remove掉之保留main下面需要發(fā)布的內(nèi)容，如下圖然后點(diǎn)擊Appply和OK然后在pom.xml文件中添加以下依賴org.ActivitiActiviti-engine5.21.0org.ActivitiActiviti-spring5.21.0org.codehaus.groovygroovy-all2.4.3org.slf4jslf4j-api1.7.6org.slf4jslf4j-jdk141.7.6junitjunit3.8.1testmysqlmysql-connector-java5.1.38然后在命令行下mvn compile 編譯當(dāng)前項(xiàng)目，將需要的包下載到本地倉庫2.4.2 初始化數(shù)據(jù)庫1）src/main/resource目錄下創(chuàng)建Activiti.cfg.xml文件,內(nèi)容如下 jdbcUrl為你電腦數(shù)據(jù)庫的urljdbcUsername為數(shù)據(jù)庫用戶名jdbcPassword為數(shù)據(jù)庫密碼2)在main/java目錄下創(chuàng)建任意目錄和類編寫創(chuàng)建Activiti數(shù)據(jù)表方法public class CreateTable /* * 創(chuàng)建流程表 * */Testpublic void createTable() ProcessEngine processEngine = ProcessEngineConfiguration.createProcessEngineConfigurationFromResource(Activiti.cfg.xml).buildProcessEngine();System.out.println(-processEngine: + processEngine); 然后運(yùn)行該測試方法，如果運(yùn)行成功，在數(shù)據(jù)庫中應(yīng)該會(huì)產(chǎn)生25張Activiti的相關(guān)數(shù)據(jù)表2.4.3 Activiti表說明下面是概括了幾個(gè)常用的數(shù)據(jù)表流程部署相關(guān)表act_re_deployement 部署對(duì)象表act_rep_procdef 流程定義表act_ge_bytearray 資源文件表act_ge_prperty 主鍵生成策略表（對(duì)于部署對(duì)象表的主鍵ID）流程實(shí)例相關(guān)表act_ru_execution 正在執(zhí)行的執(zhí)行對(duì)象表（包含執(zhí)行對(duì)象ID和流程實(shí)例ID，如果有多個(gè)線程可能流程實(shí)例ID不一樣）act_hi_procinst 流程實(shí)例歷史表act_hi_actinst 存放歷史所有完成的任務(wù)Task 任務(wù)相關(guān)表act_ru_task 代辦任務(wù)表 （只對(duì)應(yīng)節(jié)點(diǎn)是UserTask的）act_hi_taskinst 代辦任務(wù)歷史表 （只對(duì)應(yīng)節(jié)點(diǎn)是UserTask的）act_hi_actinst 所有節(jié)點(diǎn)活動(dòng)歷史表 （對(duì)應(yīng)流程的所有節(jié)點(diǎn)的活動(dòng)歷史，從開始節(jié)點(diǎn)一直到結(jié)束節(jié)點(diǎn)中間的所有節(jié)點(diǎn)的活動(dòng)都會(huì)被記錄）流程變量表act_ru_variable 正在執(zhí)行的流程變量表act_hi_variable 流程變量歷史表3.核心API3.1 ProcessEngine說明:1) 在Activiti中最核心的類，其他的類都是由他而來。2) 產(chǎn)生方式ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();3）可以產(chǎn)生RepositoryService RepositoryService repositoryService =processEngine.getRepositoryService();4) 可以產(chǎn)生 RuntimeServiceRuntimeService runtimeService = processEngine.getRuntimeService();5) 可以產(chǎn)生TaskServiceTaskService taskService =processEngine.getTaskService();各個(gè)Service的作用RepositoryService管理流程定義RuntimeService執(zhí)行管理，包括啟動(dòng)，推進(jìn)，刪除流程實(shí)例等操作TaskService任務(wù)管理3.2 RepositoryServiceActiviti的倉庫服務(wù)類。所謂的倉庫指流程定義文檔的兩個(gè)文件：bpmn文件和流程圖片該service可以用來刪除部署的流程定義。3.3 RuntimeService是Activiti的流程執(zhí)行服務(wù)類，可以從這個(gè)服務(wù)類中獲取很多關(guān)于流程執(zhí)行的相關(guān)的信息。3.4 TaskService是Activiti的任務(wù)服務(wù)類?？梢詮倪@個(gè)類中獲取任務(wù)的相關(guān)信息，如當(dāng)前正在執(zhí)行的個(gè)人待辦和用戶組待辦任務(wù)。3.5 HistoryService是Activiti的查詢歷史信息的類，在一個(gè)流程執(zhí)行完成后，這個(gè)對(duì)象為我們提供查詢歷史信息，可以跟蹤流程實(shí)例對(duì)應(yīng)所有待辦節(jié)點(diǎn)的運(yùn)行情況。3.6 ProcessDefinition流程定義類，可以從這里獲得資源文件等。3.7 ProcessInstance代表流程定義的執(zhí)行實(shí)例，當(dāng)一個(gè)部署的流程圖啟動(dòng)后，該流程只有一條流程實(shí)例數(shù)據(jù)，但是它的流程任務(wù)可以有多個(gè)，每個(gè)任務(wù)對(duì)應(yīng)流程圖中相應(yīng)的流程節(jié)點(diǎn)。4.入門HelloWorld程序4.1創(chuàng)建流程圖方法點(diǎn)擊ActivitiTest項(xiàng)目，在src/main/java目錄下創(chuàng)建一個(gè)diagrams目錄用來存放流程圖在當(dāng)前項(xiàng)目右鍵選擇Activiti Diagram流程圖輸入流程圖名稱HelloWorld，然后點(diǎn)擊OK，在控制面板的右邊欄有相關(guān)的畫圖圖標(biāo)操作其中一個(gè)流程必須包含一個(gè)開始節(jié)點(diǎn)和一個(gè)結(jié)束節(jié)點(diǎn)，結(jié)束節(jié)點(diǎn)可以有多個(gè)。然后使用StartEvent, UserTask,EndEvent畫出下面的流程圖，然后用Connection中的SequenceFlow連線連接起來。4.2創(chuàng)建流程圖，如下圖4.3 指定流程圖名稱，ID和UserTask的處理人1）選中第一個(gè)節(jié)點(diǎn)，在 General中的name屬性中輸入當(dāng)前節(jié)點(diǎn)的名稱,在Main config中的Assignee中輸入該節(jié)點(diǎn)的處理人，然后以此類推將3個(gè)節(jié)點(diǎn)的值設(shè)置完成。，2）然后在流程圖旁邊的空白出點(diǎn)擊一下，輸入流程的ID和Name值，然后保存4.4 將流程圖部署到Activiti的數(shù)據(jù)表中啟動(dòng)完成后在act_re_deployment流程部署表和act_re_procdef流程定義表中會(huì)有對(duì)應(yīng)的數(shù)據(jù)信息.4.5 啟動(dòng)流程實(shí)例其中runtimeService.startProcessInstanceByKey(HelloWorldKey);中的HelloWorldKey對(duì)應(yīng)流程圖中的ID值,在數(shù)據(jù)表中對(duì)應(yīng)act_re_procdef流程定義表中的key字段啟動(dòng)完流程后在act_ru_execution表中會(huì)產(chǎn)生一條數(shù)據(jù)，這條數(shù)據(jù)為當(dāng)前流程正在執(zhí)行的任務(wù)，其中act_id_字段的值對(duì)應(yīng)流程圖節(jié)點(diǎn)的ID值在act_ru_task表中會(huì)產(chǎn)生一條任務(wù)數(shù)據(jù),execution_id_對(duì)應(yīng)act_ru_execution主鍵，proc_inst_id_為流程實(shí)例ID，name_值為流程節(jié)點(diǎn)名稱，assignee_字段為該待辦當(dāng)前的處理人4.6 查詢待辦任務(wù)指定查詢張三的待辦，可以查詢出待辦為第一個(gè)節(jié)點(diǎn)的處理任務(wù)。4.7 完成待辦任務(wù)其中taskId對(duì)應(yīng)act_ru_task表的主鍵ID，因?yàn)楫?dāng)前待辦任務(wù)為第一個(gè)節(jié)點(diǎn)提交申請(qǐng)，當(dāng)執(zhí)行完這個(gè)待辦后下一條待辦數(shù)據(jù)將會(huì)流轉(zhuǎn)到審批【部門經(jīng)理】那，然后以此類推可以將部門經(jīng)理和總經(jīng)理的待辦任務(wù)全部查詢和執(zhí)行完成。5.查詢和刪除流程定義1）查詢流程定義2) 刪除流程定義6.流程變量操作6.1 設(shè)置流程變量1）設(shè)置流程變量有多種方式，可以在流程啟動(dòng)，和任務(wù)執(zhí)行的時(shí)候設(shè)置a.啟動(dòng)流程的時(shí)候設(shè)置b. 通過taskService或者runtimeService設(shè)置提示：如果設(shè)置的流程變量值是一個(gè)對(duì)象類型，這個(gè)對(duì)象必須實(shí)現(xiàn)序列化Serializable操作,并且要為該對(duì)象類指定一個(gè) 版本ID6.2 獲取流程變量見工程操作7.流程連線在畫流程圖的時(shí)候可以對(duì)流程的連線設(shè)置表達(dá)式，然后在執(zhí)行的時(shí)候設(shè)置流程變量值，然后Activiti會(huì)根據(jù)對(duì)應(yīng)的值走對(duì)應(yīng)的節(jié)點(diǎn)點(diǎn)擊一條連線，在Main config中的Condition屬性值中設(shè)置$message=同意，另外一條線設(shè)置為$message=不同意，然后在代碼中設(shè)置對(duì)應(yīng)流程變量值。見工程操作8.排他網(wǎng)關(guān)如下圖,其中黑色的叉叉對(duì)應(yīng)eclipse畫流程圖圖標(biāo)中的ExclusiveGateWay圖標(biāo) 然后對(duì)每條線的Condition屬性指定對(duì)應(yīng)的表達(dá)式，然后在執(zhí)行任務(wù)時(shí)候設(shè)置對(duì)應(yīng)的流程變量Activiti會(huì)根據(jù)變量的值來判斷對(duì)應(yīng)連線中的表達(dá)式走對(duì)應(yīng)的流程節(jié)點(diǎn)路線。見工程操作9.并行網(wǎng)關(guān)十字圖標(biāo)對(duì)應(yīng)圖標(biāo)中的ParallelGateway并行網(wǎng)關(guān)不需要指定連線的表達(dá)式，當(dāng)流程流轉(zhuǎn)到并行任務(wù)時(shí)會(huì)出發(fā)多個(gè)任務(wù)，當(dāng)多個(gè)任務(wù)完成后在會(huì)將流程流轉(zhuǎn)到下一個(gè)節(jié)點(diǎn)見工程操作10.個(gè)人任務(wù)的三種指定方式10.1 在Assignee中指定任務(wù)具體的處理人10.2 在Assignee中指定任務(wù)的處理人或角色變量當(dāng)指定Assignee為一個(gè)變量值后需要在代碼中設(shè)置對(duì)應(yīng)的處理人，比如在啟動(dòng)的時(shí)候設(shè)置userId的值在工程中可以將起草人的處理變量設(shè)置為userId，審批人的處理變量設(shè)置為appUserId，然后通過業(yè)務(wù)模塊和登錄人來獲取對(duì)應(yīng)模塊的審批人。10.3 為任務(wù)節(jié)點(diǎn)設(shè)置一個(gè)監(jiān)聽類來設(shè)置當(dāng)前節(jié)點(diǎn)的處理人如果設(shè)置了監(jiān)聽類就不需要在設(shè)置Assignee的值1）創(chuàng)建一個(gè)監(jiān)聽器類，需要實(shí)現(xiàn)TaskListener接口2) 點(diǎn)擊任務(wù)節(jié)點(diǎn)，選擇Listener選項(xiàng)卡，點(diǎn)擊New ，將Event的值改為create然后選擇創(chuàng)建的TaskListenerImpl實(shí)現(xiàn)類然后當(dāng)任務(wù)到達(dá)該節(jié)點(diǎn)后Acti