TsgcWSPServer_sgc › 事件 › OnRawMessage

OnRawMessage 事件

在文本消息解码之前触发，允许处理程序消费该消息。

语法

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

默认值

—

备注

在子协议解析 sgc 信封之前，针对每个文本帧触发。Text 是通过线路传递的原始字符串。将 Handled 设为 True 以接管该消息；此时服务器将跳过该帧的信封解析、RPC 分发、PubSub 以及 OnMessage/OnNotification/OnRPC。保持为 False 则保留默认行为。

示例

procedure TForm1.oProtocolRawMessage(Connection: TsgcWSConnection;
  const Text: string; var Handled: Boolean);
begin
  if Text.StartsWith('PING') then
  begin
    oProtocol.WriteData(Connection.Guid, 'PONG');
    Handled := True;
  end;
end;

返回事件