Activiti 5.21.0 開發環境搭建指南：Maven 項目創建、依賴導入與配置文件詳解

Activiti 5.21.0 開發環境搭建指南：Maven 項目創建、依賴導入與配置文件詳解

一、 創建 Maven 項目

標準 Java/Web 項目結構，勾選 Generate web.xml，確保 src/main/webapp 為部署根目錄。

二、 導入核心依賴

1. 解壓 activiti-5.21.0，從 activiti-rest/WEB-INF/lib 複製所有 JAR 到項目 WEB-INF/lib 或 Maven 本地倉庫安裝。
2. 手動添加 MySQL 驅動：mysql-connector-java-5.1.7-bin.jar。

三、 Java 代碼方式配置流程引擎

// 測試類
ProcessEngineConfiguration cfg = ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration();
cfg.setJdbcDriver("com.mysql.jdbc.Driver");
cfg.setJdbcUrl("jdbc:mysql://localhost:3306/activiti?characterEncoding=utf-8");
cfg.setJdbcUsername("root");
cfg.setJdbcPassword("root");
// 自動建表策略
cfg.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
ProcessEngine engine = cfg.buildProcessEngine();

四、 配置文件方式 (activiti.cfg.xml)

從 activiti-rest/WEB-INF/classes 複製模板並修改：

<beans ...>
  <bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
    <property name="jdbcDriver" value="com.mysql.jdbc.Driver"/>
    <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/activiti?characterEncoding=utf-8"/>
    <property name="jdbcUsername" value="root"/>
    <property name="jdbcPassword" value="root"/>
    <property name="databaseSchemaUpdate" value="true"/>
    <!-- 郵件、歷史級別、任務執行器等可選配置 -->
  </bean>
</beans>

五、 測試驗證

// 代碼方式
ProcessEngine engine = ProcessEngines.getDefaultProcessEngine(); // 自動讀取 classpath:activiti.cfg.xml
System.out.println(engine.getName()); // 輸出 "default" 表示成功

// 配置文件方式同理
ProcessEngine engine2 = ProcessEngineConfiguration
    .createProcessEngineConfigurationFromResource("activiti.cfg.xml")
    .buildProcessEngine();

控制台輸出表創建 SQL 及 ProcessEngine [default] created 即成功。

六、 關鍵提示

• 確保 MySQL 已創建 activiti 數據庫（字符集 utf8）。
• databaseSchemaUpdate=true 僅用於開發環境，生產環境建議手動執行 DDL 腳本。
• Activiti 5.x 已進入維護模式，新項目建議考慮 Activiti 7 / Flowable / Camunda。