Skip to main content

​
Requirements

The project requires Java 17/21.

​
Set up a Java project

We start by setting up a Spring Boot application as an Apache Maven project inside Eclipse. This consists of three steps:
  1. Create a new Maven project in Eclipse.
  2. Add the ASEE Flow and Spring Boot dependencies.
  3. Add a main class as an entry point for launching the Spring Boot application.

​
Create a new Maven project

First, set up a new Apache Maven based project. Let’s call it loan-approval-spring-boot. The screenshots below illustrate the settings we choose in Eclipse. Create a new Maven project — page 1 Create a new Maven project — page 2 When you are done, click Finish. Eclipse sets up a new Maven project. The project appears in the Project Explorer view.

​
Add ASEE Flow and Spring Boot dependencies

The next step consists of setting up the Maven dependencies for the new project. Maven dependencies need to be added to the pom.xml file of the project. We add the Spring Boot BOM in the dependency management section and the ASEE Flow Spring Boot Starter for webapps, which automatically includes the ASEE Flow engine and web applications in the app. We also use spring-boot-maven-plugin, which does all the magic for packaging the Spring Boot application content together. 
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>org.camunda.bpm.getstarted</groupId>
  <artifactId>loan-approval-spring-boot</artifactId>
  <version>0.0.1-SNAPSHOT</version>

  <properties>
    <camunda.spring-boot.version>7.24.0</camunda.spring-boot.version>
    <spring-boot.version>3.5.5</spring-boot.version>
    <maven.compiler.release>17</maven.compiler.release>
  </properties>

  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-dependencies</artifactId>
        <version>${spring-boot.version}</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>

  <dependencies>
    <dependency>
      <groupId>org.camunda.bpm.springboot</groupId>
      <artifactId>camunda-bpm-spring-boot-starter-webapp</artifactId>
      <version>${camunda.spring-boot.version}</version>
    </dependency>
    <dependency>
      <groupId>com.h2database</groupId>
      <artifactId>h2</artifactId>
    </dependency>
    <dependency>
      <groupId>com.sun.xml.bind</groupId>
      <artifactId>jaxb-impl</artifactId>
      <version>4.0.3</version>
    </dependency>
  </dependencies>

   <build>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
        <version>${spring-boot.version}</version>
        <configuration>
          <layout>ZIP</layout>
        </configuration>
        <executions>
          <execution>
            <goals>
              <goal>repackage</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.11.0</version>
      </plugin>
    </plugins>
  </build>

</project>

​
Add a main class to the Spring Boot application

Next, add an application class with a main method that will be the entry point for launching the Spring Boot application. The class has the @SpringBootApplication annotation, which implicitly adds several convenient features (autoconfiguration, component scan, and so on — see the Spring Boot docs). The class is added in the src/main/java folder in the org.camunda.bpm.getstarted.loanapproval package. 
package org.camunda.bpm.getstarted.loanapproval;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

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

​
Build and run

Now you can perform the first build. Select the pom.xml in the Package Explorer, right-click, and select Run As > Maven Install. Your first ASEE Flow Spring Boot application is ready. As a result of the build, you will have a JAR file in your target folder. This JAR is a Spring Boot application that embeds Tomcat as a web container, the ASEE Flow engine, and the ASEE Flow web application resources. When started, it uses an in-memory H2 database for the engine’s needs. You can run the application by right-clicking the WebappExampleProcessApplication class and selecting Run As > Java Application. Wait until you see a line like this in the console: 
Started WebappExampleProcessApplication in 10.584 seconds
Then go to http://localhost:8080/ in your browser and enjoy the ASEE Flow web applications. Another way to run the app is to simply run the JAR file with a java -jar command.
Catch up: get the sources of Step-1
git clone https://github.com/camunda/camunda-get-started-spring-boot.git
git checkout -f Step-1
Or download as a .zip.

​
Next step

Continue to configuration.