"""Worker-lokale Zustellschleife für die gemeinsame WebSocket-Queue. Jeder WSGI-Worker besitzt eigene WebSocket-Objekte. Die persistente Queue in ``ws_client_queue`` ist dagegen gemeinsam. Diese Schleife prüft regelmäßig, ob für die lokal verbundenen Clients Aufträge eingegangen sind, und stellt sie über den lokalen Broker zu. """ import threading from cmbnet.ws import broker class DeliveryWorker: def __init__(self, interval=0.5): self.interval = interval self.app = None self.running = False self._thread = None self._stop = threading.Event() def start(self, app=None, interval=None): if app is not None: self.app = app if interval is not None: self.interval = interval if self.running: return if self.app is None: return self.running = True self._stop.clear() self._thread = threading.Thread( target=self._run, name='cmbnet-ws-delivery', daemon=True ) self._thread.start() def stop(self): self.running = False self._stop.set() broker.delivery_wakeup.set() # Der Thread ist ein Daemon. Ein Join mit Timeout verhindert, dass # ein laufender Datenbankzugriff den Shutdown blockiert. if self._thread is not None: self._thread.join(timeout=2.0) self._thread = None def wake(self): broker.delivery_wakeup.set() def _run(self): # Ein App-Kontext für die gesamte Lebensdauer der Schleife hält die # SQLite-Verbindung dieses Threads offen. Bei einem Polling-Intervall # von 0,5 s wäre ein Verbindungsaufbau pro Runde unnötig teuer. with self.app.app_context(): while not self._stop.is_set() and self.running: try: broker.drain_local_clients() except Exception as exc: try: self.app.logger.warning( 'WS-Zustellschleife fehlgeschlagen: %s', exc ) except Exception: pass # Neue lokale Nachrichten wecken die Schleife sofort. Für # Nachrichten aus anderen Workern greift der reguläre Timeout. broker.delivery_wakeup.wait(self.interval) broker.delivery_wakeup.clear() delivery_worker = DeliveryWorker()