TsgcWebSocketLoadBalancerServerMethoden › Ping

Ping Methode

Sendet einen WebSocket-Ping-Frame an jeden Client, der über den Load Balancer verbunden ist.

Syntax

procedure Ping(const aText: string = '');

Parameter

NameTypBeschreibung
aTextconst stringOptionale Payload, die im Ping-Frame mitgeführt wird; übergeben Sie einen leeren String, um einen Ping ohne Payload zu senden.

Hinweise

Ping iteriert die Liste der aktiven Verbindungen und sendet einen WebSocket-Ping-Frame an jeden mit dem Load Balancer verbundenen Client, wobei er zurückkehrt, sobald die Frames an die zugrunde liegenden Sockets übergeben wurden. Der Aufruf wird an jeden registrierten Backup-Server weitergeleitet, sodass Pings auch Clients erreichen, die auf Remote-Knoten gehostet werden. Es ist eine bequeme Möglichkeit, inaktive Verbindungen am Leben zu erhalten oder die Lebendigkeit zusätzlich zum automatischen HeartBeat-Mechanismus manuell zu prüfen. Wenn der HeartBeat-Timeout konfiguriert ist, schließt der Server jede Verbindung, die nicht innerhalb des Fensters antwortet; ohne Timeout ist der Aufruf "fire-and-forget" und alle Pong-Antworten werden asynchron über die Standard-Verbindungsereignisse zugestellt. Beim Schreiben ausgelöste Ausnahmen werden an OnException weitergeleitet.

Beispiel


oServer.Ping('keepalive');

Zurück zu Methoden