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

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