Broker/Protocol Analyse
This commit is contained in:
1 parent
c477a05f03
commit
268e150f2b
7 files changed
+868
-2
No files matched your search
@@ -204,3 +204,38 @@ Ein Klick in dieses Textfeld soll einen modalen Dialog starten, in dem alle Nach
|
||||
|
||||
Entwickel für diese Views den Code für das Frontend und die notwendigen Anpassungen im Backend.
|
||||
------8<-----------------
|
||||
|
||||
|
||||
Die Logik des Brokers und das verwendete Protokoll soll auf korrekte Umsetzung untersucht werden.
|
||||
Der Broker hat die Aufgabe, die Verbindung zu allen Clients (Websockets) zu verwalten,
|
||||
Nachrichten entsprechend dem Protokoll von einem Client zu mehreren anderen Clients weiterzuleiten und
|
||||
kurzzeitige Unterbrechungen in der Verbindung zu einem Client mit einer Nachrichten-Queue zu überbrücken.
|
||||
Dabei muss Nebenläufigkeit berücksichtigt werden.
|
||||
Welche Nachrichten konkret einem bestimmten Client weitergeleitet werden sollen, folgt aus der Rolle des jeweiligen Clients (also Account/View und eventuell Gruppenverknüpfung des Accounts)
|
||||
Clients können über entsprechende Nachrichten Änderungen im State einer der Entitäten Gruppe oder Strasse in der Datenbank auslösen.
|
||||
Gleichzeitig wird diese Zustandsänderung durch Weiterleitung an alle aktiven Clients kommuniziert.
|
||||
Um neu hinzukommende Clients zu synchronisieren, werden unabhängig vom Broker die aktuellen Zustände per Web API übermittelt,
|
||||
Die jeweiligen Websessions der Clients werden über Websocketverbindungsabbrüche hinweg anhand einer im Client generierten ID den entsprechenden Queues zugeordnet.
|
||||
Bei neuen Websessions (d.h. dem Broker noch unbekannten Client-ID's) werden für diesen Client grundsätzlich bestimmte in der Datenbank historisierte Nachrichten initial übermittelt.
|
||||
|
||||
Nachrichten werden im JSON-Format verschickt. Die Nachrichten müssen Sender und Empfänger enthalten. Sofern dazu ID's verwendet werden, müssen für die korrekte Darstellung im Client Accountname oder Aliasname mitgesendet werden.
|
||||
Primäres Merkmal jeder Nachricht ist der Nachrichten-Code, anhand dessen der Broker über die Weiterleitung entscheidet.
|
||||
Nachfolgend die Beschreibug der Nachrichtencodes soweit bekannt:
|
||||
- Code=0: Sender ist jeder Client nach Neuladen, mit dem ein Zugriffstoken und die Client-ID zur Authentifizierung dem Broker mitgeteilt wird. Keine weiteren Empfänger. Nur intern für den Broker zur Verwendung.
|
||||
- Code=1: Sender ist der Broker selbst, der zyklisch (1/Minute) jeden Client ein "ping" sendet und eine Antwort mit Code=2 vom Client erwartet.
|
||||
- Code=2: Sender ist ein Client als unmittelbare Antwort auf Code=1. Bleibt diese Nachricht aus, kann dies auf den State einer Gruppe Einfluss haben. In der Übersicht im Dashboard ddes Admins wird dies angezeigt.
|
||||
- Code=99: Sender ist der Broker selbst, ein Admin-Client oder bei Änderung der Account/Gruppen-Zuordnung ein Dispatcher. Die Nachricht wird immer an alle CLients gesendet und soll direkt oder indirekt einen Neustart des Clients auslösen (s.o.). Die Behandlung der Queues im Broker ist oben beschrieben.
|
||||
- Ein Code < 100 dient nur zu internen Zwecken.
|
||||
- Code=100: Sender kann ein Dispatcher oder eine Gruppe sein. Der State einer Straße hat sich geändert. Diese Nachricht wird an alle Accounts Dispatcher, Gast, Beobachter und die Gruppen verschickt, die mit dieser Straße verknüpft sind.
|
||||
- Code=200: Sender ist ein Dispatcher oder eine Gruppe. Diese Nachricht wird an alle Accounts Dispatcher, Beobachter und an die betroffene Gruppe geschickt.
|
||||
- Code=300: Sender ist eine Gruppe oder ein Dispatcher. Die geographische Position einer Gruppe hat sich geändert. Diese Nachricht wird an alle Accounts Dispatcher, Beobachter und an die betroffene Gruppe geschickt. Inhalt der Nachricht sind die neuen Geokoordinaten und dem auslösenden Account.
|
||||
- Ein Code >= 1000 soll immer in einer Chatansicht mit "Von -> An", dem Zeitstempel der Nachricht und dem Chat-Text angezeigt werden und dem Nutzer des Clients über einen Infodialog angezigt werden. Diese Nachrichten werden historisiert für einen (konfigurierbaren) Zeitraum (Default 8 Studen).
|
||||
- Code=1000: Sender ist ein Dispatcher. Die Nachricht wird an alle Accounts des Typs Dispatcher, Beobachter und alle Gruppen (Broadcast) übermittelt.
|
||||
- Code=1100: Sender ist ein Dispatcher. Die Nachricht wird an alle Accounts des Typs Dispatcher, Beobachter und die eine addressierte Gruppe gesender.
|
||||
- Code=2000: Sender ist en Client eines Gruppen-Accounts. Die Nachricht wird an alle Accounts des Typs Dispatcher und Beobachter und innerhalb der Gruppe übermittelt.
|
||||
|
||||
Bitte erstelle eine Beschreibung des Protokolls und der Brokerlogik im Markdownformatm in der Datei doc/broker.md. Ergänze eventuell fehlende Nachrichtentypen.
|
||||
Erläutere, an welchen Stellen die Beschreibung vom aktuellen Code-Stand abweicht.
|
||||
Bau in die Software eine Debugausgabe für die beim Broker eingehenden Nachrichten ein einschließlich einer Ausgabe, an welche Clients diese weitergeleitet werden soll.
|
||||
|
||||
------8<-----------------
|
||||
Reference in new issue
Block a user