TsgcWebSocketLoadBalancerServer › Events › OnRawMessage

OnRawMessage 事件

当任何 WebSocket 文本帧到达时触发，时机在高级协议或转发器处理之前。

语法

property OnRawMessage: TsgcWSRawMessageEvent;
// TsgcWSRawMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string; var Handled: Boolean) of object

默认值

—

备注

OnRawMessage 是负载均衡器上最低级别的文本回调，在 OnMessage 或任何子协议分发运行之前调用。Text 保存完全按照接收到的原始 UTF-8 负载；将 Handled 设置为 True 以完全消耗该帧（不转发，不进行进一步分发），或将其保留为 False 以让正常处理管道继续。使用它在不影响分发的情况下跟踪每个文本帧，或在高层处理程序看到之前嗅探和否决特定模式。

示例

procedure OnRawMessage(Connection: TsgcWSConnection; const Text: string;
  var Handled: Boolean);
begin
  TraceLog.Add(Connection.Guid + ' > ' + Text);
  Handled := False;
end;

返回事件