activiti學習6:啟動流程后動態獲取流程圖
上一篇博客中介紹了activiti如何開啟流程和讓流程前進，這次來學習下如何動態的獲取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, "png", activeActivityIds);
//輸出圖片到指定路徑
IOUtils.copy(inputStream, new FileOutputStream(new File("d:/test2.png")));
System.out.println("輸出成功");
這樣繪制出的流程圖上已經走過的節點就會被高亮顯示。
四、總結
繪制流程圖的原理是使用DefaultProcessDiagramGenerator類中的方法
這個類在一個單獨的jar中提供，需要新添加依賴
要高亮顯示某些節點，就給畫圖方法中傳入節點id的集合。