TsgcWebSocketLoadBalancerServer › イベント › 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;

イベントに戻る