Seminar FoundationDB – Entwicklung mit Java

Das Einzelseminar vermittelt Java-Binding, API-Version, Schlüssel- und Bereichszugriffe, Retry-Logik, Tuple-Modellierung, Futures, Observability und Praxisprojekt. Die Themen werden von der fachlichen Einordnung über die Konfiguration beziehungsweise Implementierung bis zur kontrollierten Prüfung in einer zusammenhängenden Laborumgebung bearbeitet.

Jeder Themenblock enthält eine eigene Inhaltsübersicht, konkrete Arbeitsschritte und Prüfpunkte. Konfigurationen, Datenmodelle und Betriebsentscheidungen werden so dokumentiert, dass sie in Projekt- und Betriebsstandards übernommen werden können.

Inhaltsübersicht

1. 1. Java-Binding, API-Version und Projektaufbau
2. 2. Schlüssel-, Wert- und Bereichszugriffe mit Java
3. 3. Transaktionen und Retry-Logik in Java
4. 4. Tuple Layer und Repository-Design in Java
5. 5. ACID-Semantik, MVCC und Strict Serializability
6. 6. Nebenläufigkeit, Futures und Backpressure in Java
7. 7. Observability und Fehlerdiagnose für Java-Clients
8. 8. Praxisprojekt und Produktionscheckliste in Java

1. Java-Binding, API-Version und Projektaufbau

Kapitelinhaltsverzeichnis

1. 1.1 Einordnung und Zielsetzung
2. 1.2 Fachthemen
3. 1.3 Schritt-für-Schritt-Übung
4. 1.4 Prüfpunkte

Einordnung und Zielsetzung

Das Kapitel richtet ein reproduzierbares Java-Projekt mit passender Clientbibliothek ein. Versionen, native Abhängigkeiten und Clusterzugriff werden explizit kontrolliert.

Fachthemen

• Native Clientbibliothek und Binding
• API-Version
• Build, Laufzeit und Clusterdatei

Schritt-für-Schritt-Übung: ein Java-Projekt mit FoundationDB verbinden

1. Schritt 1: Java-Projekt mit passender FoundationDB-Abhängigkeit konfigurieren.
2. Schritt 2: Native Bibliothek für die Zielplattform bereitstellen.
3. Schritt 3: API-Version früh im Prozess auswählen und Datenbankhandle öffnen.
4. Schritt 4: Executor- und Threading-Konzept für asynchrone Verarbeitung festlegen.
5. Schritt 5: Verbindung und Transaktionsausführung mit einem Integrationstest prüfen.

Prüfpunkte

• Die Umsetzung berücksichtigt native Clientbibliothek und Binding und ist reproduzierbar dokumentiert.
• Das Verhalten von API-Version ist mit einem positiven und einem negativen Testfall geprüft.
• Abbruch-, Rückfall- und Eskalationskriterien sind eindeutig benannt.

2. Schlüssel-, Wert- und Bereichszugriffe mit Java

Kapitelinhaltsverzeichnis

1. 2.1 Einordnung und Zielsetzung
2. 2.2 Fachthemen
3. 2.3 Schritt-für-Schritt-Übung
4. 2.4 Prüfpunkte

Einordnung und Zielsetzung

Grundoperationen werden in idiomatischem Java umgesetzt. Besonderes Gewicht liegt auf Binärdaten, asynchronem Verhalten und begrenzten Bereichslesern.

Fachthemen

• Binäre Schlüssel und Werte
• Get, Set und Clear
• Range Read und Iterator

Schritt-für-Schritt-Übung: einen vollständigen Datenzugriff implementieren

1. Schritt 1: Schlüssel- und Wertkodierung als zentrale Hilfsfunktionen definieren.
2. Schritt 2: Einzelne Werte lesen, schreiben und löschen.
3. Schritt 3: Bereichsgrenzen aus einem Präfix ableiten und mit Limit lesen.
4. Schritt 4: Pagination mit dem letzten Schlüssel fortsetzen.
5. Schritt 5: Fehler und leere Ergebnisse in der Anwendung eindeutig behandeln.

Prüfpunkte

• Die Umsetzung berücksichtigt binäre Schlüssel und Werte und ist reproduzierbar dokumentiert.
• Das Verhalten von Get, Set und Clear ist mit einem positiven und einem negativen Testfall geprüft.
• Abbruch-, Rückfall- und Eskalationskriterien sind eindeutig benannt.

3. Transaktionen und Retry-Logik in Java

Kapitelinhaltsverzeichnis

1. 3.1 Einordnung und Zielsetzung
2. 3.2 Fachthemen
3. 3.3 Schritt-für-Schritt-Übung
4. 3.4 Prüfpunkte

Einordnung und Zielsetzung

Die Transaktionsschleife wird nach den Konventionen des Java-Bindings aufgebaut. Nebenläufigkeit, Fehlerweitergabe und Ressourcenlebensdauer werden praktisch geprüft.

Fachthemen

• Binding-typischer Retry-Mechanismus
• Futures oder asynchrone Ergebnisse
• Fehler- und Ressourcenbehandlung

Schritt-für-Schritt-Übung: eine produktionsreife Transaktionsfunktion erstellen

1. Schritt 1: Datenbank- oder Tenant-Handle und Transaktionsgrenze festlegen.
2. Schritt 2: Reads parallel anstoßen, bevor Ergebnisse benötigt werden.
3. Schritt 3: Writes und Commit in den Binding-typischen Retry-Mechanismus integrieren.
4. Schritt 4: Externe Nebenwirkungen aus dem wiederholbaren Block entfernen.
5. Schritt 5: Konflikt, Timeout und unbekanntes Ergebnis mit Tests abdecken.

Prüfpunkte

• Die Umsetzung berücksichtigt Binding-typischer Retry-Mechanismus und ist reproduzierbar dokumentiert.
• Das Verhalten von Futures oder asynchrone Ergebnisse ist mit einem positiven und einem negativen Testfall geprüft.
• Abbruch-, Rückfall- und Eskalationskriterien sind eindeutig benannt.

4. Tuple Layer und Repository-Design in Java

Kapitelinhaltsverzeichnis

1. 4.1 Einordnung und Zielsetzung
2. 4.2 Fachthemen
3. 4.3 Schritt-für-Schritt-Übung
4. 4.4 Prüfpunkte

Einordnung und Zielsetzung

Das Datenmodell wird hinter klaren Java-APIs gekapselt. Tuple-Kodierung und Subspaces bleiben intern, während fachliche Methoden transaktionale Invarianten ausdrücken.

Fachthemen

• Tuple-Kodierung
• Subspaces
• Repository- und Servicegrenzen

Schritt-für-Schritt-Übung: ein fachliches Repository umsetzen

1. Schritt 1: Root- und Entitäts-Subspaces definieren.
2. Schritt 2: Pack- und Unpack-Funktionen mit festen Typen kapseln.
3. Schritt 3: Repository-Methoden nach fachlichen Operationen statt Einzelzugriffen schneiden.
4. Schritt 4: Transaktion oder Datenbankhandle bewusst als Parameter übergeben.
5. Schritt 5: Roundtrip-, Range- und Kompatibilitätstests erstellen.

Prüfpunkte

• Die Umsetzung berücksichtigt Tuple-Kodierung und ist reproduzierbar dokumentiert.
• Das Verhalten von Subspaces ist mit einem positiven und einem negativen Testfall geprüft.
• Abbruch-, Rückfall- und Eskalationskriterien sind eindeutig benannt.

5. ACID-Semantik, MVCC und Strict Serializability

Kapitelinhaltsverzeichnis

1. 5.1 Einordnung und Zielsetzung
2. 5.2 Fachthemen
3. 5.3 Schritt-für-Schritt-Übung
4. 5.4 Prüfpunkte

Einordnung und Zielsetzung

Die Transaktionsgarantien werden mit konkurrierenden Abläufen praktisch überprüft. Dabei wird zwischen Snapshot innerhalb einer Transaktion, Commit-Reihenfolge und dauerhafter Bestätigung unterschieden.

Fachthemen

• Snapshot einer Transaktion
• Optimistische Nebenläufigkeit
• Causal Read und Durability

Schritt-für-Schritt-Übung: Transaktionsgarantien experimentell prüfen

1. Schritt 1: Zwei parallele Clients mit kontrollierten Lese- und Schreibfolgen vorbereiten.
2. Schritt 2: Identische Read Versions und unterschiedliche Commit-Reihenfolgen beobachten.
3. Schritt 3: Einen echten Read-Write-Konflikt und einen konfliktfreien Blind Write erzeugen.
4. Schritt 4: Sichtbare Zustände vor und nach erfolgreichem Commit protokollieren.
5. Schritt 5: Die beobachteten Abläufe einem seriellen Ergebnis zuordnen.

Prüfpunkte

• Die Umsetzung berücksichtigt Snapshot einer Transaktion und ist reproduzierbar dokumentiert.
• Das Verhalten von optimistische Nebenläufigkeit ist mit einem positiven und einem negativen Testfall geprüft.
• Abbruch-, Rückfall- und Eskalationskriterien sind eindeutig benannt.

6. Nebenläufigkeit, Futures und Backpressure in Java

Kapitelinhaltsverzeichnis

1. 6.1 Einordnung und Zielsetzung
2. 6.2 Fachthemen
3. 6.3 Schritt-für-Schritt-Übung
4. 6.4 Prüfpunkte

Einordnung und Zielsetzung

Das Clientdesign nutzt Parallelität, ohne interne Netzwerkthreads zu blockieren. Backpressure verhindert, dass große Iterationen oder zu viele Transaktionen Speicher und Cluster überlasten.

Fachthemen

• Parallele Reads
• Client-Threads und Callbacks
• Begrenzung ausstehender Arbeit

Schritt-für-Schritt-Übung: einen begrenzten parallelen Verarbeitungspfad bauen

1. Schritt 1: Unabhängige Reads identifizieren und parallel anstoßen.
2. Schritt 2: Blockierende Arbeit aus Callback- oder Netzwerkthreads fernhalten.
3. Schritt 3: Eine Obergrenze für parallele Transaktionen und ausstehende Futures definieren.
4. Schritt 4: Range-Ergebnisse streamen und schrittweise verarbeiten.
5. Schritt 5: Latenz, Durchsatz, Fehlerquote und Speichernutzung unter Last messen.

Prüfpunkte

• Die Umsetzung berücksichtigt parallele Reads und ist reproduzierbar dokumentiert.
• Das Verhalten von Client-Threads und Callbacks ist mit einem positiven und einem negativen Testfall geprüft.
• Abbruch-, Rückfall- und Eskalationskriterien sind eindeutig benannt.

7. Observability und Fehlerdiagnose für Java-Clients

Kapitelinhaltsverzeichnis

1. 7.1 Einordnung und Zielsetzung
2. 7.2 Fachthemen
3. 7.3 Schritt-für-Schritt-Übung
4. 7.4 Prüfpunkte

Einordnung und Zielsetzung

Clientseitige Telemetrie macht Konflikte, Backoff und langsame Bereiche sichtbar. Fachliche Operations-IDs werden mit Transaktions-Tags und Logs korreliert, ohne Schlüssel- oder Nutzdaten offenzulegen.

Fachthemen

• Transaktions-Tags
• Metriken und strukturierte Logs
• Retry- und Latenzverteilung

Schritt-für-Schritt-Übung: Clienttelemetrie instrumentieren

1. Schritt 1: Fachliche Operationen und technische Transaktionsversuche getrennt zählen.
2. Schritt 2: Latenz, Commit-Erfolg, Retry-Anzahl und Fehlercode messen.
3. Schritt 3: Transaktions-Tags mit begrenzter Kardinalität vergeben.
4. Schritt 4: Sensible Schlüssel und Werte aus Logs ausschließen.
5. Schritt 5: Dashboards und Alarmgrenzen mit einem Lasttest validieren.

Prüfpunkte

• Die Umsetzung berücksichtigt Transaktions-Tags und ist reproduzierbar dokumentiert.
• Das Verhalten von Metriken und strukturierte Logs ist mit einem positiven und einem negativen Testfall geprüft.
• Abbruch-, Rückfall- und Eskalationskriterien sind eindeutig benannt.

8. Praxisprojekt und Produktionscheckliste in Java

Kapitelinhaltsverzeichnis

1. 8.1 Einordnung und Zielsetzung
2. 8.2 Fachthemen
3. 8.3 Schritt-für-Schritt-Übung
4. 8.4 Prüfpunkte

Einordnung und Zielsetzung

Ein zusammenhängendes Java-Projekt verbindet Datenmodell, Transaktionen, Fehlerbehandlung und Betrieb. Der Abschluss ist eine reviewbare Implementierung mit reproduzierbaren Tests.

Fachthemen

• End-to-End-Anwendungsfall
• Test- und Lastnachweis
• Deployment und Betriebsübergabe

Schritt-für-Schritt-Übung: einen End-to-End-Dienst fertigstellen

1. Schritt 1: Fachlichen Anwendungsfall und messbare Invarianten festlegen.
2. Schritt 2: Datenmodell, Repository und Serviceoperationen implementieren.
3. Schritt 3: Idempotenz, Konkurrenz und Range-Pagination automatisiert testen.
4. Schritt 4: Clientkonfiguration, Telemetrie und Deploymentparameter ergänzen.
5. Schritt 5: Code, Lastverhalten und Runbook anhand einer Produktionscheckliste reviewen.

Prüfpunkte

• Die Umsetzung berücksichtigt End-to-End-Anwendungsfall und ist reproduzierbar dokumentiert.
• Das Verhalten von Test- und Lastnachweis ist mit einem positiven und einem negativen Testfall geprüft.
• Abbruch-, Rückfall- und Eskalationskriterien sind eindeutig benannt.