Activiti如何動態獲取流程圖過程詳解
本文中使用的activiti版本是5.22.0
一、繪圖原理
activiti中提供了一個可以用來繪製流程圖的類DefaultProcessDiagramGenerator,這個類在5.22.0及以上的版本中
是以一個單獨jar包的方式提供的,所以還需要引入相應的依賴。
<dependency> <groupId>org.activiti</groupId> <artifactId>activiti-image-generator</artifactId> <version>5.22.0</version> </dependency>
使用時先建立這個類的物件,
//這個類在5.22.0往上的版本中才有 DefaultProcessDiagramGenerator diagramGenerator=new DefaultProcessDiagramGenerator();
然後呼叫畫圖方法
diagramGenerator.generateDiagram(bpmnModel,imageType,highLightedActivities);
其中的幾個引數:
bpmnModel:當前流程對應的流程模型,可以通過repositoryService.getBpmnModel(processDefinitionId)獲取
imageType:圖片型別,jpg,png等
highLightedActivities:需要高亮顯示的節點的id
二、根據流程定義id繪圖
根據流程定義表act_re_procdef的主鍵id繪圖,這時可以沒有流程,只要流程圖成功部署了就會產生act_re_procdef表的記錄。所以也就不存在節點高亮的問題,因為這個圖和流程例項無關。
@Test public void test1() throws Exception { //根據流程定義id來獲取BpmnModel物件 String processDefinitionId="process:2:4304"; BpmnModel bpmnModel = repositoryService.getBpmnModel(processDefinitionId); //這個類在5.22.0往上的版本中才有 DefaultProcessDiagramGenerator diagramGenerator=new DefaultProcessDiagramGenerator(); //繪製bpmnModel代表的流程的流程圖 InputStream inputStream = diagramGenerator.generateDiagram(bpmnModel,"png",new ArrayList<String>()); FileOutputStream output=new FileOutputStream(new File("d:/test.png")); IOUtils.copy(inputStream,output); System.out.println("輸出完成"); }
注意這裡generateDiagram()方法的第3個引數傳了一個空list,這個list表示要高亮顯示的節點的id集合。也就是流程圖中每一個任務的id
三、根據流程例項id繪圖
3.1 基本原理
上面已經實現了根據processDefinitionId畫圖。根據processInstanceId畫圖時,其實是先根據processInstanceId查詢到對應的流程例項物件ProcessInstance,
然後通過流程例項物件獲取到processDefinitionId,使用其中的get方法processInstance.getProcessDefinitionId()
再想辦法獲取到需要高亮顯示的節點的id:當前節點+走過的節點。
3.2 當前節點的獲取
使用runtimeService服務元件的方法來獲取
String executionId=processInstance.getId(); List<String> activeActivityIds = runtimeService.getActiveActivityIds(executionId);
activeActivityIds這個list就是當前節點的id集合,如果是並行流程會有多個,其他情況只有一個。
3.3 走過的節點的獲取
走過的節點需要從activiti的歷史行為表act_hi_actinst中獲取。流程的行為資料記錄在該表中,當流程進行到一個節點時,該表中會記錄流程節點的資訊,包括節點id,名稱等。其中有一個ACT_ID_就代表流程圖上對應節點的id
也就是需要高亮顯示的節點id
所以我們要做的就是從這張表中查詢到這個資料。activiti已經提供了查詢這張表的api,可以通過historyService這個服務元件來獲取
//得到已經走過的節點的id集合 HistoricActivityInstanceQuery historicActivityInstanceQuery = historyService.createHistoricActivityInstanceQuery(); List<HistoricActivityInstance> historicActivityInstanceList = historicActivityInstanceQuery.processInstanceId(processInstanceId).list(); for(HistoricActivityInstance hi:historicActivityInstanceList) { String taskKey=hi.getActivityId(); activeActivityIds.add(taskKey); }
以上程式碼先查詢出ACT_ID_,再把它們新增到需要高亮顯示的集合activeActivityIds中
3.4 繪圖
DefaultProcessDiagramGenerator defaultProcessDiagramGenerator=new DefaultProcessDiagramGenerator(); //獲取流程圖的輸入流 InputStream inputStream = defaultProcessDiagramGenerator.generateDiagram(bpmnModel,activeActivityIds); //輸出圖片到指定路徑 IOUtils.copy(inputStream,new FileOutputStream(new File("d:/test2.png"))); System.out.println("輸出成功");
這樣繪製出的流程圖上已經走過的節點就會被高亮顯示。
四、總結
繪製流程圖的原理是使用DefaultProcessDiagramGenerator類中的方法
這個類在一個單獨的jar中提供,需要新新增依賴
要高亮顯示某些節點,就給畫圖方法中傳入節點id的集合。
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支援我們。