:source-highlighter: coderay
:icons: font
:experimental:
:!sectnums:
:imagesdir: ./images/
:handout: ./code/

:logo: IT.PROG2 -
ifdef::backend-html5[]
:logo: image:PROG2-300x300.png[IT.PROG2,100,100,role=right,fit=none,position=top right]
endif::[]
ifdef::backend-pdf[]
:logo:
endif::[]
ifdef::env-github[]
:tip-caption: :bulb:
:note-caption: :information_source:
:important-caption: :heavy_exclamation_mark:
:caution-caption: :fire:
:warning-caption: :warning:
endif::[]

= {logo} Praktikum Concurrency - Cooperation

== Einleitung

Ziele dieses Praktikums sind:

* Sie können die verschiedenen Mechanismen zur Thread-Synchronisation sicher anwenden (Mutual-Exclusion, Condition-Synchronisation).
* Sie können das Monitor-Konzept (wait/notify, Lock & Conditions) in Java anwenden.
* Sie können Producer-Consumer Synchronisation praktisch anwenden.
* Sie wissen wie Deadlocks praktisch verhindert werden können.


=== Voraussetzungen
* Vorlesung Concurrency 1 bis 4

=== Tooling

* Installiertes JDK 17+
* Gradle 7.4+

=== Struktur

Ein Praktikum kann verschiedene Arten von Aufgaben enthalten, die wie folgt gekennzeichnet sind:

[TU] – Theoretische Übung::
Dient der Repetition bzw. Vertiefung des Stoffes aus der Vorlesung und als Vorbereitung für die nachfolgenden Übungen.

[PU] – Praktische Übung::
Übungsaufgaben zur praktischen Vertiefung von Teilaspekten des behandelten Themas.

[PA] – Pflichtaufgabe::
Übergreifende Aufgabe zum Abschluss. Das Lösen dieser Aufgaben ist Pflicht. Sie muss bis zum definierten Zeitpunkt abgegeben werden, wird bewertet und ist Teil der Vornote.

=== Zeit und Bewertung

Für dieses Praktikum stehen 2 Wochen in den Praktikumslektionen und im Selbststudium zur Verfügung. +
Je nach Kenntniss- und Erfahrungsstufe benötigen Sie mehr oder weniger Zeit.
Nutzen Sie die Gelegenheit den Stoff zu vertiefen, Auszuprobieren, Fragen zu stellen und Lösungen zu diskutieren (Intensive-Track). +
Falls Sie das Thema schon beherrschen, müssen Sie nur die Pflichtaufgaben lösen und bis zum angegebenen Zeitpunkt abgeben (Fast-Track).

Die Pflichtaufgabe wird mit 0 bis 2 Punkten bewertet (siehe _Leistungsnachweise_ auf Moodle).

=== Referenzen

* link:{handout}[Praktikumsverzeichnis – Quellcode, Projektstruktur]

:sectnums:
:sectnumlevels: 2
// Beginn des Aufgabenblocks

== Concurrency 3 -- Thread Synchronisation

=== Konto-Übertrag [PU]

Im link:{handout}[Praktikumsverzeichnis] finden sie das Modul `AccountTransfer`.
Die Klasse `Account`, welche sie schon aus dem Unterricht kennen, repräsentiert ein Konto von welchem bzw. auf welches man Geld transferieren und den Kontostand abfragen kann.

Die Klasse `AccountTransferTask` ist ein `Runnable` welches einen Geldbetrag zwischen zwei Konten transferiert . Der entsprechende Ablauf ist in der Methode `accountTransfer` umgesetzt.

Um die Funktionalität zu verifizieren, wurde in der Klasse `AccountTransferSimulation` ein Testszenario umgesetzt,
in welchem eine Grosszahl kleiner Beträge zwischen drei Konten transferiert wird.
Dazu wird ein ExecutorService mit mehreren Threads verwendet, an welchen die TransferTasks übermittelt werden.
Die Simulation gibt die Kontostände und das Vermögen (Summe der Kontostände) zu Beginn und am Ende des Transfers aus.

[loweralpha]
. Was stellen Sie fest, wenn Sie die Simulation laufen lassen?
Erklären Sie wie die Abweichungen zustande kommen.

. Im Unterricht haben Sie gelernt, dass kritische Bereiche Ihres Codes durch Mutual-Exclusion geschützt werden sollen.
  Wie macht man das in Java?
+
Versuchen Sie mittels von Mutual-Exclusion sicherzustellen, dass keine Abweichungen entstehen.
+
  ** Reicht es die kritischen Bereiche in Account zu sichern?
  ** Welches sind die kritischen Bereiche?
+
Untersuchen Sie mehrere Varianten von Locks (Lock auf Methode oder Block,
Lock auf Instanz oder Klasse).
+
Ihre Implementierung muss noch nebenläufige Transaktionen erlauben, d.h. wenn
Sie zu stark synchronisieren, werden alle Transaktionen in Serie ausgeführt und
Threads ergeben keinen Sinn mehr.
+
Stellen Sie für sich folgende Fragen:
+
  ** Welches ist das Monitor-Objekt?
  ** Braucht es eventuell das Lock von mehr als einem Monitor, damit eine Transaktion ungestört ablaufen kann?

. Wenn Sie es geschafft haben die Transaktion thread-safe zu implementieren,
  ersetzen Sie in `AccountTransferSimulation` die folgende Zeile: +
  `AccountTransferTask task1 = new AccountTransferTask(account**3**, account**1**, 2);` +
durch +
`AccountTransferTask task1 = new AccountTransferTask(account**1**, account**3**, 2);` +
und starten Sie das Programm noch einmal. Was stellen Sie fest?
(evtl. müssen Sie mehrfach neu starten, damit der Effekt auftritt). +
Was könnte die Ursache sein und wie können Sie es beheben? +
[NOTE]
Falls Sie die Frage noch nicht beantworten können, kommen sie nach der Vorlesung "Concurrency 4" nochmals auf diese Aufgabe zurück und versuchen Sie sie dann zu lösen.

=== Traffic Light [PU]

In dieser Aufgabe sollen Sie die Funktionsweise einer Ampel und deren Nutzung nachahmen.
Benutzen Sie hierzu die Vorgabe im Modul `TrafficLight`.

[loweralpha]
. Ergänzen Sie zunächst in der Klasse `TrafficLight` drei Methoden:
* Eine Methode zum Setzen der Ampel auf "rot".
* Eine Methode zum Setzen der Ampel auf "grün".
* Eine Methode mit dem Namen `passby()`. Diese Methode soll das Vorbeifahren
eines Fahrzeugs an dieser Ampel nachbilden: Ist die Ampel rot, so wird der
aufrufende Thread angehalten, und zwar so lange, bis die Ampel grün wird.
Ist die Ampel dagegen grün, so kann der Thread sofort aus der Methode zurückkehren,
ohne den Zustand der Ampel zu verändern. Verwenden Sie `wait`, `notify` und
`notifyAll` nur an den unbedingt nötigen Stellen!
+
[NOTE]
Die Zwischenphase „gelb“ spielt keine Rolle – Sie können diesem Zustand ignorieren!

. Erweitern Sie nun die Klasse `Car` (abgeleitet von `Thread`). +
Im Konstruktor wird eine Referenz auf ein Feld von Ampeln übergeben.
Diese Referenz wird in einem entsprechenden Attribut der Klasse `Car` gespeichert.
In der `run`-Methode werden alle Ampeln dieses Feldes passiert, und zwar in einer Endlosschleife (d.h. nach dem Passieren der letzten Ampel des Feldes wird wieder die erste Ampel im Feld passiert). +
Natürlich darf das Auto erst dann eine Ampel passieren, wenn diese auf grün ist! +
Für die Simulation der Zeitspanne für das Passieren des Signals sollten Sie folgende Anweisung verwenden: `sleep\((int)(Math.random() * 500));`

Beantworten Sie entweder (c) oder (d) (nicht beide):

[loweralpha, start=3]
. Falls Sie bei der Implementierung der Klasse TrafficLight die Methode
`notifyAll()` benutzt haben: +
Hätten Sie statt `notifyAll` auch die Methode `notify` verwenden können, oder haben Sie `notifyAll()` unbedingt gebraucht?
Begründen Sie Ihre Antwort!

. Falls Sie bei der Implementierung der Klasse Ampel die Methode `notify()` benutzt
haben: +
Begründen Sie, warum `notifyAll()` nicht unbedingt benötigt wird!

. Testen Sie das Programm `TrafficLightOperation.java`.
Die vorgegebene Klasse implementiert eine primitive Simulation von Autos, welche die Ampeln passieren.
Studieren Sie den Code dieser Klasse und überprüfen Sie, ob die erzeugte Ausgabe sinnvoll ist.


=== Producer-Consumer Problem [PU]

In dieser Aufgabe wird ein Producer-Consumer Beispiel mittels einer Queue umgesetzt.

Dazu wird eine Implementation mittels eines link:https://en.wikipedia.org/wiki/Circular_buffer[Digitalen Ringspeichers] umgesetzt.

.Circular Buffer [Wikipedia]
[link = https://en.wikipedia.org/wiki/Circular_buffer]
image::Circular_Buffer_Animation.gif[pdfwidth=75%, width=600px]

Hierzu sind zwei Klassen (`CircularBuffer.java`, `Buffer.java`) vorgegeben, mit folgendem Design:

.Circular Buffer Design
image::CircularBuffer.png[pdfwidth=75%, width=600px]


==== Analyse der abgegebenen CircularBuffer Umsetzung.

Mit dem Testprogramm `CircBufferSimulation` kann die Funktion der `CircularBuffer` Implementierung analysiert werden.
Der mitgelieferte `Producer`-Thread generiert kontinuierlich Daten (in unserem Fall aufsteigende Nummern) und füllt diese mit `buffer.put(...)` in den Buffer.
Der `Consumer`-Thread liest die  Daten kontinuierlich mit `buffer.get()` aus dem Buffer aus.
Beide Threads benötigen eine gewisse Zeit zum Produzieren bzw. Konsumieren der Daten.
Diese kann über die Variablen `maxProduceTime` bzw. `maxConsumeTime` beeinflusst werden.
Es können zudem mehrere Producer- bzw. Consumer-Threads erzeugt werden.

[loweralpha]
. Starten Sie `CircularBufferSimulation` und analysieren Sie die Ausgabe.
Der Status des Buffers (belegte Positionen und Füllstand) wird sekündlich ausgegeben.
Alle fünf Sekunden wird zudem der aktuelle Inhalt des Buffers ausgegeben. +
** Wie ist das Verhalten des `CircularBuffer` bei den Standard-Testeinstellungen?

. Analysieren Sie die Standard-Einstellungen in `CircularBufferSimulation`.
** Welche Varianten gibt es, die Extrempositionen (Buffer leer, bzw. Buffer voll) zu erzeugen?
** Was ist das erwartete Verhalten bei vollem bzw. leerem Buffer? (bei Producer bzw. Consumer)

. Testen Sie was passiert, wenn der Buffer an die Kapazitätsgrenze kommt. Passen Sie dazu die Einstellungen in `CircularBufferSimulation` entsprechend an. +
[TIP]
Belassen sie die Anzahl Producer-Threads vorerst auf 1, damit der Inhalt des Buffers (Zahlenfolge) einfacher verifiziert werden kann.
+
** Was Stellen Sie fest? Was passiert wenn der Buffer voll ist? Warum?

. Wiederholen Sie das Gleiche für einen leeren Buffer. Passen Sie die Einstellungen so an, dass der Buffer sicher leer wird, d.h. der `Consumer` keine Daten vorfindet.
** Was stellen Sie fest, wenn der Buffer leer ist? Warum? +
[TIP]
Geben Sie gegebenenfalls die gelesenen Werte des Konsumenten-Threads aus.


==== Thread-Safe Circular Buffer
In der vorangehenden Übung griffen mehrere Threads (`Producer` & `Consumer`) auf den gleichen Buffer zu.
Die Klasse `CircularBuffer` ist aber nicht thread-safe.
Deshalb soll jetzt eine Wrapper Klasse geschrieben werden, welche die CircularBuffer-Klasse "thread-safe" macht.
Das führt zu folgendem Design:

.Guarded Circular Buffer Design
image::GuardedCircularBuffer.png[pdfwidth=75%, width=600px]

[NOTE]
====
Beachten Sie, dass es sich hier um einen Wrapper (keine Vererbung) handelt. +
Der `GuardedCircularBuffer` hält eine Referenz auf ein `CircularBuffer`-Objekt welches er im Hintergrund für die Speicherung verwendet. Das heißt, viele Methodenaufrufe werden einfach an das gekapselte Objekt weitergeleitet. Einzelne Methoden werden jedoch in ihrer Funktion erweitert. Man spricht auch von "Dekorieren" des Original-Objektes (siehe link:{decorator-pattern}[Decorator-Pattern]).
====

:decorator-pattern: https://en.wikipedia.org/wiki/Decorator_pattern

[loweralpha, start=5]
. Ergänzen Sie die vorhandene Klasse `GuardedCircularBuffer` sodass:
** Die Methoden `empty`, `full`, `count` das korrekte Resultat liefern.
** Aufrufe von `put` blockieren, solange der Buffer voll ist, d.h. bis mindestens wieder ein leeres Buffer-Element vorhanden ist.
** Analog dazu Aufrufe von `get` blockieren, solange der Buffer leer ist, d.h, bis mindestens ein Element im Buffer vorhanden ist.

[TIP]
====
Verwenden Sie den Java Monitor des `GuardedCircularBuffer`-Objektes!
Wenn die Klasse fertig implementiert ist, soll sie in der `CircBufferSimulation` Klasse verwendet werden.
====

Beantworten Sie entweder (i) oder (ii) (nicht beide):

[lowerroman]
. Falls Sie bei der Implementierung der Klasse `GuardedCircularBuffer` die Methode `notifyAll()` benutzt haben:
Hätten Sie statt `notifyAll()` auch die Methode `notify()` verwenden können oder haben Sie `notifyAll()` unbedingt
benötigt? Begründen Sie Ihre Antwort!

. Falls Sie bei der Implementierung der Klasse `GuardedCircularBuffer` die Methode `notify()` benutzt haben:
Begründen Sie, warum Sie `notifyAll()` nicht unbedingt benötigten!


== Concurrency 4 -- Lock & Conditions, Deadlocks

=== Single-Lane Bridge [PU]

Die Brücke über einen Fluss ist so schmal, dass Fahrzeuge nicht kreuzen können.
Sie soll jedoch von beiden Seiten überquert werden können.
Es braucht somit eine Synchronisation, damit die Fahrzeuge nicht kollidieren.
Um das Problem zu illustrieren wird eine fehlerhaft funktionierende Anwendung,
in welcher keine Synchronisierung vorgenommen wird, zur Verfügung gestellt.
Ihre Aufgabe ist es, die Synchronisation der Fahrzeuge einzubauen.

Die Anwendung finden Sie im link:{handout}[Praktikumsverzeichnis] im Modul `Bridge`.
Gestartet wird sie indem die Klasse `Main` ausgeführt wird (z.B. mit `gradle run`).
Das GUI sollte selbsterklärend sein.
Mit den zwei Buttons können sie Autos links bzw. rechts hinzufügen. Sie werden feststellen, dass die Autos auf der Brücke kollidieren, bzw. illegalerweise durcheinander hindurchfahren.

.Single-Lane Bridge GUI
image::bridge_overview.png[pdfwidth=75%, width=600px]

Um das Problem zu lösen, müssen Sie die den GUI Teil der Anwendung nicht verstehen.
Sie müssen nur wissen, dass Fahrzeuge, die von links nach rechts fahren, die Methode `controller.enterLeft()` aufrufen bevor sie auf die Brücke fahren (um Erlaubnis fragen) und die Methode `controller.leaveRight()` aufrufen, sobald sie die Brücke verlassen.
Fahrzeuge in die andere Richtung rufen entsprechend die Methoden `enterRight()` und `leaveLeft()` auf.
Dabei ist `controller` eine Instanz der Klasse `TrafficController`, welche für die Synchronisation zuständig ist.
In der mitgelieferten Klasse sind die vier Methoden nicht implementiert (Dummy-Methoden).

[loweralpha]
. Erweitern sie `TrafficController` zu einer Monitorklasse, die sicherstellt, dass die Autos nicht mehr kollidieren.
Verwenden Sie dazu den Lock und Conditions Mechanismus.
[TIP]
Verwenden Sie eine Statusvariable, um den Zustand der Brücke zu repräsentieren (e.g. `boolean bridgeOccupied`).

. Passen Sie die Klasse `TrafficController` so an, dass jeweils abwechslungsweise ein Fahrzeug von links und rechts die Brücke passieren kann.
Unter Umständen wird ein Auto blockiert, wenn auf der anderen Seite keines mehr wartet.
Verwenden Sie für die Lösung mehrere Condition Objekte.
[NOTE]
Um die Version aus a. zu behalten, können sie auch eine Kopie (z.B. `TrafficControllerB`) erzeugen und `Main` anpassen, damit eine Instanz dieser Klasse verwendet wird.

. Bauen Sie die Klasse `TrafficController` so um, dass jeweils alle wartenden Fahrzeuge aus einer Richtung passieren können.
Erst wenn keines mehr wartet, kann die Gegenrichtung fahren.
[TIP]
Mit link:{ReentrantLock}[`ReentrentLock.hasWaiters(Condition c)`] können Sie
abfragen ob Threads auf eine bestimmte Condition warten.

:ReentrantLock: https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/util/concurrent/locks/ReentrantLock.html#hasWaiters(java.util.concurrent.locks.Condition)


=== The Dining Philosophers [PA]

.**Beschreibung des Philosophen-Problems:**
****
Fünf Philosophen sitzen an einem Tisch mit einer Schüssel, die immer genügend Spaghetti enthält.
Ein Philosoph ist entweder am Denken oder am Essen.
Um zu essen braucht er zwei Gabeln.
Es hat aber nur fünf Gabeln.
Ein Philosoph kann zum Essen nur die neben ihm liegenden Gabeln gebrauchen.
Aus diesen Gründen muss ein Philosoph warten und hungern, solange einer seiner Nachbarn am Essen ist.
****
[.float-group]
--
[.left]
.Philosopher UI
image::philosopher-ui.png[pdfwidth=30%, width=400px, role="left"]
--

Das Bild zeigt die Ausgabe des Systems, das wir in dieser Aufgabe verwenden.
Die blauen Kreise stellen denkende Philosophen dar, die gelben essende und die roten hungernde.
Bitte beachten Sie, dass eine Gabel, die im Besitz eines Philosophen ist, zu dessen Teller hin verschoben dargestellt ist.

Die Anwendung besteht aus drei Dateien / Hauptklassen (jeweils mit zusätzlichen inneren Klassen):

`PhilosopherGui`::  Ist das Hauptprogramm und repräsentiert das GUI (Java-Swing basiert).
Die Klasse initialisiert die Umgebung `PhilosopherTable`, startet die Simulation und erzeugt die obige Ausgabe.
Zudem werden Statusmeldungen der Philosophen auf der Konsole ausgegeben.

`PhilosopherTable`:: Repräsentiert das Datenmodell. Sie initialisiert, startet und stoppt die Threads der Klasse `Philosopher`,
welche das Verhalten und Zustände (THINKING, HUNGRY, EATING) der Philosophen abbildet und als innere Klasse umgesetzt ist.

`ForkManager`:: Diese Klasse enthält die Strategie, wie die Philosophen die zwei Gabeln (Klasse `Fork`)
aufnehmen (`aquireForks(int philosopherId)`) und zurücklegen (`releaseForks(int philosopherId)`).

[loweralpha]
. Analysieren Sie die bestehende Lösung (vor allem `ForkManager`), die bekanntlich nicht Deadlock-frei ist.
Kompilieren und starten Sie die Anwendung.
Nach einiger Zeit geraten die Philosophen in eine Deadlock-Situation und verhungern.
Überlegen Sie sich, wo im Code der Deadlock entsteht.

. Passen Sie die bestehende Lösung so an, dass keine Deadlocks mehr möglich sind.
Im Unterricht haben Sie mehrere Lösungsansätze kennengelernt. +
In der umzusetzenden Lösung soll der `ForkManager` immer das Gabelpaar eines Philosophen in einer _atomaren_ Operation
belegen bzw. freigeben und nicht die einzelnen Gabeln sequentiell nacheinander.
Dazu müssen beide Gabeln (links & rechts) auch verfügbar (`state == FREE`) sein, ansonsten muss man warten, bis beide verfügbar sind.

** Es sind nur Anpassungen in der Datei `ForkManager.java` notwendig.
   Die `PhilosopherGui` und `PhilosopherTable`-Klassen müssen nicht angepasst werden.
** Verändern Sie nicht das `public` interface des `ForkManager` –
   `acquireForks(int philosopherId)` und `releaseForks(int philosopherId)` müssen bestehen bleiben und verwendet werden.
** Verwenden Sie für die Synchronisation Locks und Conditions!


// Ende des Aufgabenblocks
:!sectnums:
// == Aufräumarbeiten
== Abschluss

Stellen Sie sicher, dass die Pflichtaufgaben mittels `gradle run` gestartet werden können und die Tests mit `gradle test` erfolgreich laufen und pushen Sie die Lösung vor der Deadline in Ihr Abgaberepository.
