Spring Boot 整合 Camunda 實現工作流

工作流是我們開發企業應用幾乎必備的一項功能，工作流引擎發展至今已經有非常多的產品。最近正好在接觸Camunda，所以來做個簡單的入門整合介紹。如果您也剛好在調研或者剛開始計劃接入，希望本文對您有所幫助。如果您是一名Java開發或Spring框架愛好者，歡迎關注我程序猿DD，持續非常技術乾貨。

Camunda簡介

Camunda是一個靈活的工作流和流程自動化框架。其核心是一個運行在Java虛擬機內部的原生BPMN 2.0流程引擎。它可以嵌入到任何Java應用程序和任何運行時容器中。

官網網站: https://www.camunda.org/
入門文檔: https://docs.camunda.org/get-started/

動手整合Camunda

下面就來一步步動手嘗試一下吧。

準備工作

使用Camunda提供的項目初始化工具Camunda Automation Platform 7 Initializr

如上圖，包名之類的根據自己需要做好配置，最後輸入管理賬號和密碼，點擊Generate Project按鈕，自動下載工程。

解壓下載後的工程，使用IntelliJ IDEA打開，其項目結構

打開pom.xml文件，添加camunda依賴：

<dependency>
    <groupId>org.camunda.connect</groupId>
    <artifactId>camunda-connect-core</artifactId>
</dependency>

<dependency>
    <groupId>org.camunda.bpm</groupId>
    <artifactId>camunda-engine-plugin-connect</artifactId>
</dependency>

由於Camunda Automation Platform 7 Initializr默認的Spring Boot版本已經是3.1了，所以如果要做一些降級調整，可以手工修改pom.xml中dependencyManagement配置，比如下面這樣：

<dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-dependencies</artifactId>
        <version>2.6.4</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>

      <dependency>
        <groupId>org.camunda.bpm</groupId>
        <artifactId>camunda-bom</artifactId>
        <version>7.15.0</version>
        <scope>import</scope>
        <type>pom</type>
      </dependency>
    </dependencies>
</dependencyManagement>

打開配置文件application.yaml，可以看到類似下面的內容

spring.datasource.url: jdbc:h2:file:./camunda-h2-database

camunda.bpm.admin-user:
  id: transduck
  password: 111111

spring.datasource.url：工作流引擎使用的數據庫配置，您也可以根據官網文檔去調整到其他數據庫中（尤其生產環境）。
camunda.bpm.admin-user：管理員賬戶配置，可以在這裏修改用戶名和密碼

創建一個簡單的工作流

下面我們嘗試創建一個簡單的工作流：

第一步，我們將請求用戶提供兩個輸入：name和message
第二步，我們將這些輸入傳遞給我們的服務以創建消息輸出

開始編碼：

創建第一步提到的數據模型

public class model {
    
    private String message;
    private String name;
    
    public model() { }
    
    public String getMessage() {
        return message;
    }
    
    public void setMessage(String message) {
        this.message = message;
    }
    
    public String getName() {
        return name;
    }
    
    public void setName(String name) {
        this.name = name;
    }
    
    @Override
    public String toString() {
        return "" + message + ", " + name;
    }
}

根據第二步，創建接收消息的接口

@RequestMapping("/")
@RestController
public class controller {

    Logger logger = Logger.getLogger(this.getClass().getName());

    @PostMapping("/message")
    public model createMessage(@RequestBody model model) {
        logger.info("-------Message Creator Initialized-------");

        model m = new model();
        m.setMessage(model.getMessage());
        m.setName(model.getName());

        logger.info("Message created --> " + m.toString());
        return m;
    }
}