TsgcWebSocketLoadBalancerServerMethoden › Ping

Ping Methode

Verzendt een WebSocket-pingframe naar elke client die via de load balancer is verbonden.

Syntaxis

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

Parameters

NaamTypeBeschrijving
aTextconst stringOptionele payload in het ping-frame; geef een lege tekenreeks door om een ping zonder payload te verzenden.

Opmerkingen

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.

Voorbeeld


oServer.Ping('keepalive');

Terug naar methoden