1. 程式人生 > 程式設計 >Activiti流程檔案部署過程解析

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流程檔案部署過程解析

三、流程的部署

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中新增一條流程定義資訊,描述被部署的流程檔案所定義的流程。

Activiti流程檔案部署過程解析

注意其中的這個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);
    }
  }

六、總結

本文介紹瞭如何部署流程定義檔案,以及對部署後生成的部署資訊和流程定義資訊的管理。

以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支援我們。