TsgcWebSocketServer › Events › OnMessage
Viene attivato ogni volta che un client invia un messaggio di testo e questo viene ricevuto dal server.
property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object—
OnMessage viene generato una volta ricevuto un frame di testo completo da un client. Il parametro Text contiene la stringa UTF-8 decodificata e il parametro Connection identifica la sessione del mittente, in modo che l'handler possa rispondere sulla stessa connessione o inviare il messaggio ad altri client. Per impostazione predefinita, NotifyEvents è neAsynchronous e l'handler viene eseguito sincronizzato con il thread principale, il che lo rende sicuro per aggiornare i controlli dell'interfaccia utente; per server ad alto throughput impostare NotifyEvents su neNoSync per 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;