• Documentation: https://docs.spring.io/spring-boot/docs/current/reference/html/index.html
• Guides: http://spring.io/guides
  • Building a RESTful Web Service: http://spring.io/guides/gs/rest-service/
  • Building REST services with Spring: http://spring.io/guides/tutorials/bookmarks/

Download your IDE of choice: (e.g., Eclipse, IntelliJ), Visual Studio Code and make sure Java 15 is installed on your system (for Windows-users, please make sure your JAVA_HOME environment variable is set to the correct version of Java).

1. File -> Open... -> SoPra Server Template
2. Accept to import the project as a gradle project

To build right click the build.gradle file and choose Run Build

The following extensions will help you to run it more easily:

• pivotal.vscode-spring-boot
• vscjava.vscode-spring-initializr
• vscjava.vscode-spring-boot-dashboard
• vscjava.vscode-java-pack
• richardwillis.vscode-gradle

Note: You'll need to build the project first with Gradle, just click on the build command in the Gradle Tasks extension. Then check the Spring Boot Dashboard extension if it already shows soprafs22 and hit the play button to start the server. If it doesn't show up, restart VS Code and check again.

You can use the local Gradle Wrapper to build the application.

• macOS: ./gradlew
• Linux: ./gradlew
• Windows: ./gradlew.bat

More Information about Gradle Wrapper and Gradle.

./gradlew build

./gradlew bootRun

./gradlew test

You can start the backend in development mode, this will automatically trigger a new build and reload the application once the content of a file has been changed and you save the file.

Start two terminal windows and run:

./gradlew build --continuous

and in the other one:

./gradlew bootRun

If you want to avoid running all tests with every change, use the following command instead:

./gradlew build --continuous -xtest

• We highly recommend to use Postman in order to test your API Endpoints.

If something is not working and/or you don't know what is going on. We highly recommend that you use a debugger and step through the process step-by-step.

To configure a debugger for SpringBoot's Tomcat servlet (i.e. the process you start with ./gradlew bootRun command), do the following:

1. Open Tab: Run/Edit Configurations
2. Add a new Remote Configuration and name it properly
3. Start the Server in Debug mode: ./gradlew bootRun --debug-jvm
4. Press Shift + F9 or the use Run/Debug"Name of your task"
5. Set breakpoints in the application where you need it
6. Step through the process one step at a time

Have a look here: https://www.baeldung.com/spring-boot-testing