Tutorials

Erstellung und Ausführung einer Spring Boot Web-Applikation in Spring Tool Suite 4 (Java & Maven)

Melden

Hier ist ein detailliertes Tutorial zur Erstellung und Ausführung einer Spring Boot Web-Applikation mit der Spring Tool Suite 4 (STS4), Java und Maven.

Dieses Tutorial führt Sie Schritt für Schritt durch den Prozess, von der Projektanlage bis zur ersten Anzeige im Browser.

1. Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass folgende Komponenten installiert sind:

  • Java Development Kit (JDK): Eine aktuelle Version (z. B. JDK 17 oder höher).
  • Spring Tool Suite 4 (STS4): Die auf Eclipse basierende IDE für Spring.
  • Maven: In STS4 bereits integriert.

Schritt 2: Ein neues Spring Starter Projekt erstellen

  1. Öffnen Sie die Spring Tool Suite 4.
  2. Gehen Sie im Menü auf File -> New -> Spring Starter Project. (Alternativ: Strg + N und nach "Spring Starter" suchen).
  3. Geben Sie die Projektdaten ein:
    • Name: MeineErsteWebApp
    • Type: Maven
    • Java Version: Wählen Sie Ihre installierte Version (z. B. 17 oder 21).
    • Group: com.beispiel
    • Artifact: demo
    • Package: com.beispiel.demo
  4. Klicken Sie auf Next.

Schritt 3: Abhängigkeiten (Dependencies) auswählen

Damit die Anwendung als Web-Applikation funktioniert, müssen wir die entsprechenden Module hinzufügen:

  1. Suchen Sie im Feld "Available" nach Spring Web.
  2. Setzen Sie ein Häkchen bei Spring Web. (Dies inkludiert Apache Tomcat als eingebetteten Server und Spring MVC).
  3. Klicken Sie auf Finish. STS4 lädt nun alle benötigten Maven-Abhängigkeiten herunter und erstellt die Projektstruktur.

Schritt 4: Projektstruktur verstehen

Nachdem das Projekt geladen wurde, sehen Sie im Package Explorer folgende wichtige Elemente:

  • src/main/java: Hier liegt Ihr Java-Quellcode.
  • src/main/resources: Enthält Konfigurationsdateien wie application.properties.
  • pom.xml: Die Maven-Konfigurationsdatei, in der alle Abhängigkeiten verwaltet werden.
  • DemoApplication.java: Die Hauptklasse mit der main-Methode, die den Spring-Kontext startet.

Schritt 5: Einen Web-Controller erstellen

Damit die Applikation eine Antwort im Browser anzeigt, erstellen wir einen einfachen REST-Controller.

  1. Rechtsklick auf das Package com.beispiel.demo in src/main/java.
  2. Wählen Sie New -> Class.
  3. Name der Klasse: HelloController.
  4. Fügen Sie folgenden Code in die Klasse ein:
package com.beispiel.demo;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("/")
    public String sayHello() {
        return "Hallo! Deine Spring Boot Web-Applikation läuft erfolgreich.";
    }
}
  • @RestController: Markiert die Klasse als Controller, der Daten direkt an den Browser sendet.
  • @GetMapping("/"): Legt fest, dass diese Methode aufgerufen wird, wenn die Startseite (Root) aufgerufen wird.

Schritt 6: Die Anwendung ausführen

Es gibt zwei einfache Wege, die Applikation in STS4 zu starten:

Option A (Über den Package Explorer):

  1. Rechtsklick auf das Projektprojekt MeineErsteWebApp.
  2. Wählen Sie Run As -> Spring Boot App.

Option B (Über das Boot Dashboard):

  1. Suchen Sie den Tab Boot Dashboard (meist unten links).
  2. Wählen Sie Ihr Projekt aus und klicken Sie auf das Start-Icon (roter Pfeil).

Achten Sie auf die Console am unteren Bildschirmrand. Wenn dort steht: Started DemoApplication in ... seconds und Tomcat started on port(s): 8080, ist die App bereit.

Schritt 7: Die Web-Applikation im Browser testen

  1. Öffnen Sie einen Webbrowser Ihrer Wahl.
  2. Geben Sie in die Adresszeile ein: http://localhost:8080
  3. Sie sollten nun den Text sehen: "Hallo! Deine Spring Boot Web-Applikation läuft erfolgreich."

Schritt 8: Anwendung stoppen

Um die Anwendung zu beenden:

  • Klicken Sie im Console-Fenster auf das rote Quadrat (Terminate).
  • Oder nutzen Sie das Boot Dashboard und klicken Sie auf das Stop-Icon.

Zusammenfassung

Sie haben erfolgreich:

  1. Ein Maven-basiertes Spring Boot Projekt in STS4 aufgesetzt.
  2. Die Spring Web Dependency hinzugefügt.
  3. Einen Controller für Web-Anfragen erstellt.
  4. Den integrierten Tomcat-Server gestartet und das Ergebnis im Browser geprüft.
0