TsgcWebSocketLoadBalancerServerEventi › OnClientMessage

OnClientMessage Evento

Viene generato quando viene ricevuto un frame di testo da un client downstream prima che venga inoltrato al server backend selezionato.

Sintassi

property OnClientMessage: TsgcWSLBServerMessageEvent;
// TsgcWSLBServerMessageEvent = procedure(Connection: TsgcWSConnection; Text: String; var Handled: Boolean) of object

Valore predefinito

Note

OnClientMessage viene generato per ogni frame WebSocket di testo ricevuto da un client bilanciato durante il transito verso il server backend. Connection identifica la sessione del client downstream e Text trasporta il payload UTF-8 decodificato. Impostare Handled su True per consumare il messaggio all'interno del load balancer (in tal caso non avviene alcun inoltro al backend), tipicamente quando il load balancer risponde ai messaggi di controllo per conto del backend o filtra i contenuti non validi. Lasciare Handled su False (predefinito) per consentire al load balancer di inoltrare il messaggio invariato.

Esempio


procedure OnClientMessage(Connection: TsgcWSConnection; Text: String;
  var Handled: Boolean);
begin
  // answer ping messages directly from the load balancer
  if SameText(Text, 'ping') then
  begin
    Connection.WriteData('pong');
    Handled := True;
  end;
end;

Torna agli Eventi