TsgcWebSocketProxyServer › Eventos › OnMessage

OnMessage Event

Dispara toda vez que um cliente WebSocket downstream envia uma mensagem de texto, antes de o proxy encaminhá-la upstream.

Sintaxe

property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object

Valor Padrão

—

Observações

OnMessage é gerado assim que um frame de texto completo é recebido de um cliente WebSocket downstream. O parâmetro Text carrega a string UTF-8 decodificada e o parâmetro Connection identifica a sessão do remetente. O proxy retransmite este payload ao servidor TCP upstream (Proxy.Host, Proxy.Port) logo após o handler retornar, portanto é um local conveniente para inspecionar, registrar ou modificar a mensagem antes de ela ser encaminhada. Por padrão, NotifyEvents é neAsynchronous e o handler é executado sincronizado com a thread principal, o que o torna seguro para atualizar controles de UI; para proxies de alto throughput, defina NotifyEvents como neNoSync para despachar na thread de conexão e implemente sua própria sincronização. Se Options.FragmentedMessages for frgOnlyFragmented, o evento não é gerado e o payload é entregue por meio de OnFragmented.

Exemplo

procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
  ShowMessage('Message Received from Client: ' + Text);
end;

Voltar para Eventos