TsgcWebSocketProxyServer › Events › OnMessage
Si attiva ogni volta che un client WebSocket downstream invia un messaggio di testo, prima che il proxy lo inoltri upstream.
property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object—
OnMessage viene generato una volta ricevuto completamente un frame di testo da un client WebSocket downstream. Il parametro Text trasporta la stringa UTF-8 decodificata e il parametro Connection identifica la sessione del mittente. Il proxy trasmette questo payload al server TCP upstream (Proxy.Host, Proxy.Port) subito dopo il ritorno del gestore, quindi è un punto conveniente per ispezionare, registrare o modificare il messaggio prima che venga inoltrato. Per impostazione predefinita NotifyEvents è neAsynchronous e il gestore viene eseguito sincronizzato con il thread principale, il che lo rende sicuro per aggiornare i controlli dell'interfaccia utente; per proxy ad alta capacità impostare NotifyEvents su neNoSync per eseguire il dispatch nel thread di connessione e implementare la propria sincronizzazione. Se Options.FragmentedMessages è frgOnlyFragmented l'evento non viene generato e il payload viene consegnato tramite OnFragmented.
procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
ShowMessage('Message Received from Client: ' + Text);
end;