TsgcWebSocketProxyServer › 事件 › OnMessage

OnMessage 事件

每当下游 WebSocket 客户端发送文本消息且代理将其转发给上游之前触发。

语法

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

默认值

—

备注

OnMessage 在从下游 WebSocket 客户端收到完整文本帧时触发。Text 参数携带解码后的 UTF-8 字符串，Connection 参数标识发送方会话。代理在处理程序返回后立即将此载荷转发给上游 TCP 服务器（Proxy.Host、Proxy.Port），因此这是在转发前检查、记录或修改消息的便捷位置。默认情况下 NotifyEvents 为 neAsynchronous，处理程序与主线程同步运行，可安全更新 UI 控件；对于高吞吐量代理，将 NotifyEvents 设为 neNoSync 可在连接线程中分发并自行实现同步。若 Options.FragmentedMessages 为 frgOnlyFragmented，则不会触发此事件，载荷改由 OnFragmented 传递。

示例

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

返回事件