Skip to content

README.md

Latest commit

 

History

History
50 lines (35 loc) · 1.69 KB

README.md

File metadata and controls

50 lines (35 loc) · 1.69 KB

Spring Boot Web application with Camunda Webapps

This example demonstrates how you can build Spring Boot Web application having following configured:

  • Embedded Camunda engine
  • Camunda web applications automatically deployed
  • Process application and one BPMN process deployed
  • Admin user configured with login and password configured in application.yaml

It also contains a simple integration test, showing how this can be tested.

Prerequisites

  • Java 17/21

How is it done

  1. To embed Camunda Engine with webapps you must add following dependency to your pom.xml:
...
<dependency>
  <groupId>org.camunda.bpm.springboot</groupId>
  <artifactId>camunda-bpm-spring-boot-starter-webapp</artifactId>
  <version>7.24.0</version>
</dependency>
...
  1. With Spring Boot you usually create an "application" class annotated with @SpringBootApplication. In order to have a Camunda process application registered, you can simply add an annotation @EnableProcessApplication to the same class and also include a processes.xml file in your META-INF folder:
@SpringBootApplication
@EnableProcessApplication
public class WebappExampleApplication {

  public static void main(String... args) {
    SpringApplication.run(WebappExampleApplication.class, args);
  }
}
  1. You can also put BPMN, CMMN and DMN files in your classpath, they will be automatically deployed and registered within a process application.

Run the application and use Camunda Webapps

You can build the application with mvn clean install and then run it with java -jar command.

Then you can access Camunda Webapps in browser: http://localhost:8080 (provide login/password from application.yaml, default: demo/demo)