TsgcHTTP2Client › イベント › OnHTTP2RSTStream

OnHTTP2RSTStream イベント

サーバーが特定のHTTP/2ストリームをリセットしたときに発生します。

構文

property OnHTTP2RSTStream: TsgcHTTP2ClientRSTStreamEvent;
// TsgcHTTP2ClientRSTStreamEvent = procedure(Sender: TObject; const Connection: TsgcHTTP2ConnectionClient; const RSTStream: TsgcHTTP2RSTStreamProperty) of object

デフォルト値

—

解説

OnHTTP2RSTStream は、サーバーが単一のストリームを中止するために RST_STREAM フレームを送信したときに発生します。基本となる接続は開いたままで、例えばリクエストが拒否された場合、プッシュされたリソースが不要になった場合、またはサーバー側のタイムアウトが期限切れになった場合に発生します。RSTStream パラメータは HTTP/2 ErrorCode とその ErrorDescription を公開するため、アプリケーションは理由をログに記録し、必要に応じて新しいストリームでリクエストを再試行できます。同じ接続上の他の進行中のストリームは影響を受けず、データの受信を継続します。

使用例

procedure OnHTTP2RSTStreamEvent(Sender: TObject; const Connection: TsgcHTTP2ConnectionClient;
  const RSTStream: TsgcHTTP2RSTStreamProperty);
begin
  Log(Format('Stream reset: %d - %s',
    [RSTStream.ErrorCode, RSTStream.ErrorDescription]));
end;

イベントに戻る