Umbau broekr auf client-id
This commit is contained in:
1 parent
268e150f2b
commit
a95204b8d6
17 files changed
+649
-388
No files matched your search
+21
-16
@@ -48,29 +48,34 @@ Clients den Header nicht selbst setzen können.
|
||||
|
||||
## WebSocket-Synchronisierung
|
||||
|
||||
Jeder Browser-Tab erzeugt eine Sitzungs-ID, die in `sessionStorage` gespeichert
|
||||
wird und ein Neuladen übersteht. Nicht zustellbare Nachrichten mit Code >= 100
|
||||
werden beim Broker pro `(Mandant, Account, Sitzungs-ID)` gepuffert und bei der
|
||||
nächsten WebSocket-Verbindung mit derselben ID ausgeliefert.
|
||||
Jede Webview erzeugt beim Laden einmalig eine Client-ID. Sie wird bewusst nicht
|
||||
in `sessionStorage` gespeichert: Ein Seiten-Reload erzeugt eine neue Client-ID
|
||||
und damit eine neue Broker-Verbindung. Nicht zustellbare Nachrichten mit
|
||||
Code >= 100 werden beim Broker pro `(Mandant, Client-ID)` gepuffert und bei der
|
||||
nächsten WebSocket-Verbindung mit derselben Client-ID ausgeliefert. Mehrere
|
||||
Clients desselben Accounts werden getrennt verwaltet und alle beliefert.
|
||||
|
||||
Die beiden Zeitfenster lassen sich über Umgebungsvariablen konfigurieren:
|
||||
Die Zeitfenster lassen sich über Umgebungsvariablen konfigurieren:
|
||||
|
||||
- `CMBNET_WS_QUEUE_MAX_AGE_MINUTES` (Default `15`): Maximales Alter einer
|
||||
Sitzungs-Queue. Ältere Queues werden verworfen; beim nächsten Reconnect wird
|
||||
stattdessen eine Code-99-Nachricht mit Hinweis auf die zu lange Unterbrechung
|
||||
zugestellt.
|
||||
Client-Queue. Ältere Queues werden verworfen; beim nächsten Reconnect mit
|
||||
derselben Client-ID wird stattdessen eine Code-99-Nachricht mit Hinweis auf
|
||||
die zu lange Unterbrechung zugestellt.
|
||||
- `CMBNET_WS_CLIENT_RETENTION_MINUTES` (Default `60`): Wie lange eine nicht mehr
|
||||
verbundene Webview samt Queue registriert bleibt, bevor der Broker sie
|
||||
endgültig aufräumt.
|
||||
- `CMBNET_WS_GROUP_ONLINE_TIMEOUT_SECONDS` (Default `120`): Zeit ohne Code-2-
|
||||
Lebenszeichen, nach der eine Gruppe von `online` auf `unterwegs` wechselt.
|
||||
- `CMBNET_WS_DEBUG_MESSAGES` (Default `1`): schreibt jede beim Broker
|
||||
eingehende Nachricht inklusive Absender, Code und ermitteltem Empfängerkreis
|
||||
nach `logs/cmbnet-ws-YYYY-MM-DD.log`. Mit `0` lässt sich die Ausgabe
|
||||
abschalten.
|
||||
eingehende Nachricht inklusive Absender, Client-ID, Code und ermitteltem
|
||||
Empfängerkreis nach `logs/cmbnet-ws-YYYY-MM-DD.log`. Mit `0` lässt sich die
|
||||
Ausgabe abschalten.
|
||||
|
||||
Die Sitzungs-Queues liegen im Arbeitsspeicher des Broker-Prozesses. Sie
|
||||
überstehen damit WebSocket-Unterbrechungen und Seiten-Reloads, nicht aber einen
|
||||
Neustart des Servers. Der mobile Client puffert zusätzlich ausgehende
|
||||
fachliche Nachrichten kurzzeitig lokal und sendet sie nach erfolgreicher
|
||||
Authentifizierung automatisch nach.
|
||||
Die Client-Queues liegen im Arbeitsspeicher des Broker-Prozesses. Sie
|
||||
überstehen damit kurze WebSocket-Unterbrechungen, nicht aber einen
|
||||
Seiten-Reload mit neuer Client-ID oder einen Neustart des Servers. Der mobile
|
||||
Client puffert zusätzlich ausgehende fachliche Nachrichten kurzzeitig im
|
||||
Speicher und sendet sie nach erfolgreicher Authentifizierung automatisch nach.
|
||||
|
||||
Eine ausführliche Beschreibung des Protokolls, der Brokerlogik, der
|
||||
Nebenläufigkeit und der aktuellen Abweichungen steht in
|
||||
|
||||
Reference in new issue
Block a user