Wie man in 30 Minuten eine REST API in Java schreibt: für Anfänger

Wie man in 30 Minuten eine REST API in Java schreibt: für Anfänger

Das Erstellen einer REST API ist eine der Schlüsselkompetenzen moderner Entwickler. Wenn Sie gerade erst anfangen, Java zu lernen, und schnell Ihren ersten Webservice erstellen möchten, ist diese Anleitung genau das Richtige für Sie. Wir gehen den Weg von der Installation der Werkzeuge bis zu einer funktionierenden API, die Sie im Browser oder mit Postman testen können. Der gesamte Vorgang dauert nicht länger als 30 Minuten.

In diesem Artikel verwenden wir Spring Boot – das beliebteste Framework zum Erstellen von Webanwendungen in Java. Es übernimmt die gesamte Routinekonfiguration, sodass Sie sich auf die Logik konzentrieren können. Als Ergebnis erhalten Sie eine einfache API zur Verwaltung einer Aufgabenliste (Todo List).

Was ist eine REST API und wozu wird sie benötigt?

REST (Representational State Transfer) ist ein Architekturstil zum Aufbau von Webservices. Eine REST API arbeitet über das HTTP-Protokoll und verwendet Standardmethoden:

• GET – Daten abrufen
• POST – neuen Eintrag erstellen
• PUT – vorhandenen Eintrag aktualisieren
• DELETE – Eintrag löschen

Daten werden in der Regel im JSON-Format übertragen. REST APIs werden überall eingesetzt: von mobilen Anwendungen bis hin zu Microservice-Architekturen. Wenn Sie sie beherrschen, können Sie serverseitige Logik für jeden Client erstellen.

Schritt 1: Vorbereitung der Umgebung

Für die Arbeit benötigen wir drei Dinge. Stellen Sie sicher, dass sie auf Ihrem Computer installiert sind.

1.1. JDK (Java Development Kit)

Laden Sie JDK 17 oder neuer von der offiziellen Oracle-Website herunter und installieren Sie es, oder verwenden Sie OpenJDK. Überprüfen Sie die Installation mit folgendem Befehl im Terminal:

java -version

1.2. IntelliJ IDEA (Community Edition)

Dies ist eine kostenlose Entwicklungsumgebung, die sich ideal für Java eignet. Laden Sie sie von der offiziellen Website herunter.

1.3. Postman (optional)

Ein Tool zum Testen von APIs. Sie können es von postman.com herunterladen. Für den Anfang reicht auch ein Browser.

Schritt 2: Erstellen eines Spring Boot-Projekts

Der schnellste Weg ist die Verwendung von Spring Initializr. Dies ist ein Web-Tool, das eine Projektvorlage generiert.

1. Gehen Sie zu start.spring.io.
2. Wählen Sie: Project: Maven, Language: Java, Spring Boot: 3.x.x.
3. Geben Sie im Feld Group com.example und bei Artifact todoapi ein.
4. Klicken Sie auf Add Dependencies und fügen Sie Spring Web hinzu.
5. Klicken Sie auf Generate – es wird ein ZIP-Archiv mit dem Projekt heruntergeladen.
6. Entpacken Sie das Archiv und öffnen Sie den Ordner in IntelliJ IDEA.

Die Projektstruktur sieht wie folgt aus:

• src/main/java/com/example/todoapi/ – Hauptcode
• src/main/resources/application.properties – Einstellungen
• pom.xml – Maven-Build-Datei

Schritt 3: Erstellen des Datenmodells und des Controllers

Jetzt schreiben wir den Code. Zuerst erstellen wir ein einfaches Modell – die Klasse TodoItem.

3.1. Modellklasse

Erstellen Sie eine neue Java-Klasse im Paket com.example.todoapi mit dem Namen TodoItem.java:

package com.example.todoapi;

public class TodoItem {    private Long id;    private String title;    private boolean completed;

    // Standardkonstruktor    public TodoItem() {}

    // Konstruktor mit Parametern    public TodoItem(Long id, String title, boolean completed) {        this.id = id;        this.title = title;        this.completed = completed;    }

    // Getter und Setter    public L