Einrichtung und Prüfstand
JDK 21, Maven ab 3.9. Zusätzlich Python 3 für den gemeinsamen Prüfstart. Entpacke das Lernpaket in einen neuen Ordner und führe dort python3 run_checks.py aus. Das Skript kopiert die enthaltenen Dateien in einen temporären Lernordner. Dort prüft es zuerst das Beispiel und danach die mitgelieferte Lösung. Die Ausgangsdateien bleiben erhalten. Benötigte Pakete werden beim ersten Lauf aus dem Netz geladen.
Geprüft am 20.10.2026 unter Linux x86_64. HTTP-Tests prüfen Health und den Zähler vor und nach einer Aktion. Die CI-Datei führt dieselben Tests aus. Ein lokaler Health-Status ist kein Nachweis für Alarmierung oder Wiederherstellung im Betrieb.
Ein laufender Prozess beweist noch keine erfolgreiche Fachaktion. Deshalb trennen wir technische Erreichbarkeit und einen konkreten Geschäftszähler. Ein gültiger Request erhöht accepted.jobs. Eine ungültige Eingabe erhöht ihn nicht. Der Test fragt die Metrik über HTTP ab. Diese lokale Demo bindet ausschließlich Loopback und beschreibt keine öffentliche Monitoring-Freigabe.
Paketinhalt und einzelne Dateien
01Den Fachvertrag lesen
Health beschreibt Erreichbarkeit und Bereitschaft. Metriken zählen beobachtete Vorgänge. Logs erklären einzelne Ereignisse. Diese Signale beantworten verschiedene Fragen und sollten keine privaten Nutzdaten oder unbegrenzt viele Kennwerte erzeugen.
package tutorial;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@org.springframework.web.bind.annotation.RestController
class Jobs {
private final io.micrometer.core.instrument.Counter accepted;
private static final org.slf4j.Logger log = org.slf4j.LoggerFactory.getLogger(
Jobs.class
);
Jobs(io.micrometer.core.instrument.MeterRegistry registry) {
accepted = registry.counter("accepted.jobs");
}
@org.springframework.web.bind.annotation.PostMapping("/jobs")
org.springframework.http.ResponseEntity<String> create(
@org.springframework.web.bind.annotation.RequestBody String title
) {
if (
title.isBlank()
) return org.springframework.http.ResponseEntity.badRequest().body(
"Title required"
);
accepted.increment();
log.info("job accepted");
return org.springframework.http.ResponseEntity.accepted().body("queued");
}
}
02Die Umgebung isoliert starten
Java 21 ist die festgelegte Sprachbasis. Maven löst die Abhängigkeiten aus der POM auf. Der Test verwendet eigene Daten. HTTP-Tests starten einen Server auf einem zufällig zugewiesenen lokalen Port.
<project xmlns="http://maven.apache.org/POM/4.0.0">
<modelVersion>4.0.0</modelVersion>
<parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>4.1.0</version></parent>
<groupId>learning</groupId><artifactId>tutorial</artifactId><version>1.0</version>
<properties><java.version>21</java.version></properties>
<dependencies>
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency>
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-actuator</artifactId></dependency>
</dependencies>
<build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build>
</project>
03Erfolg und Fehler prüfen
HTTP-Tests prüfen Health und den Zähler vor und nach einer Aktion. Die CI-Datei führt dieselben Tests aus. Ein lokaler Health-Status ist kein Nachweis für Alarmierung oder Wiederherstellung im Betrieb.
package tutorial;
import static org.junit.jupiter.api.Assertions.*;
import java.net.*;
import java.net.http.*;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.web.server.LocalServerPort;
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
class LessonTest {
@LocalServerPort
int port;
HttpResponse<String> get(String path) throws Exception {
return HttpClient.newHttpClient().send(
HttpRequest.newBuilder(
URI.create("http://127.0.0.1:" + port + path)
).build(),
HttpResponse.BodyHandlers.ofString()
);
}
int post(String text) throws Exception {
return HttpClient.newHttpClient()
.send(
HttpRequest.newBuilder(URI.create("http://127.0.0.1:" + port + "/jobs"))
.POST(HttpRequest.BodyPublishers.ofString(text))
.header("Content-Type", "text/plain")
.build(),
HttpResponse.BodyHandlers.ofString()
)
.statusCode();
}
@Test
void healthAndBusinessMetric() throws Exception {
assertEquals(200, get("/actuator/health").statusCode());
assertTrue(
get("/actuator/metrics/accepted.jobs").body().contains("\"value\":0.0")
);
assertEquals(400, post(" "));
assertTrue(
get("/actuator/metrics/accepted.jobs").body().contains("\"value\":0.0")
);
assertEquals(202, post("Example"));
assertTrue(
get("/actuator/metrics/accepted.jobs").body().contains("\"value\":1.0")
);
}
}
Starten / prüfen
mvn testHTTP-Tests prüfen Health und den Zähler vor und nach einer Aktion. Die CI-Datei führt dieselben Tests aus. Ein lokaler Health-Status ist kein Nachweis für Alarmierung oder Wiederherstellung im Betrieb.
04Eine Regression sichtbar machen
Verändere eine fachliche Erwartung und starte den Test erneut. Maven muss einen Fehler melden. Ein übersprungener Datenbanktest ist kein Nachweis. Stelle anschließend die richtige Erwartung wieder her.
05Den Vertrag erweitern
Prüfe, dass sensible Verwaltungsendpunkte nicht versehentlich freigegeben sind.
06Die Lösung und ihre Grenzen erklären
Die Lösung erwartet 404 für /actuator/env. Nur health und metrics werden freigegeben. Ein Produktionssystem benötigt zusätzliche Zugriffskontrolle und eine festgelegte Aufbewahrung für Logs. Nutzdaten werden hier nicht geloggt. Kopiere solution/LessonTest.java über die Testdatei und wiederhole denselben Prüfablauf.
Alle Testfälle bestehen, einschließlich der zusätzlichen Lösungserwartung.
Deine Übung
Prüfe, dass sensible Verwaltungsendpunkte nicht versehentlich freigegeben sind.
Lösung mit Erklärung anzeigen
Die Lösung erwartet 404 für /actuator/env. Nur health und metrics werden freigegeben. Ein Produktionssystem benötigt zusätzliche Zugriffskontrolle und eine festgelegte Aufbewahrung für Logs. Nutzdaten werden hier nicht geloggt.
package tutorial;
import static org.junit.jupiter.api.Assertions.*;
import java.net.*;
import java.net.http.*;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.web.server.LocalServerPort;
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
class LessonTest {
@LocalServerPort
int port;
HttpResponse<String> get(String path) throws Exception {
return HttpClient.newHttpClient().send(
HttpRequest.newBuilder(
URI.create("http://127.0.0.1:" + port + path)
).build(),
HttpResponse.BodyHandlers.ofString()
);
}
int post(String text) throws Exception {
return HttpClient.newHttpClient()
.send(
HttpRequest.newBuilder(URI.create("http://127.0.0.1:" + port + "/jobs"))
.POST(HttpRequest.BodyPublishers.ofString(text))
.header("Content-Type", "text/plain")
.build(),
HttpResponse.BodyHandlers.ofString()
)
.statusCode();
}
@Test
void healthAndBusinessMetric() throws Exception {
assertEquals(404, get("/actuator/env").statusCode());
assertEquals(200, get("/actuator/health").statusCode());
assertTrue(
get("/actuator/metrics/accepted.jobs").body().contains("\"value\":0.0")
);
assertEquals(400, post(" "));
assertTrue(
get("/actuator/metrics/accepted.jobs").body().contains("\"value\":0.0")
);
assertEquals(202, post("Example"));
assertTrue(
get("/actuator/metrics/accepted.jobs").body().contains("\"value\":1.0")
);
}
}
Projektbezug und Quellen
Das eigenständige Lernprojekt vertieft ein Thema aus diesem Technologiebereich. Die Projektverweise zeigen einen festgehaltenen Quellstand als Architekturkontext. Sie sind kein Beleg dafür, dass jede hier neu eingeführte Bibliothek oder Funktion bereits in dieser App verwendet wird.