Activiti如何動(dòng)態(tài)獲取流程圖過(guò)程詳解

本文中使用的activiti版本是5.22.0

一、繪圖原理

activiti中提供了一個(gè)可以用來(lái)繪制流程圖的類DefaultProcessDiagramGenerator,這個(gè)類在5.22.0及以上的版本中

是以一個(gè)單獨(dú)jar包的方式提供的，所以還需要引入相應(yīng)的依賴。

<dependency>
  <groupId>org.activiti</groupId>
  <artifactId>activiti-image-generator</artifactId>
  <version>5.22.0</version>
</dependency>

使用時(shí)先創(chuàng)建這個(gè)類的對(duì)象，

//這個(gè)類在5.22.0往上的版本中才有
DefaultProcessDiagramGenerator diagramGenerator=new DefaultProcessDiagramGenerator();

然后調(diào)用畫圖方法

diagramGenerator.generateDiagram(bpmnModel, imageType, highLightedActivities);

其中的幾個(gè)參數(shù):

bpmnModel:當(dāng)前流程對(duì)應(yīng)的流程模型，可以通過(guò)repositoryService.getBpmnModel(processDefinitionId)獲取

imageType:圖片類型,jpg,png等

highLightedActivities:需要高亮顯示的節(jié)點(diǎn)的id

二、根據(jù)流程定義id繪圖

根據(jù)流程定義表act_re_procdef的主鍵id繪圖，這時(shí)可以沒(méi)有流程，只要流程圖成功部署了就會(huì)產(chǎn)生act_re_procdef表的記錄。所以也就不存在節(jié)點(diǎn)高亮的問(wèn)題，因?yàn)檫@個(gè)圖和流程實(shí)例無(wú)關(guān)。

  @Test
  public void test1() throws Exception {
    
    //根據(jù)流程定義id來(lái)獲取BpmnModel對(duì)象
    String processDefinitionId="process:2:4304";
    BpmnModel bpmnModel = repositoryService.getBpmnModel(processDefinitionId);
    //這個(gè)類在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個(gè)參數(shù)傳了一個(gè)空l(shuí)ist，這個(gè)list表示要高亮顯示的節(jié)點(diǎn)的id集合。也就是流程圖中每一個(gè)任務(wù)的id

三、根據(jù)流程實(shí)例id繪圖

3.1 基本原理

上面已經(jīng)實(shí)現(xiàn)了根據(jù)processDefinitionId畫圖。根據(jù)processInstanceId畫圖時(shí)，其實(shí)是先根據(jù)processInstanceId查詢到對(duì)應(yīng)的流程實(shí)例對(duì)象ProcessInstance,

然后通過(guò)流程實(shí)例對(duì)象獲取到processDefinitionId，使用其中的get方法processInstance.getProcessDefinitionId()

再想辦法獲取到需要高亮顯示的節(jié)點(diǎn)的id:當(dāng)前節(jié)點(diǎn)+走過(guò)的節(jié)點(diǎn)。

3.2 當(dāng)前節(jié)點(diǎn)的獲取

使用runtimeService服務(wù)組件的方法來(lái)獲取

String executionId=processInstance.getId();
List<String> activeActivityIds = runtimeService.getActiveActivityIds(executionId);

activeActivityIds這個(gè)list就是當(dāng)前節(jié)點(diǎn)的id集合，如果是并行流程會(huì)有多個(gè)，其他情況只有一個(gè)。

3.3 走過(guò)的節(jié)點(diǎn)的獲取

走過(guò)的節(jié)點(diǎn)需要從activiti的歷史行為表act_hi_actinst中獲取。流程的行為數(shù)據(jù)記錄在該表中，當(dāng)流程進(jìn)行到一個(gè)節(jié)點(diǎn)時(shí)，該表中會(huì)記錄流程節(jié)點(diǎn)的信息，包括節(jié)點(diǎn)id，名稱等。其中有一個(gè)ACT_ID_就代表流程圖上對(duì)應(yīng)節(jié)點(diǎn)的id

也就是需要高亮顯示的節(jié)點(diǎn)id

所以我們要做的就是從這張表中查詢到這個(gè)數(shù)據(jù)。activiti已經(jīng)提供了查詢這張表的api,可以通過(guò)historyService這個(gè)服務(wù)組件來(lái)獲取

//得到已經(jīng)走過(guò)的節(jié)點(diǎn)的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("輸出成功");

這樣繪制出的流程圖上已經(jīng)走過(guò)的節(jié)點(diǎn)就會(huì)被高亮顯示。

四、總結(jié)

繪制流程圖的原理是使用DefaultProcessDiagramGenerator類中的方法

這個(gè)類在一個(gè)單獨(dú)的jar中提供，需要新添加依賴

要高亮顯示某些節(jié)點(diǎn)，就給畫圖方法中傳入節(jié)點(diǎn)id的集合。

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持億速云。