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 to your pom.xml:

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

2. 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);
  }
}

3. 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)