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;

イベントに戻る