TsgcWebSocketLoadBalancerServer › Methoden › Ping
Verzendt een WebSocket-pingframe naar elke client die via de load balancer is verbonden.
procedure Ping(const aText: string = '');
| Naam | Type | Beschrijving |
|---|---|---|
aText | const string | Optionele payload in het ping-frame; geef een lege tekenreeks door om een ping zonder payload te verzenden. |
Ping itereert de actieve verbindingslijst en stuurt een WebSocket-ping-frame naar elke client gekoppeld aan de load balancer, en keert terug zodra de frames zijn doorgegeven aan de onderliggende sockets. De aanroep wordt doorgestuurd naar elke geregistreerde back-upserver zodat pings clients bereiken die worden gehost op externe knooppunten. Het is een handige manier om inactieve verbindingen actief te houden of de beschikbaarheid handmatig te testen naast het automatische HeartBeat-mechanisme. Wanneer de HeartBeat-time-out is geconfigureerd, sluit de server elke verbinding die niet antwoordt binnen het venster; zonder time-out is de aanroep fire-and-forget en worden pong-antwoorden asynchroon geleverd via de standaard verbindingsgebeurtenissen. Uitzonderingen die optreden bij het schrijven worden doorgestuurd naar OnException.
oServer.Ping('keepalive');