TsgcWebSocketProxyServer › Eventos › OnMessage

OnMessage Evento

Se activa cada vez que un cliente WebSocket descendente envía un mensaje de texto, antes de que el proxy lo reenvíe hacia arriba.

Sintaxis

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

Valor Predeterminado

—

Observaciones

OnMessage se activa una vez que se ha recibido un marco de texto completo de un cliente WebSocket descendente. El parámetro Text contiene la cadena UTF-8 decodificada y el parámetro Connection identifica la sesión del remitente. El proxy retransmite esta carga útil al servidor TCP ascendente (Proxy.Host, Proxy.Port) justo después de que el manejador regresa, por lo que es un lugar conveniente para inspeccionar, registrar o modificar el mensaje antes de reenviarlo. De forma predeterminada, NotifyEvents es neAsynchronous y el manejador se ejecuta sincronizado con el hilo principal, lo que hace seguro actualizar controles de interfaz; para proxies de alto rendimiento establezca NotifyEvents en neNoSync para despachar en el hilo de conexión e implemente su propia sincronización. Si Options.FragmentedMessages es frgOnlyFragmented, el evento no se activa y la carga útil se entrega mediante OnFragmented.

Ejemplo


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

Volver a Eventos