Spring Boot

Этот раздел перенесён из документации Camunda 7 и в дальнейшем будет доработан с учётом особенностей OpenBPM Engine

Интеграция OpenBPM Engine в Spring Boot позволяет использовать движок напрямую в вашем приложении. Для этого выполните следующие шаги.

Требования

Перед началом убедитесь, что у вас установлено:

Java 17 или выше
Maven 3.8+ или Gradle 7+
Spring Boot версии 3.4.x (или совместимой)
СУБД (например PostgreSQL, H2 для разработки)

Для корректной работы Spring Boot проекта с OpenBPM Engine необходимо подключить следующие зависимости:

spring-boot-starter-web — стартер для создания веб-приложений
spring-boot-starter-jdbc — стартер для работы с базой данных
Реляционная база данных, например H2 для тестирования и разработки

Пример для Gradle:

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.boot:spring-boot-starter-jdbc'

    runtimeOnly 'com.h2database:h2'
}

Пример для Maven:

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-jdbc</artifactId>
    </dependency>
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

Процедура установки

Добавьте репозиторий OpenBPM:

Для Maven:

<repositories>
  <repository>
    <id>openbpm</id>
    <url>https://nexus.openbpm.ru/repository/releases</url>
  </repository>
</repositories>

Для Gradle:

repositories {
    mavenCentral()
    maven {
        url "https://nexus.openbpm.ru/repository/releases"
    }
}

Подключите необходимые зависимости:

Для Maven

<dependencies>
  <!-- OpenBPM Engine -->
  <dependency>
    <groupId>io.openbpm.bpm.springboot</groupId>
    <artifactId>openbpm-engine-bpm-spring-boot-starter</artifactId>
    <version>2025.0.0</version>
  </dependency>

  <!-- Встроенный Webapp -->
  <dependency>
    <groupId>io.openbpm.bpm.springboot</groupId>
    <artifactId>openbpm-engine-bpm-spring-boot-starter-webapp</artifactId>
    <version>2025.0.0</version>
  </dependency>

  <!-- REST API -->
  <dependency>
    <groupId>io.openbpm.bpm.springboot</groupId>
    <artifactId>openbpm-engine-bpm-spring-boot-starter-rest</artifactId>
    <version>2025.0.0</version>
  </dependency>
</dependencies>

Для Gradle

dependencies {
    // OpenBPM Engine
    implementation "io.openbpm.bpm.springboot:openbpm-engine-bpm-spring-boot-starter:2025.0.0"

    // Встроенный Webapp
    implementation "io.openbpm.bpm.springboot:openbpm-engine-bpm-spring-boot-starter-webapp:2025.0.0"

    // REST API
    implementation "io.openbpm.bpm.springboot:openbpm-engine-bpm-spring-boot-starter-rest:2025.0.0"
}

Добавьте базовую конфигурацию в src/main/resources/application.properties:

# Настройки Spring Boot
spring.application.name=openbpm-engine-spring-boot-sample

# Настройки сервера
server.port=8080

# Настройки источника данных
spring.datasource.url=jdbc:h2:file:./h2/openbpm-engine-h2-database
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=password

spring.jpa.database-platform=org.hibernate.dialect.H2Dialect

# Настройки OpenBPM Engine
openbpm.bpm.admin-user.id=demo
openbpm.bpm.admin-user.password=demo

openbpm.bpm.auto-deployment-enabled=true
openbpm.bpm.deployment-resource-pattern=classpath*:*.bpmn, classpath*:*.form, classpath*:*.dmn

Запуск проекта

Для Maven:
```
mvn spring-boot:run
```
Для Gradle:
```
gradle bootRun
```
Веб-интерфейс доступен по адресу: http://localhost:8080

Дополнительную информацию по работе с встроенным OpenBPM Engine в Spring Boot приложении, вы можете получить в руководстве пользователя Spring Boot.

Лицензия и атрибуция

Эта документация была создана на базе материала "Camunda 7 Docs" от Camunda, находится под лицензией Creative Commons Attribution-ShareAlike 3.0 Unported License .

Оригинал документации: https://docs.camunda.org