OnRawMessage Zdarzenie

Wywoływane po nadejściu dowolnej ramki tekstowej WebSocket, zanim przetworzą ją protokoły wyższego poziomu lub moduł przekazujący.

Składnia

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

Wartość domyślna

—

Uwagi

Zdarzenie OnRawMessage to wywołanie zwrotne tekstowe najniższego poziomu w load balancerze; jest wywoływane przed zdarzeniami OnMessage lub jakimkolwiek mechanizmem dyspozycji podprotokołu. Parametr Text zawiera surowy ładunek UTF-8 dokładnie w postaci odebranej; ustawienie parametru Handled na True powoduje całkowite skonsumowanie ramki (bez przekazywania, bez dalszej dyspozycji); pozostawienie wartości False pozwala na kontynuację normalnego potoku przetwarzania. Zdarzenie to służy do śledzenia każdej ramki tekstowej bez wpływu na dyspozycję lub do przechwytywania i zawetowania określonych wzorców przed ich zobaczeniem przez procedury obsługi wyższego poziomu.

Przykład


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

Powrót do Zdarzeń