Activiti流程檔案部署過程解析
用bpmn規範定義好一個流程得到流程定義檔案後,需要把該檔案部署到activiti的資料庫後,這個流程才可以使用。
activiti中和流程定義相關的操作都需要使用RepositoryService這個服務元件來進行。
activiti中所有的服務元件都需要通過流程引擎物件來獲取
一、RepositoryService服務元件
這個元件中提供了一系列管理流程定義和流程部署的api,我們可以使用這個元件中的api來部署流程
1.1 RepositoryService例項物件的獲取
使用流程引擎物件的例項方法processEngine.getRepositoryService();來獲取RepositoryService
@Test public void test1() { ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine(); RepositoryService repositoryService = processEngine.getRepositoryService(); System.out.println(repositoryService); }
二、流程部署資訊的描述,Deployment物件
在講解如何部署流程前,我們先了解下activiti如何描述流程的部署資訊。activiti用Deployment這個介面來描述流程的部署資訊,並自己提供了實現類。對應activiti資料庫中的一張表ACT_RE_DEPLOYMENT
三、流程的部署
activiti使用DeploymentBuilder這個類的物件來部署流程,從這個類的名字就可以看出它的功能,部署一個流程並返回描述這次部署資訊的物件。
使用RepositoryService服務元件的物件來獲取DeploymentBuilder物件
DeploymentBuilder deploymentBuilder = repositoryService.createDeployment();
然後給這個deploymentBuilder新增要部署的流程檔案的位置
deploymentBuilder.addClasspathResource("process/process.bpmn");
我這裡是在resources目錄下建立了process/process.bpmn流程定義檔案,所以添加了這個路徑
還可以為本次部署新增名稱和分類
deploymentBuilder.name("vacation-test").category("test");
最後執行部署
Deployment deploy = deploymentBuilder.deploy();
觀察資料庫ACT_RE_DEPLOYMENT表,會發現多了一條部署記錄。
完整的程式碼為
@Test public void test1() { ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine(); RepositoryService repositoryService = processEngine.getRepositoryService(); DeploymentBuilder deploymentBuilder = repositoryService.createDeployment(); deploymentBuilder.addClasspathResource("process/process.bpmn"); deploymentBuilder.name("vacation-test").category("test"); Deployment deploy = deploymentBuilder.deploy(); System.out.println(deploy); }
注意,預設情況下多次部署同一流程圖在表中會產生多條記錄,用部署時間欄位用來做區分
3.1 過濾重複部署的問題
為了防止資源沒有發生變化而再次執行部署方法產生的重複部署,可以呼叫DeploymentBuilder的enableDuplicateFiltering()方法,這裡的過濾方式是先查詢部署表,得到表中已有的部署物件集合,如果發現有一條部署記錄與將要部署的物件相同,就不會重複部署。所以部署時設定的name,category,資源名稱和內容,只要有一個不一樣就不會被過濾掉
deploymentBuilder.enableDuplicateFiltering();//設定過濾重複部署
四、部署資訊的管理
activiti在DeploymentQuery這個介面中封裝了管理部署資訊的api,並自己提供了實現類,通過repositoryService服務元件來獲取其實現類物件。
DeploymentQuery deploymentQuery = repositoryService.createDeploymentQuery();
4.1 查詢部署資訊
@Test public void test2() { ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine(); RepositoryService repositoryService = processEngine.getRepositoryService(); DeploymentQuery deploymentQuery = repositoryService.createDeploymentQuery(); //根據deploymentId查詢 String deploymentId="4201"; Deployment singleResult = deploymentQuery.deploymentId(deploymentId) .deploymentName("vacation-test").singleResult(); System.out.println(singleResult); }
查詢時,先給deploymentQuery物件拼接查詢條件,這裡支援鏈式程式設計,先一個個的拼接查詢條件,最後這個
singleResult()方法執行查詢,返回一個結果;如果根據設定的條件返回多個結果,呼叫singleResult()就會丟擲異常,這時需要呼叫返回多個結果的查詢方法list()
4.2 刪除部署資訊
因為部署資訊表與其他表有外來鍵關聯,所以直接刪除部署表中的資料是刪不掉的,需要呼叫RepositoryService中的刪除方法來刪除
@Test public void test3() { ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine(); RepositoryService repositoryService = processEngine.getRepositoryService(); String deploymentId="4201"; boolean cascade=true; repositoryService.deleteDeployment(deploymentId,cascade); }
其中第2個引數cascade表示是否級聯刪除其他表的資料,直接給true就可以
五、流程定義及其管理
5.1 流程定義資訊的描述
一個流程檔案部署成功後,不僅會在部署表中記錄部署資訊,同時也會在流程定義表act_re_procdef中新增一條流程定義資訊,描述被部署的流程檔案所定義的流程。
注意其中的這個KEY_欄位對應的就是流程定義檔案中的process節點的id,activiti開啟流程時要使用這個欄位。
<process id="process" isExecutable="true"> <startEvent id="sid-26F630F1-0761-4247-8383-F63F913A310E"></startEvent> <userTask id="usertask1" name="apply vecation" activiti:assignee="kermit"></userTask> <sequenceFlow id="sid-85398367-B674-473A-B7AC-268635F0DF5D" sourceRef="sid-26F630F1-0761-4247-8383-F63F913A310E" targetRef="usertask1"></sequenceFlow> <userTask id="usertask2" name="manager agree" activiti:assignee="kermit"></userTask> <sequenceFlow id="sid-5372C6B1-7359-40AB-B0A4-3FF06F20790E" sourceRef="usertask1" targetRef="usertask2"></sequenceFlow> <endEvent id="sid-F621C8EF-13A5-4A49-BD5B-708BFB066576"></endEvent> <sequenceFlow id="sid-BCF9087D-36F4-4EDE-BD88-013AC74AB93A" sourceRef="usertask2" targetRef="sid-F621C8EF-13A5-4A49-BD5B-708BFB066576"></sequenceFlow> </process>
和部署資訊一樣,activiti也有一個介面來描述這張表的資訊,ProcessDefinition,並自己提供了實現類
5.2 流程定義資訊的管理
activiti提供了ProcessDefinitionQuery這個介面,在其中封裝了流程定義資訊查詢相關的api。查詢物件的獲取和使用與DeploymentQuery類似。
@Test public void test1() { ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine(); RepositoryService repositoryService = processEngine.getRepositoryService(); ProcessDefinitionQuery processDefinitionQuery = repositoryService.createProcessDefinitionQuery(); String processDefinitionKey="process"; List<ProcessDefinition> list = processDefinitionQuery.processDefinitionKey(processDefinitionKey).list(); for (ProcessDefinition processDefinition : list) { System.out.println(processDefinition); } }
六、總結
本文介紹瞭如何部署流程定義檔案,以及對部署後生成的部署資訊和流程定義資訊的管理。
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支援我們。