Einrichtung und Prüfstand
JDK 21, Maven ab 3.9, Docker. 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.
verify.py startet PostgreSQL selbst. Die Beispieldaten leben nur in diesem temporären Testcontainer.
Geprüft am 20.10.2026 unter Linux x86_64. Zwei getrennte Verbindungen lesen denselben Stand. Genau eine Änderung gewinnt. Der zweite Test prüft Rollback. Eine neue Transaktion darf keine Teilwirkung des fehlgeschlagenen Ablaufs sehen.
Zwei Nutzer können denselben bestätigten Stand gelesen haben. Eine spätere Speicherung darf die erste Änderung nicht still überschreiben. Das UPDATE enthält deshalb die zuvor gelesene Version. Genau eine betroffene Zeile bedeutet Erfolg. Null Zeilen bedeuten einen Konflikt. Der Test verwendet zwei echte PostgreSQL-Verbindungen und prüft den abschließenden Inhalt.
Paketinhalt und einzelne Dateien
01Den Fachvertrag lesen
Eine Version gehört zum gelesenen Datensatz. Das UPDATE akzeptiert nur dieselbe Version und erhöht sie atomar. Null geänderte Zeilen zeigen einen konkurrierenden Schreibvorgang. Der Aufrufer muss neu laden oder den Konflikt erklären.
package tutorial;
import java.sql.*;
public class VersionedStore {
public static Connection connect() throws SQLException {
return DriverManager.getConnection(
System.getenv("LEARNING_DATABASE_URL"),
"learning",
"learning"
);
}
public static int update(Connection c, String name, int expected)
throws SQLException {
try (
var s = c.prepareStatement(
"UPDATE vehicles SET name=?,version=version+1 WHERE id=1 AND version=?"
)
) {
s.setString(1, name);
s.setInt(2, expected);
return s.executeUpdate();
}
}
}
02Die Umgebung isoliert starten
Java 21 ist die festgelegte Sprachbasis. Maven löst die Abhängigkeiten aus der POM auf. verify.py erzeugt eine eigene PostgreSQL-Instanz auf einem freien lokalen Port und entfernt nur diesen Container nach dem Test.
<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.postgresql</groupId><artifactId>postgresql</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
Zwei getrennte Verbindungen lesen denselben Stand. Genau eine Änderung gewinnt. Der zweite Test prüft Rollback. Eine neue Transaktion darf keine Teilwirkung des fehlgeschlagenen Ablaufs sehen.
package tutorial;
import static org.junit.jupiter.api.Assertions.*;
import org.junit.jupiter.api.Test;
class LessonTest {
@Test
void staleWriteCannotOverwriteAndRollbackPreservesState() throws Exception {
try (var a = VersionedStore.connect(); var b = VersionedStore.connect()) {
try (var s = a.createStatement()) {
s.execute(
"CREATE TABLE vehicles(id INT PRIMARY KEY,name TEXT NOT NULL,version INT NOT NULL)"
);
s.execute("INSERT INTO vehicles VALUES(1,'Original',1)");
}
a.setAutoCommit(false);
b.setAutoCommit(false);
assertEquals(1, VersionedStore.update(a, "First", 1));
a.commit();
assertEquals(0, VersionedStore.update(b, "Stale", 1));
b.rollback();
assertEquals(1, VersionedStore.update(a, "Temporary", 2));
a.rollback();
try (
var s = b.createStatement();
var r = s.executeQuery("SELECT name,version FROM vehicles WHERE id=1")
) {
assertTrue(r.next());
assertEquals("First", r.getString(1));
assertEquals(2, r.getInt(2));
}
b.rollback();
}
}
}
Starten / prüfen
python3 verify.pyZwei getrennte Verbindungen lesen denselben Stand. Genau eine Änderung gewinnt. Der zweite Test prüft Rollback. Eine neue Transaktion darf keine Teilwirkung des fehlgeschlagenen Ablaufs sehen.
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
Wiederhole die verworfene Änderung ausdrücklich mit der aktuellen Version.
06Die Lösung und ihre Grenzen erklären
Ein neuer Benutzerentscheid mit Version 2 kann erfolgreich sein und erhöht die Version auf 3. Ein blindes automatisches Retry würde dagegen möglicherweise eine fachliche Entscheidung überschreiben. Der Lösungstest prüft die betroffene Zeile und den neuen Inhalt. 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
Wiederhole die verworfene Änderung ausdrücklich mit der aktuellen Version.
Lösung mit Erklärung anzeigen
Ein neuer Benutzerentscheid mit Version 2 kann erfolgreich sein und erhöht die Version auf 3. Ein blindes automatisches Retry würde dagegen möglicherweise eine fachliche Entscheidung überschreiben. Der Lösungstest prüft die betroffene Zeile und den neuen Inhalt.
package tutorial;
import static org.junit.jupiter.api.Assertions.*;
import org.junit.jupiter.api.Test;
class LessonTest {
@Test
void staleWriteCannotOverwriteAndRollbackPreservesState() throws Exception {
try (var a = VersionedStore.connect(); var b = VersionedStore.connect()) {
try (var s = a.createStatement()) {
s.execute(
"CREATE TABLE vehicles(id INT PRIMARY KEY,name TEXT NOT NULL,version INT NOT NULL)"
);
s.execute("INSERT INTO vehicles VALUES(1,'Original',1)");
}
a.setAutoCommit(false);
b.setAutoCommit(false);
assertEquals(1, VersionedStore.update(a, "First", 1));
a.commit();
assertEquals(0, VersionedStore.update(b, "Stale", 1));
b.rollback();
assertEquals(1, VersionedStore.update(a, "Temporary", 2));
a.rollback();
try (
var s = b.createStatement();
var r = s.executeQuery("SELECT name,version FROM vehicles WHERE id=1")
) {
assertTrue(r.next());
assertEquals("First", r.getString(1));
assertEquals(2, r.getInt(2));
}
b.rollback();
assertEquals(1, VersionedStore.update(b, "Reviewed", 2));
b.commit();
try (
var s = b.createStatement();
var r = s.executeQuery("SELECT name,version FROM vehicles WHERE id=1")
) {
assertTrue(r.next());
assertEquals("Reviewed", r.getString(1));
assertEquals(3, r.getInt(2));
}
}
}
}
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.