TsgcWebSocketProxyServer › Ereignisse › OnMessage
Wird jedes Mal ausgelöst, wenn ein nachgelagerter WebSocket-Client eine Textnachricht sendet, bevor der Proxy sie vorgelagert weiterleitet.
property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object—
OnMessage wird ausgelöst, sobald ein vollständiger Text-Frame von einem nachgelagerten WebSocket-Client empfangen wurde. Der Text-Parameter trägt die dekodierte UTF-8-Zeichenfolge und der Connection-Parameter identifiziert die Sender-Sitzung. Der Proxy leitet diese Payload unmittelbar nach der Rückkehr des Handlers an den vorgelagerten TCP-Server (Proxy.Host, Proxy.Port) weiter, sodass dies ein praktischer Ort ist, um die Nachricht vor der Weiterleitung zu untersuchen, zu protokollieren oder zu ändern. Standardmäßig ist NotifyEvents neAsynchronous und der Handler wird mit dem Haupt-Thread synchronisiert ausgeführt, was es sicher macht, UI-Steuerelemente zu aktualisieren; setzen Sie für Proxys mit hohem Durchsatz NotifyEvents auf neNoSync, um im Verbindungs-Thread zu dispatchen, und implementieren Sie Ihre eigene Synchronisierung. Wenn Options.FragmentedMessages frgOnlyFragmented ist, wird das Ereignis nicht ausgelöst und die Payload wird stattdessen über OnFragmented geliefert.
procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
ShowMessage('Message Received from Client: ' + Text);
end;