example-webapp

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.

How is it done

1. To embed Camunda Engine with webapps you must add following dependency in your pom.xml:

...
<dependency>
  <groupId>org.camunda.bpm.springboot</groupId>
  <artifactId>camunda-bpm-spring-boot-starter-webapp</artifactId>
  <version>2.3.0-SNAPSHOT</version>
</dependency>
...

2. With Spring Boot you usually create "application" class annotated with @SpringBootApplication. In order to have Camunda process application registered, you can simply add annotation @EnableProcessApplication to the same class and also include processes.xml file in your META-INF folder:

@SpringBootApplication
@EnableProcessApplication
public class WebappExampleApplication {

  public static void main(String... args) {
    SpringApplication.run(WebappExampleApplication.class, args);
  }
}

3. You can also put BPMN, CMMN and DMN files in your classpath, they will be automatically deployed and registered within process application.

Run the application and use Camunda Webapps

You can build the application by calling 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)