TsgcWebSocketProxyServer › Événements › OnMessage
Se déclenche chaque fois qu'un client WebSocket aval envoie un message texte, avant que le proxy ne le transmette en amont.
property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object
—
OnMessage est déclenché une fois qu'une trame texte complète a été reçue d'un client WebSocket en aval. Le paramètre Text transporte la chaîne UTF-8 décodée et le paramètre Connection identifie la session de l'expéditeur. Le proxy relaie cette charge utile vers le serveur TCP en amont (Proxy.Host, Proxy.Port) juste après le retour du gestionnaire, c'est donc un endroit pratique pour inspecter, journaliser ou modifier le message avant son transfert. Par défaut, NotifyEvents est neAsynchronous et le gestionnaire s'exécute synchronisé avec le thread principal, ce qui permet la mise à jour sécurisée des contrôles d'interface ; pour les proxys à haut débit, définissez NotifyEvents à neNoSync pour distribuer dans le thread de connexion et implémentez votre propre synchronisation. Si Options.FragmentedMessages est frgOnlyFragmented, l'événement n'est pas déclenché et la charge utile est livrée via OnFragmented à la place.
procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
ShowMessage('Message Received from Client: ' + Text);
end;