TsgcWebSocketClientEvents › OnBeforeWatchDog

OnBeforeWatchDog Gebeurtenis

Wordt geactiveerd voor elke WatchDog-reconnectiepoging, zodat de applicatie de doelserver kan aanpassen of de poging kan onderdrukken.

Syntaxis

property OnBeforeWatchDog: TsgcWSOnBeforeWatchDogEvent;
// TsgcWSOnBeforeWatchDogEvent = procedure(Sender: TObject; var Handled: Boolean) of object

Standaardwaarde

Opmerkingen

Wanneer WatchDog is ingeschakeld en een onverwachte verbreking wordt gedetecteerd, wacht de client WatchDog.Interval seconden en probeert vervolgens opnieuw verbinding te maken. OnBeforeWatchDog wordt geactiveerd vlak vóór elke poging, waardoor de applicatie de serververbindingseigenschappen (Host, Port, URL, TLS...) kan wijzigen om terugvallogica te implementeren, zoals overschakelen naar een secundaire server na meerdere mislukte pogingen. Het instellen van Handled op True annuleert de herverbindingspoging voor deze cyclus; het op False laten (de standaard) laat de WatchDog doorgaan met het opnieuw verbinden.

Voorbeeld


procedure OnBeforeWatchDog(Sender: TObject; var Handled: Boolean);
var
  oClient: TsgcWebSocketClient;
begin
  oClient := TsgcWebSocketClient(Sender);
  if oClient.WatchDog.AttemptsCount > 3 then
    oClient.Host := 'fallback.example.com';
  Handled := False;
end;

Terug naar Events