Parts V to IX in the book, extension 2.9.1, Demo topics

Add chapters 05-08 to the three language profiles: the published book
stopped at Part IV because only 00-04 were listed.

Rename the MQTT topic root Tutorial/ to Demo/ in Part IX (code and
output included).

Shared notes extension 2.9.1: dependency folders are named after the
extension version, so browsers stop serving stale scripts after an
update.

Full rebuild of _book/ (HTML and PDF, three languages); remove the stray
site_libs/ that the last Deploy commit had added at the project root.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
MatsuneMikuroiandClaude Fable 5.1 committed 2026-10-16 09:44:27 +02:00
1 parent 01f681165f
commit f047b9c7ae
128 files changed
+18893 -7591

No files matched your search

+230
View File
@@ -329,6 +329,236 @@
"<span class='chapter-number'>5</span>  <span class='chapter-title'>[Part IV — Rewind]{.en}[Partie IV — Rembobinage]{.fr}[Teil IV — Zurückspulen]{.de}</span>"
]
},
{
"objectID": "05-part-v-subscriptions.html",
"href": "05-part-v-subscriptions.html",
"title": "6  Teil V — Die dynamische Idee über Prozesse hinweg wiederholen",
"section": "",
"text": "6.1 Ein blockierendes watch genügt nicht\nDie Schritte 35 bis 38 holen die Abonnement-Idee aus der einzelnen JVM heraus. Die Dienste werden wieder getrennte Programme, aber anstelle von Vermittlern, die Dateien kopieren, beobachtet jeder Dienst das Postfach, das ihm gesagt wurde. Eine Annahme des ersten Dateisystem-Helfers übersteht den Umzug nicht, und genau deren Korrektur ist das Thema dieses Teils.\nFileMessageBoard.watch(topic, receiver) registriert ein Verzeichnis und blockiert für immer. Das genügte, solange jeder Prozess ein festes Postfach beobachtete. Ein dynamisch verdrahteter Dienst braucht mehr:\nDie alte Signatur kann das nicht ausdrücken, und die Folge war schon vorher sichtbar: der konfigurierbare Vermittler nahm genau eine ROUTE an, denn sobald er seine Quelle beobachtete, wurde er für sein eigenes Steuerpostfach taub. Die Grenze war nie, wessen Verzeichnis es ist — sondern eines, festes, für immer.",
"crumbs": [
"<span class='chapter-number'>6</span>  <span class='chapter-title'>[Part V — Replay the dynamic idea across processes]{.en}[Partie V — Rejouer l'idée dynamique entre processus]{.fr}[Teil V — Die dynamische Idee über Prozesse hinweg wiederholen]{.de}</span>"
]
},
{
"objectID": "05-part-v-subscriptions.html#sec-watch-limit",
"href": "05-part-v-subscriptions.html#sec-watch-limit",
"title": "6  Teil V — Die dynamische Idee über Prozesse hinweg wiederholen",
"section": "",
"text": "dauerhaft das eigene Steuerpostfach beobachten\nUND\nzur Laufzeit ein beobachtetes Verzeichnis hinzufügen\nUND\nes möglicherweise später entfernen",
"crumbs": [
"<span class='chapter-number'>6</span>  <span class='chapter-title'>[Part V — Replay the dynamic idea across processes]{.en}[Partie V — Rejouer l'idée dynamique entre processus]{.fr}[Teil V — Die dynamische Idee über Prozesse hinweg wiederholen]{.de}</span>"
]
},
{
"objectID": "05-part-v-subscriptions.html#sec-filesubscriptions",
"href": "05-part-v-subscriptions.html#sec-filesubscriptions",
"title": "6  Teil V — Die dynamische Idee über Prozesse hinweg wiederholen",
"section": "6.2 Der Helfer: FileSubscriptions",
"text": "6.2 Der Helfer: FileSubscriptions\nEin WatchService kann viele Verzeichnisse bedienen. register(...) gibt einen WatchKey zurück, der eines davon bezeichnet, watcher.take() liefert den Schlüssel mit Ereignissen, und key.cancel() meldet ihn ab. Der Helfer hält beide Richtungen, Name → Schlüssel und Schlüssel → Name, damit ein Ereignis auf das Postfach zurückgeführt werden kann, aus dem es kam.\nEreignisse erreichen keinen Callback direkt. Sie gehen in eine Warteschlange, gelesen mit take(), und tragen\nrecord IncomingMessage(String mailbox, Message message) {}\nDafür zwei Gründe; die Ankunftsreihenfolge ist nur der dritte. Erstens muss der beobachtende Thread für jedes abonnierte Verzeichnis ansprechbar bleiben: ein Callback, der transformiert, veröffentlicht oder blockiert, hielte die Beobachtung aller anderen auf. Zweitens reist der Postfachname mit der Nachricht, sodass eine Schleife im Dienst deren Bedeutung bestimmen kann — Steuerpostfach, also ein anzuwendender Intent; abonnierte Quelle, also zu transformierende Daten — und dieselbe Schleife darf Abonnements hinzufügen oder entfernen, weil sie nicht in einem Callback feststeckt.",
"crumbs": [
"<span class='chapter-number'>6</span>  <span class='chapter-title'>[Part V — Replay the dynamic idea across processes]{.en}[Partie V — Rejouer l'idée dynamique entre processus]{.fr}[Teil V — Die dynamische Idee über Prozesse hinweg wiederholen]{.de}</span>"
]
},
{
"objectID": "05-part-v-subscriptions.html#sec-two-publications",
"href": "05-part-v-subscriptions.html#sec-two-publications",
"title": "6  Teil V — Die dynamische Idee über Prozesse hinweg wiederholen",
"section": "6.3 Zwei Veröffentlichungen statt vier",
"text": "6.3 Zwei Veröffentlichungen statt vier\nStarten Sie SensorService, DynamicProcessorService und DynamicActuatorService — ohne Vermittler — und lassen Sie dann Configure.java die zwei TOPIC-Nachrichten veröffentlichen. Eine danach getippte Zeile hinterlässt genau zwei Anwendungsveröffentlichungen im Brett:\n\n\n\n\n\n\n\n\nPostfach\nInhalt\nwas es ist\n\n\n\n\nconsoleIn/outbox\nTEXT hello\ndie Eingabe\n\n\nrot13/outbox\nTEXT uryyb\ndas Ergebnis\n\n\nrot13/inbox\nTOPIC consoleIn/outbox\nIntent, einmal veröffentlicht\n\n\nconsoleOut/inbox\nTOPIC rot13/outbox\nIntent, einmal veröffentlicht\n\n\n\nconsoleOut/inbox enthält keine Nutzlast: ConsoleOut nimmt direkt aus rot13/outbox. Sein Postfach wechselte die Aufgabe, von Nachrichten zu Verdrahtung.\nEine Zeile, die vor dem Lauf von Configure.java getippt wurde, bleibt für immer in consoleIn/outbox. Ein Abonnement, das noch nicht existiert, verpasst, was ihm vorausging — dieselbe Lehre wie beim neu gestarteten Vermittler, der nichts auslieferte.\n\n\n\nFassung\nAnwendungsveröffentlichungen\nProzesse im Datenpfad\n\n\n\n\nvermittelt (Schritt 18)\n4\n5\n\n\nkonfigurierbarer Vermittler (Schritt 27)\n4\n5\n\n\ndynamisch (Schritt 38)\n2\n3",
"crumbs": [
"<span class='chapter-number'>6</span>  <span class='chapter-title'>[Part V — Replay the dynamic idea across processes]{.en}[Partie V — Rejouer l'idée dynamique entre processus]{.fr}[Teil V — Die dynamische Idee über Prozesse hinweg wiederholen]{.de}</span>"
]
},
{
"objectID": "06-part-vi-vocabulary.html",
"href": "06-part-vi-vocabulary.html",
"title": "7  Teil VI — Über Syncthing wiederholen und die Nachrichten benennen",
"section": "",
"text": "7.1 Der verteilte dynamische Lauf\nDie Schritte 39 bis 47 verteilen die dynamische Fassung auf zwei Maschinen, sagen genau, was „direkt” bedeutet, und geben dann — erst jetzt, nachdem die Ideen benutzt wurden — den drei Nachrichtenarten ihre Namen: Intent, Status, Event.\nSensor auf einer Maschine, ROT13 und der Aktor auf der anderen, nirgends ein Vermittler. Nachdem die zwei TOPIC-Intents repliziert waren, erzeugte eine getippte Zeile das Ergebnis auf der anderen Maschine — und das Brett zeigt die Kosten:\nSpannend war die Zeit. Die Eingabe wurde um 02:35:12 veröffentlicht, die Ergebnisse erschienen auf der ersten Maschine um 04:11:28,797 und ,893 — 96 ms auseinander, lange nach der Eingabe. Syncthing war über Nacht überlastet; der Stapel kam, als die Warteschlange abfloss. Die Kette war durchgehend korrekt; die Latenz des Transports steuert die Architektur nicht. Zum Vergleich: 24 ms für dieselbe Kette auf einer Maschine.",
"crumbs": [
"<span class='chapter-number'>7</span>  <span class='chapter-title'>[Part VI — Replay it over Syncthing, and name the messages]{.en}[Partie VI — Rejouer sur Syncthing, et nommer les messages]{.fr}[Teil VI — Über Syncthing wiederholen und die Nachrichten benennen]{.de}</span>"
]
},
{
"objectID": "06-part-vi-vocabulary.html#sec-distributed-dynamic",
"href": "06-part-vi-vocabulary.html#sec-distributed-dynamic",
"title": "7  Teil VI — Über Syncthing wiederholen und die Nachrichten benennen",
"section": "",
"text": "consoleIn/outbox: die Eingabe;\nrot13/outbox: das Ergebnis, geschrieben von dem Dienst, der es erzeugt hat;\nconsoleOut/inbox: nur Intent, wo die vermittelte Fassung eine vollständige Kopie jeder Nachricht hielt.",
"crumbs": [
"<span class='chapter-number'>7</span>  <span class='chapter-title'>[Part VI — Replay it over Syncthing, and name the messages]{.en}[Partie VI — Rejouer sur Syncthing, et nommer les messages]{.fr}[Teil VI — Über Syncthing wiederholen und die Nachrichten benennen]{.de}</span>"
]
},
{
"objectID": "06-part-vi-vocabulary.html#sec-direct-precisely",
"href": "06-part-vi-vocabulary.html#sec-direct-precisely",
"title": "7  Teil VI — Über Syncthing wiederholen und die Nachrichten benennen",
"section": "7.2 Was „direkt” genau bedeutet",
"text": "7.2 Was „direkt” genau bedeutet\nZwei Sprünge, die gleich aussehen, sind architektonisch Gegensätze:\n\nein Transportsprung — Syncthing auf jeder Seite, möglicherweise ein Relay dazwischen — fügt keinen Beteiligten hinzu, der die Topologie kennt, und nichts reagiert darauf. Liefen die Pakete über einen anderen Kontinent, widerspräche das keiner Aussage hier.\nein architektonischer Sprung — ein Vermittler, der consoleIn/outbox → rot13/inbox kopiert — fügt eine Komponente hinzu, die beide Namen kennen muss, in der Verfügbarkeitskette steht und die Nachricht erneut veröffentlicht.\n\nDie vertretbare Aussage lautet daher: ROT13 reagiert auf ConsoleIns Veröffentlichung, ohne eine unserer Komponenten dazwischen und ohne ConsoleIns Identität zu enthalten. Nicht: die Daten gehen direkt von A nach B. Die Architektur bestimmt, auf welche Nachrichten ein Dienst reagiert, nicht die Wegewahl des Transports.",
"crumbs": [
"<span class='chapter-number'>7</span>  <span class='chapter-title'>[Part VI — Replay it over Syncthing, and name the messages]{.en}[Partie VI — Rejouer sur Syncthing, et nommer les messages]{.fr}[Teil VI — Über Syncthing wiederholen und die Nachrichten benennen]{.de}</span>"
]
},
{
"objectID": "06-part-vi-vocabulary.html#sec-ise",
"href": "06-part-vi-vocabulary.html#sec-ise",
"title": "7  Teil VI — Über Syncthing wiederholen und die Nachrichten benennen",
"section": "7.3 Intent, Status, Event",
"text": "7.3 Intent, Status, Event\nDrei Nachrichtenarten, benannt erst nach ihrem Gebrauch:\n\n\n\n\n\n\n\n\n\nsagt\nunsere Beispiele\n\n\n\n\nE — Event\netwas ist geschehen\nTEXT hello als ConsoleIn/E/text; TEXT uryyb als ROT13/E/crypted\n\n\nS — Status/State\netwas ist gerade wahr\nROT13/S/subscriptions — von unserem System noch nicht veröffentlicht\n\n\nI — Intent\nwas geschehen soll\nTOPIC consoleIn/outbox, ROUTE … …\n\n\n\nVergangenheitsform ist ein nützlicher Hinweis für Events. Für Intent lautet der Test zwei Fragen: berichtet die Nachricht etwas Geschehenes? Nein. Etwas gerade Wahres? Nein. Dann verlangt sie Verhalten.\nEine Falle: einen Intent zu veröffentlichen ist natürlich etwas Geschehenes. Eingeordnet wird nach dem, was die Nachricht sagt, nicht nach ihrer Existenz — sonst wird alles zum Event und das Vokabular nützt nichts mehr.\nStatus verdient eine eigene Anmerkung, denn der Instinkt ist, ihn zu erfragen: „welche Abonnements hast du?” Doch Fragen ist ein Aufruf, und ein Aufruf verlangt, dass der Fragende die Komponente kennt, sie als laufend weiss und wartet. Status wird veröffentlicht: ROT13 veröffentlicht ROT13/S/subscriptions, sobald sich seine Verdrahtung ändert, und wer will, liest es. Der Leser braucht dann ein Topic, keine Komponente, und ROT13 erfährt nie, wer es prüft. Jede Art beantwortet eine andere Frage:\n\nein Event nützt nur, wenn man zuhörte — unsere liegengebliebenen Nachrichten, dreimal;\nein Status ist, was ein Neuankömmling braucht: der aktuelle Wert, ohne Geschichte nachzuspielen;\nein Intent verlangt eine Änderung.\n\nUnd Kommandos sind nicht verboten. ROT13/I mit ACTION Hello zu senden ist kommandoartig, und das Urteil des Materials lautet „Fine.” Die Komponente übt ihre Fähigkeit aus und veröffentlicht ihre Events und ihren Status. Der empfohlene Fluss ist Intent → Komponente → State + Events.",
"crumbs": [
"<span class='chapter-number'>7</span>  <span class='chapter-title'>[Part VI — Replay it over Syncthing, and name the messages]{.en}[Partie VI — Rejouer sur Syncthing, et nommer les messages]{.fr}[Teil VI — Über Syncthing wiederholen und die Nachrichten benennen]{.de}</span>"
]
},
{
"objectID": "06-part-vi-vocabulary.html#sec-one-writer",
"href": "06-part-vi-vocabulary.html#sec-one-writer",
"title": "7  Teil VI — Über Syncthing wiederholen und die Nachrichten benennen",
"section": "7.4 Die Ein-Schreiber-Regel",
"text": "7.4 Die Ein-Schreiber-Regel\n\nJede schreibbare Ressource hat genau eine Schreibautorität.\n\nNicht zu verwechseln mit der UUID im Dateinamen. Die UUID verhindert, dass zwei Veröffentlichungen denselben physischen Namen wählen; die Schreibautorität sagt, welche Komponente eine logische Event- oder Status-Ressource besitzt. Zwei Schreiber kollidieren nie bei einem Dateinamen — genau deshalb wird das Problem leicht übersehen.\nWas ein zweiter Schreiber kostet: der Postfachname war der einzige Herkunftsnachweis, also bedeutet rot13/outbox nicht mehr „ROT13 hat dies transformiert”, und ein Abonnent kann dem Vertrag nicht mehr trauen, auf dem er aufbaut. Für Status ist es schlimmer — zwei Komponenten, die je den aktuellen Wert eines Faktes zu veröffentlichen behaupten, widersprechen sich, ohne Reihenfolgegarantie zwischen Maschinen, die entscheiden könnte. Bei append-only Events koexistieren viele Veröffentlichungen absichtlich; die Frage ist semantischer Besitz, nicht Kollision. Treten zwei Autoritäten auf, frage nach dem Warum, statt zum Lock zu greifen.",
"crumbs": [
"<span class='chapter-number'>7</span>  <span class='chapter-title'>[Part VI — Replay it over Syncthing, and name the messages]{.en}[Partie VI — Rejouer sur Syncthing, et nommer les messages]{.fr}[Teil VI — Über Syncthing wiederholen und die Nachrichten benennen]{.de}</span>"
]
},
{
"objectID": "07-part-vii-mediation.html",
"href": "07-part-vii-mediation.html",
"title": "8  Teil VII — Die zwei architektonischen Ideen zusammenführen",
"section": "",
"text": "8.1 Ein Transformator verdient seine Existenz\nZwei Vermittler wurden entfernt und der Gewinn gemessen. Die Schritte 48 bis 52 beantworten die naheliegende nächste Frage: ist Vermittlung damit falsch? Nein — und die entscheidende Unterscheidung ist scharf genug, um sie auf einen fremden Entwurf anzuwenden.\nEntfernt wurde ein Vermittler, der A → A berechnete: eine teure Identitätsfunktion in der Verfügbarkeitskette, die jede Nachricht ohne Bedeutungsgewinn kopierte.\nNun ein Produzent, der {\"value\":\"Hello\"} veröffentlicht, und ein Konsument, der eine Anzeigestruktur erwartet. Ein TextToDisplayTransformer dazwischen leistet Schematransformation, semantische Anpassung, möglicherweise Einheitenumrechnung, möglicherweise Aggregation. Das ist Arbeit, die keine der beiden Seiten besitzen sollte: ROT13 hat nicht über Terminalfarben zu entscheiden, und die Konsole hat die Nutzlastform von ROT13 nicht zu verstehen.\nDie Grenze zieht die Vertragskompatibilität, nicht die Frage, ob etwas hinzukommt. Ein Vermittler, der Celsius in Fahrenheit umrechnet, ändert statt hinzuzufügen und hat seinen Platz verdient; einer, der einer schon verstandenen Nachricht einen Zeitstempel anhängt, hat etwas hinzugefügt und bleibt verdächtig. Die Frage ist immer: könnte der Konsument die Nachricht des Produzenten so lesen, wie sie ist?",
"crumbs": [
"<span class='chapter-number'>8</span>  <span class='chapter-title'>[Part VII — Now merge the two architectural ideas]{.en}[Partie VII — Fusionner les deux idées architecturales]{.fr}[Teil VII — Die zwei architektonischen Ideen zusammenführen]{.de}</span>"
]
},
{
"objectID": "07-part-vii-mediation.html#sec-transformer",
"href": "07-part-vii-mediation.html#sec-transformer",
"title": "8  Teil VII — Die zwei architektonischen Ideen zusammenführen",
"section": "",
"text": "Versteht ein Konsument die Veröffentlichung eines Produzenten semantisch, genügt direktes Abonnieren oft. Sind die Verträge inkompatibel, führe einen Transformator ein, der eine echte Anpassung leistet.\nEin Vermittler, der nur kompatible Daten weiterleitet, ist verdächtig. Ein Vermittler, der nötige Semantik hinzufügt, hat seine Existenz verdient.",
"crumbs": [
"<span class='chapter-number'>8</span>  <span class='chapter-title'>[Part VII — Now merge the two architectural ideas]{.en}[Partie VII — Fusionner les deux idées architecturales]{.fr}[Teil VII — Die zwei architektonischen Ideen zusammenführen]{.de}</span>"
]
},
{
"objectID": "07-part-vii-mediation.html#sec-egoistic-transformer",
"href": "07-part-vii-mediation.html#sec-egoistic-transformer",
"title": "8  Teil VII — Die zwei architektonischen Ideen zusammenführen",
"section": "8.2 Auch der Transformator ist egoistisch",
"text": "8.2 Auch der Transformator ist egoistisch\nIn die Kette eingefügt, abonniert der Transformator rot13/outbox und veröffentlicht in sein eigenes Ausgangspostfach; ConsoleOut abonniert dann dieses statt das von ROT13. Was das an Code kostet: nichts. ConsoleOut erhält einen anderen Intent — TOPIC display/outbox statt TOPIC rot13/outbox — und die Kette ist umverdrahtet. ROT13 erfährt nie, dass der Transformator existiert; der Transformator nie, dass ConsoleOut existiert.\nWarum nicht direkt in consoleOut/inbox veröffentlichen und ein Postfach sparen? Vier Gründe:\n\nWissen — er enthielte ConsoleOuts Namen, also Topologie in einem Dienst, der Rückfall von Schritt 28;\nBesitz — dieses Postfach ist ConsoleOuts Steuerkanal, geschrieben vom Konfigurator; Nutzlast vom Transformator gäbe ihm zwei Autoritäten;\nReichweite — sein eigenes Ausgangspostfach kann ein Logger, eine Webansicht oder ein zweites Display kostenlos lesen, während ein Eingangspostfach genau einen Konsumenten bedient;\nVeränderbarkeit — ein Aggregator lässt sich danach durch einen anderen Intent einfügen, ohne eine Komponente zu ändern.",
"crumbs": [
"<span class='chapter-number'>8</span>  <span class='chapter-title'>[Part VII — Now merge the two architectural ideas]{.en}[Partie VII — Fusionner les deux idées architecturales]{.fr}[Teil VII — Die zwei architektonischen Ideen zusammenführen]{.de}</span>"
]
},
{
"objectID": "07-part-vii-mediation.html#sec-complete-filesystem",
"href": "07-part-vii-mediation.html#sec-complete-filesystem",
"title": "8  Teil VII — Die zwei architektonischen Ideen zusammenführen",
"section": "8.3 Die vollständige Dateisystem-Architektur",
"text": "8.3 Die vollständige Dateisystem-Architektur\nJedes Postfach mit genau einem Schreiber:\n\n\n\n\n\n\n\nPostfach\neinziger Schreiber\n\n\n\n\nconsoleIn/outbox\nSensorService\n\n\nrot13/outbox\nProcessorService\n\n\ndisplay/outbox\nder Transformator\n\n\njedes Steuerpostfach\nder Konfigurator — die eine bestimmte Intent-Autorität\n\n\ndas Terminal\nActuatorService, der kein Postfach schreibt\n\n\n\nEgoistische Fähigkeiten, Intent aus einer Autorität, ein Transformator nur dort, wo Verträge sich unterscheiden, ein Schreiber pro Ressource, und die Topologie nirgends in den Fähigkeiten. Das ist der Entwurf, den das Dateisystem gut genug war zu lehren — und der nächste Teil fragt, wofür das Dateisystem selbst nicht mehr gut genug ist.",
"crumbs": [
"<span class='chapter-number'>8</span>  <span class='chapter-title'>[Part VII — Now merge the two architectural ideas]{.en}[Partie VII — Fusionner les deux idées architecturales]{.fr}[Teil VII — Die zwei architektonischen Ideen zusammenführen]{.de}</span>"
]
},
{
"objectID": "08-part-ix-mqtt.html",
"href": "08-part-ix-mqtt.html",
"title": "9  Teil IX — MQTT",
"section": "",
"text": "9.1 Was das Dateisystem gelehrt hat und wofür es nicht taugt\nDas Dateisystem lehrte Veröffentlichungsgrenzen, Verzeichnisse als Adressen, Beobachtung, unabhängige Prozesse, unabhängige Sprachen, Synchronisationslatenz, Verdrahtung zur Laufzeit, State, Intent, Events, Vermittlerkosten, Dienstbesitz und Transformatordienste. Es war ein guter Lehrer und ist kein eleganter Nachrichten-Broker: am Ende war die Architektur sauber und der Transport ein Haufen .tmp-Dateien, atomarer Verschiebungen, erneuter Scans, geteilter Pfade und Replikationsverzögerung.\nDie Schlussfolgerung ist nicht „Dateien schlecht, MQTT gut”. Das Dateisystem hat einen Vorteil, den MQTT nicht erreicht — es speichert routinemässig Gigabytes bis Terabytes, während Broker und Clients für kleine Nachrichten gebaut sind, und das Stückeln einer riesigen Nutzlast über MQTT heisst, ein Dateitransferprotokoll in einem Nachrichtenprotokoll zu erfinden. Also:\nEin repliziertes Dateisystem gibt zudem jeder Maschine eine lokale Kopie, eine echte Stärke — doch Replikation ist kein Backup: Löschungen und Beschädigungen replizieren mit, sofern nicht eine Versionierung ältere Kopien bewahrt.",
"crumbs": [
"<span class='chapter-number'>9</span>  <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
]
},
{
"objectID": "08-part-ix-mqtt.html#sec-filesystem-verdict",
"href": "08-part-ix-mqtt.html#sec-filesystem-verdict",
"title": "9  Teil IX — MQTT",
"section": "",
"text": "Nachrichten für Koordination und Ereignisse. Für grosse Daten ein passender Datei- oder Objektspeicher. Eine Nachricht kann Ort, Identität und Metadaten dieser Daten tragen statt der Terabytes selbst.",
"crumbs": [
"<span class='chapter-number'>9</span>  <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
]
},
{
"objectID": "08-part-ix-mqtt.html#sec-mqtt-mapping",
"href": "08-part-ix-mqtt.html#sec-mqtt-mapping",
"title": "9  Teil IX — MQTT",
"section": "9.2 MQTT sollte vertraut wirken",
"text": "9.2 MQTT sollte vertraut wirken\n\n\n\nDateisystem / Syncthing\nMQTT\n\n\n\n\nWurzel des synchronisierten Nachrichtenbretts\nBroker / Namensraum\n\n\nVerzeichnispfad\nTopic\n\n\n.msg-Datei\nVeröffentlichung\n\n\nDateiinhalt\nNutzlast\n\n\nWatchService\nAbonnement\n\n\ndynamisches Verzeichnis\nTopic / Filter\n\n\nSteuerverzeichnis\nI\n\n\nZustandsverzeichnis\nS/…\n\n\nEreignisverzeichnis\nE/…\n\n\n\nDie gewünschte Reaktion des Materials: „Ach. Diese Architektur kennen wir schon.” MQTT ist ein Transportwechsel, keine architektonische Aussage.\nZwei Dinge, die ein Verzeichnis nicht konnte, in einer Minute auf der Kommandozeile sichtbar. Eine Veröffentlichung vor der Existenz eines Abonnenten erreicht ihn nie — die Lehre der liegengebliebenen Nachrichten zum dritten Mal, nun mit einer Antwort, die das Dateisystem nie hatte. Und ein Filter wie test/# passt auf test/a und test/a/b/c, nicht aber auf testing/x, weil # auf Ebenen arbeitet, nicht auf Zeichenpräfixen; test/+ passte nur eine Ebene tief.\nDie tiefere Korrektur: ein Topic ist kein Behälter. Es gibt kein Objekt namens test/a auf dem Broker. Ein Topic ist ein Routing-Schlüssel, den jede Veröffentlichung trägt und der gegen die Filter derjenigen geprüft wird, die in diesem Moment abonniert haben. Verzeichnisse halten Nachrichten; Topics vergleichen sie. Ein Abonnement deckt daher Topics ab, die noch nicht existieren — wo ein Nachrichtenbrett ein neues Verzeichnis und eine neue Registrierung brauchte.",
"crumbs": [
"<span class='chapter-number'>9</span>  <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
]
},
{
"objectID": "08-part-ix-mqtt.html#sec-paho",
"href": "08-part-ix-mqtt.html#sec-paho",
"title": "9  Teil IX — MQTT",
"section": "9.3 Die Bibliothek, die Client-ID und die Broker-Adresse",
"text": "9.3 Die Bibliothek, die Client-ID und die Broker-Adresse\nJava hat keinen MQTT-Client in der Standardbibliothek, also kommt Paho jetzt — nach dem Bedarf, wie der Vermittler in Schritt 7 und Jackson in Schritt 64. Vier Dinge braucht man: verbinden, veröffentlichen, abonnieren, Rückruf. Das Verbinden ist absichtlich unspektakulär: „Hier ist architektonisch nichts geschehen. Wir haben unseren Prozess nur an den Transport angeschlossen.”\nZwei Details des Verbindens haben Gewicht:\n\ndie Client-ID ist nicht bloss ein Eindeutigkeitsmerkmal. Der Broker erkennt daran einen zurückkehrenden Client und hält Sitzungszustand für ihn: Abonnements, bei QoS &gt; 0 eingereihte Nachrichten und die Verknüpfung mit seinem Last Will. Ein Verzeichnis wusste nie, wer es beobachtete — genau deshalb spielte ein neu gestarteter Beobachter nichts nach.\ndie Broker-Adresse ist Deployment-Konfiguration: jedes Programm liest System.getProperty(\"mqtt.broker\", \"tcp://localhost:1883\"). Sie ist auch die einzige Konfiguration, die nicht als Intent kommen kann, denn Intent reist durch den Broker. Topologie lässt sich veröffentlichen; die Adresse des Veröffentlichenden nicht.\n\nAbonnieren kostet ein Paket, und der Broker führt die Abonnementliste. Es gibt keinen Standardweg, ihn zu fragen, was ein anderer Client abonniert hat — daher S/subscriptions: die eigene Erklärung einer Komponente über ihre Verdrahtung, veröffentlicht, damit die Architektur weiss, was der Transport privat hält. Nur ihr Eigentümer darf sie veröffentlichen, nach der Ein-Schreiber-Regel, denn nur er weiss, was er angenommen hat.",
"crumbs": [
"<span class='chapter-number'>9</span>  <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
]
},
{
"objectID": "08-part-ix-mqtt.html#sec-structured-intent",
"href": "08-part-ix-mqtt.html#sec-structured-intent",
"title": "9  Teil IX — MQTT",
"section": "9.4 Strukturierter Intent und zwei Mapper",
"text": "9.4 Strukturierter Intent und zwei Mapper\nTOPIC some/path hat ein Feld und eine Bedeutung. Es kann nicht sagen, welche Art Intent vorliegt, keinen zweiten Parameter tragen, nicht verschachteln, nicht erweitert werden; und ein Empfänger hat nichts, wogegen er prüfen könnte. Reicherer Intent braucht Struktur:\nsubscribe:\n topic: Demo/ConsoleIn/U/alice/E/text\nErst dann hat eine Serialisierungsbibliothek eine klare Aufgabe. JsonTools hält zwei Mapper, und die Asymmetrie ist Absicht:\n\ndas Lesen nutzt eine YAML-Factory mit abgeschaltetem FAIL_ON_UNKNOWN_PROPERTIES — JSON ist eine Teilmenge von YAML, handgetippter Intent wird akzeptiert, und ein neuerer Konfigurator darf Felder senden, die ein älterer Dienst ignoriert;\ndas Schreiben nutzt strenges JSON mit INDENT_OUTPUT, die veröffentlichten Nutzlasten sind also streng und lesbar.\n\nTolerant hinein, streng hinaus. Ein einziger Mapper müsste auf eines davon verzichten.",
"crumbs": [
"<span class='chapter-number'>9</span>  <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
]
},
{
"objectID": "08-part-ix-mqtt.html#sec-duise",
"href": "08-part-ix-mqtt.html#sec-duise",
"title": "9  Teil IX — MQTT",
"section": "9.5 DUISE und das Umverdrahten im Betrieb",
"text": "9.5 DUISE und das Umverdrahten im Betrieb\nDas Namensschema erhält endlich seinen Namen: Description (welche Verträge dieser Dienst versteht und veröffentlicht), Unit (welche Instanz), Intent (gewünschtes Verhalten), Status (was jetzt gilt), Event (was geschehen ist).\nDemo/ROT13/U/alice/{I, S/online, S/subscriptions/text, E/crypted}\nU/&lt;unit&gt; brauchte das Dateisystem nie: jede Maschine hatte ihr eigenes Replikat desselben relativen Pfades, Instanzidentität war implizit. MQTT hat einen gemeinsamen Namensraum, ein Topic muss also sagen, welche Kopie. U/alice in einer Fähigkeit festzuschreiben ist daher schlimmer, als consoleIn.outbox es je war: es bindet das Build an ein Deployment. Per Intent konfiguriert, dient ein Build allen — daher die drei Unit-Namen als Argumente von MqttConfigure. Die Unit-Namen sind die Topologie.\nUmverdrahten, am laufenden System beobachtet: einen neuen Intent mit anderer Quelle veröffentlichen, und der Dienst kündigt die alte, abonniert die neue und veröffentlicht S/subscriptions passend neu. Kein Neustart, keine Änderung. Schickt man stattdessen einen ungültigen Filter — Demo/#/E/text, wo # nicht die letzte Ebene ist — weist MqttTools.isValidFilter ihn ab; das alte Abonnement bleibt, und der Status sagt weiter die Wahrheit.\nDiese Abweisung legt eine echte Lücke offen, die man benennen und nicht verstecken sollte: sie wird nur lokal protokolliert. Der Konfigurator erfährt nicht, ob sein Intent angewandt oder abgelehnt wurde, und ein Monitor kann „abgelehnt” nicht von „noch nicht verarbeitet” unterscheiden. In diesem Entwurf erfährt ein Sender das Ergebnis, indem er den Status liest und mit seiner Anfrage vergleicht. Abweisungen als Event zu veröffentlichen oder ein Letzter-Fehler-Status würden die Lücke schliessen; beides steht nicht im Material — es ist eine zu begründende Entwurfsentscheidung.",
"crumbs": [
"<span class='chapter-number'>9</span>  <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
]
},
{
"objectID": "08-part-ix-mqtt.html#sec-retained-and-will",
"href": "08-part-ix-mqtt.html#sec-retained-and-will",
"title": "9  Teil IX — MQTT",
"section": "9.6 Was ein neuer Abonnent erfährt und was ein Toter zugibt",
"text": "9.6 Was ein neuer Abonnent erfährt und was ein Toter zugibt\nDrei Sekunden Demo/# abonnieren, ohne dass etwas veröffentlicht wird, ergibt dies:\nDemo/ROT13/U/nitro5/S/online {\"value\":true}\nDemo/ROT13/U/nitro5/S/subscriptions/text \"Demo/ConsoleIn/U/nitro5/E/text\"\nDemo/ConsoleOut/U/nitro5/S/online {\"value\":true}\nDemo/ConsoleOut/U/nitro5/S/subscriptions/text \"Demo/ROT13/U/nitro5/E/crypted\"\nEin Spätankömmling erfährt augenblicklich die gesamte aktuelle Verdrahtung des Systems, ohne jemanden zu fragen und ohne dass eine Komponente von einem Monitor weiss. Das ist retained Status. Keine Events kommen an, denn Events werden nicht retained veröffentlicht — „retained State, nicht retained Events”. Es ist auch die richtige Antwort auf den Reflex, einen Dienst zu fragen, was er tut: niemand fragt; der Dienst erklärt es einmal, und der Broker bewahrt es für jeden, der kommt.\nRetained Status allein würde allerdings lügen. Beendet man einen Dienst mit Ctrl+C, bleibt sein S/online = true für immer beim Broker. Daher der Last Will, bei der Verbindung registriert:\nvar will = new MqttMessage(\"{\\\"value\\\":false}\".getBytes(UTF_8), 1, true, new MqttProperties());\noptions.setWill(lastWillTopic, will);\nDer Will ist retained, ersetzt also beim Veröffentlichen durch den Broker das veraltete true. Die Komponente, die ausfällt, ist nicht die, die den Ausfall meldet — die einzige Anordnung, die funktionieren kann. Ein Vorbehalt: ein sauberes DISCONNECT löst keinen Will aus; ein gut erzogener Dienst veröffentlicht daher beim Beenden selbst online=false, und der Will deckt die hässlichen Tode.",
"crumbs": [
"<span class='chapter-number'>9</span>  <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
]
},
{
"objectID": "08-part-ix-mqtt.html#sec-coupling-remains",
"href": "08-part-ix-mqtt.html#sec-coupling-remains",
"title": "9  Teil IX — MQTT",
"section": "9.7 Was den Transport überlebte und welche Kopplung bleibt",
"text": "9.7 Was den Transport überlebte und welche Kopplung bleibt\nDie untere Hälfte der Tabelle Dateisystem→MQTT ist der Punkt: I, S, E, egoistische Dienste, Topologie zur Laufzeit und „Transformator wenn nötig” sind unverändert. Die Architektur überlebte den Transportwechsel, und das ist der stärkste verfügbare Beleg, dass sie nie am Transport hing.\nLose Kopplung heisst nicht, dass nichts etwas weiss. Notwendig bleibt die Einigkeit über: Nachrichtensyntax, Nachrichtensemantik, Topic-Verträge, Intent, Besitz, Bedeutung von State und Bedeutung von Events. Ziel ist nicht, Kopplung zu beseitigen, sondern unnötiges Wissen zu beseitigen. Konkret muss hier jeder Dienst genau einen fremden Event-Vertrag verstehen — ROT13 den E/text von ConsoleIn, ConsoleOut den E/crypted von ROT13 — plus das Intent-Schema, das er auf seinem eigenen I annimmt. Diese Liste ist das unverzichtbare Minimum.\nDavon getrennt: der Broker ist eine geteilte Infrastrukturabhängigkeit; alle brauchen seine Adresse, und ohne ihn läuft nichts. Real, aber anderer Art als das Wissen einer Komponente über eine andere.\nDie Prüfliste aus Schritt 78 ist das Werkzeug, das bleibt. Zwölf Fragen, von denen diese sechs das Argument dieses Systems tragen:\n\n\n\n\n\n\n\nFrage\nAntwort hier\n\n\n\n\nenthält eine Fähigkeit eine festgeschriebene Produzentenidentität?\nnein — sie kommt als Intent\n\n\nwelche fremden Verträge muss sie verstehen?\nje einen Event-Vertrag, plus ihr eigenes Intent-Schema\n\n\nwo ist die Topologie definiert?\nim Konfigurator, ausserhalb des Datenpfads\n\n\nkann sich die Topologie ohne Neukompilieren ändern?\nja — am laufenden System gezeigt\n\n\nkönnte der Transport ersetzt werden?\nja — gezeigt: Dateisystem, dann MQTT\n\n\nleistet jeder Vermittler etwas, das Vermittlung braucht?\nja, trivial: TEXT → TEXT braucht keine, und es gibt keinen\n\n\n\nDie Mahnung des Materials gilt: die Antworten müssen nicht alle „nein” lauten. Sie müssen absichtlich sein.",
"crumbs": [
"<span class='chapter-number'>9</span>  <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
]
},
{
"objectID": "08-part-ix-mqtt.html#sec-whole-journey",
"href": "08-part-ix-mqtt.html#sec-whole-journey",
"title": "9  Teil IX — MQTT",
"section": "9.8 Der ganze Weg",
"text": "9.8 Der ganze Weg\nDas Programm hat sich nie geändert: eine Zeile geht hinein, dieselbe kommt um 13 Buchstaben verschoben heraus. Geändert hat sich, elfmal, wie die Teile verbunden sind und wer das Wissen über diese Verbindung hält.\n\n\n\n\n\n\n\n\n\nStufe\nwie die Teile verbunden sind\nwo die Topologie liegt\nim Datenpfad ausser den Fähigkeiten\n\n\n\n\n1 prozedural\ndirekte Aufrufe\nim Code der Fähigkeit\n—\n\n\n2 egoistische Dienste\ngar nicht verbunden\nnirgends — das ist das Problem\n—\n\n\n3 statische Vermittlung, eine JVM\nPostfächer, von Vermittlern kopiert\ndie Vermittler, gestartet in main()\nzwei Vermittler\n\n\n4 statische Vermittlung, Dateisystem\nVerzeichnisse, von Vermittlerprozessen kopiert\ndie Befehlszeilen des Bedieners\nzwei Vermittlerprozesse\n\n\n5 statische Vermittlung, Syncthing\nreplizierte Verzeichnisse\ndie Befehlszeilen des Bedieners\nzwei Vermittlerprozesse, dazu Replikationsverzögerung\n\n\n6 benannte, konfigurierbare Vermittler\nROUTE-Intent von einem Orchestrator\nder Orchestrator, ausserhalb des Pfads\nweiterhin die Vermittler\n\n\n7 dynamisch, eine JVM\ndie Dienste hören selbst, gesteuert durch TOPIC-Intent\nder Konfigurator\nnichts\n\n\n8 dynamisch, Dateisystem\ndasselbe, über Verzeichnisse\nder Konfigurator\nnichts\n\n\n9 dynamisch, Syncthing\ndasselbe, über replizierte Verzeichnisse\nder Konfigurator\nnichts — nur Transportsprünge\n\n\n10 Verträge\nkompatibel: direkt; inkompatibel: ein Transformator\nder Konfigurator\nein Transformator, nur wo Verträge sich unterscheiden\n\n\n11 MQTT\nTopics auf einem Broker\nder Konfigurator\nnichts — der Broker ist Transport\n\n\n\nDie dritte Spalte von oben nach unten gelesen: die Topologie wandert nach aussen, Stufe um Stufe, bis keine Fähigkeit mehr etwas davon hält. Die letzte gelesen: der Preis dieser Wanderung fällt in Stufe 7 auf null und bleibt dort, während darunter dreimal der Transport wechselt. Dieselbe Architektur, besserer Transport.",
"crumbs": [
"<span class='chapter-number'>9</span>  <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
]
},
{
"objectID": "08-part-ix-mqtt.html#sec-sentences",
"href": "08-part-ix-mqtt.html#sec-sentences",
"title": "9  Teil IX — MQTT",
"section": "9.9 Die Sätze, die man behalten sollte",
"text": "9.9 Die Sätze, die man behalten sollte\n\n„Event-driven” beschreibt, wie Information und Steuerung fliessen.\nLose Kopplung beschreibt, wie viel die Beteiligten voneinander wissen müssen.\nVeröffentliche, was geschehen ist.\nErkläre, was du willst.\nVeröffentliche deinen eigenen Zustand.\nHalte Fähigkeiten egoistisch.\nHalte die Topologie aus den Fähigkeiten heraus.\nBezahle keinen Vermittler, der nicht wirklich vermittelt.\n\nUnd wann immer eine Architektur verwirrend wird, zurück zur ersten Frage dieses Buches: wer kennt wen?",
"crumbs": [
"<span class='chapter-number'>9</span>  <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
]
},
{
"objectID": "glossary.html",
"href": "glossary.html",