TsgcWebSocketLoadBalancerServerEvents › OnRawMessage

OnRawMessage Event

Si genera quando arriva qualsiasi frame di testo WebSocket, prima che i protocolli di livello superiore o il forwarder lo elaborino.

Sintassi

property OnRawMessage: TsgcWSRawMessageEvent;
// TsgcWSRawMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string; var Handled: Boolean) of object

Valore predefinito

Note

OnRawMessage è il callback testuale di livello più basso sul load balancer e viene invocato prima che vengano eseguiti OnMessage o qualsiasi dispatch del sottoprotocollo. Text contiene il payload UTF-8 raw esattamente come ricevuto; impostare Handled su True per consumare completamente il frame (nessun inoltro, nessun dispatch ulteriore) oppure lasciarlo False per consentire la continuazione della normale pipeline di elaborazione. Utilizzarlo per tracciare ogni frame di testo senza influenzare il dispatch, o per intercettare e bloccare pattern specifici prima che i gestori di livello superiore li vedano.

Esempio


procedure OnRawMessage(Connection: TsgcWSConnection; const Text: string;
  var Handled: Boolean);
begin
  TraceLog.Add(Connection.Guid + ' > ' + Text);
  Handled := False;
end;

Torna agli Eventi