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. JUnit prüft Gruppierung, Summen, negative Beträge und Überlauf. Die Lösung ergänzt leere Eingaben und die Unveränderlichkeit der äußeren Map. List.copyOf und Map.copyOf schützen die Ergebnisse vor nachträglicher Änderung.
Eine Collection legt Eigenschaften wie Reihenfolge und Eindeutigkeit fest. Streams beschreiben die Verarbeitung. Der generische Helfer verändert den Eingabetyp nicht durch einen unsicheren Cast. Geldwerte werden als Cent gespeichert. Geprüfte Addition verhindert, dass ein Überlauf still ein falsches Ergebnis produziert.
Paketinhalt und einzelne Dateien
01Den Fachvertrag lesen
Generics halten den Elementtyp einer Collection fest. Stream-Operationen bilden eine Verarbeitungskette aus Filtern, Abbilden und Sammeln. Zwischenoperationen werden erst beim Terminalschritt ausgeführt. Vermeide versteckte Seiteneffekte in map.
package tutorial;
import java.util.*;
import java.util.function.Function;
import java.util.stream.Collectors;
public class Ledger {
public record Entry(String vehicle, long cents) {
public Entry {
if (
vehicle == null || vehicle.isBlank() || cents < 0
) throw new IllegalArgumentException("Invalid entry");
}
}
public static <T, K> Map<K, List<T>> group(
List<T> values,
Function<T, K> key
) {
var grouped = values.stream().collect(Collectors.groupingBy(key));
var immutable = new HashMap<K, List<T>>();
grouped.forEach((k, v) -> immutable.put(k, List.copyOf(v)));
return Map.copyOf(immutable);
}
public static long total(List<Entry> values) {
return values.stream().mapToLong(Entry::cents).reduce(0, Math::addExact);
}
}
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>
</dependencies>
<build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build>
</project>
03Erfolg und Fehler prüfen
JUnit prüft Gruppierung, Summen, negative Beträge und Überlauf. Die Lösung ergänzt leere Eingaben und die Unveränderlichkeit der äußeren Map. List.copyOf und Map.copyOf schützen die Ergebnisse vor nachträglicher Änderung.
package tutorial;
import static org.junit.jupiter.api.Assertions.*;
import java.util.*;
import org.junit.jupiter.api.Test;
class LessonTest {
@Test
void groupsAndTotals() {
var rows = List.of(
new Ledger.Entry("car", 100),
new Ledger.Entry("car", 200),
new Ledger.Entry("bike", 50)
);
var groups = Ledger.group(rows, Ledger.Entry::vehicle);
assertEquals(300, Ledger.total(groups.get("car")));
assertEquals(50, Ledger.total(groups.get("bike")));
assertThrows(UnsupportedOperationException.class, () ->
groups.get("car").clear()
);
}
@Test
void invalidAndOverflow() {
assertThrows(IllegalArgumentException.class, () ->
new Ledger.Entry("car", -1)
);
assertThrows(ArithmeticException.class, () ->
Ledger.total(
List.of(
new Ledger.Entry("car", Long.MAX_VALUE),
new Ledger.Entry("car", 1)
)
)
);
}
}
Starten / prüfen
mvn testGruppen und Summen stimmen. Ungültige Werte werden abgelehnt. Ergebnis-Collections lassen sich nicht ändern.
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 eine leere Eingabe und die Unveränderlichkeit der äußeren Map.
06Die Lösung und ihre Grenzen erklären
Eine leere Liste ergibt eine leere Map und die Summe null. Map.copyOf schützt die Zuordnung, List.copyOf zusätzlich die enthaltenen Listen. Beides sind getrennte Garantien. 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 eine leere Eingabe und die Unveränderlichkeit der äußeren Map.
Lösung mit Erklärung anzeigen
Eine leere Liste ergibt eine leere Map und die Summe null. Map.copyOf schützt die Zuordnung, List.copyOf zusätzlich die enthaltenen Listen. Beides sind getrennte Garantien.
package tutorial;
import static org.junit.jupiter.api.Assertions.*;
import java.util.*;
import org.junit.jupiter.api.Test;
class LessonTest {
@Test
void emptyAndOuterMap() {
assertEquals(0, Ledger.total(List.of()));
assertTrue(
Ledger.group(List.<Ledger.Entry>of(), Ledger.Entry::vehicle).isEmpty()
);
assertThrows(UnsupportedOperationException.class, () ->
Ledger.group(
List.of(new Ledger.Entry("car", 1)),
Ledger.Entry::vehicle
).clear()
);
}
@Test
void groupsAndTotals() {
var rows = List.of(
new Ledger.Entry("car", 100),
new Ledger.Entry("car", 200),
new Ledger.Entry("bike", 50)
);
var groups = Ledger.group(rows, Ledger.Entry::vehicle);
assertEquals(300, Ledger.total(groups.get("car")));
assertEquals(50, Ledger.total(groups.get("bike")));
assertThrows(UnsupportedOperationException.class, () ->
groups.get("car").clear()
);
}
@Test
void invalidAndOverflow() {
assertThrows(IllegalArgumentException.class, () ->
new Ledger.Entry("car", -1)
);
assertThrows(ArithmeticException.class, () ->
Ledger.total(
List.of(
new Ledger.Entry("car", Long.MAX_VALUE),
new Ledger.Entry("car", 1)
)
)
);
}
}
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.