TsgcHTTP2Client › イベント › OnHTTP2GoAway

OnHTTP2GoAway イベント

サーバーが接続のシャットダウンを通知する GoAway フレームを送信したときに発生します。

構文

property OnHTTP2GoAway: TsgcHTTP2ClientGoAwayEvent;
// TsgcHTTP2ClientGoAwayEvent = procedure(Sender: TObject; const Connection: TsgcHTTP2ConnectionClient; const GoAway: TsgcHTTP2GoAwayProperty) of object

デフォルト値

—

解説

OnHTTP2GoAway は、サーバーが GOAWAY フレームを送信して接続上の新しいストリームの受け付けを停止することを通知するときに発生します。これは通常、サーバーが再起動、過負荷、またはグレースフル シャットダウンを実行している場合に起こります。GoAway パラメータには、サーバーが処理した最後のストリーム識別子、HTTP/2 エラーコード、およびピアから返された追加のデバッグ データが含まれており、どのリクエストが完了し、どれを新しい接続で再試行する必要があるかを判断できます。このイベントは情報提供目的であり、クライアントはすでに受理済みのストリームを引き続き処理してから接続を閉じます。

使用例

procedure OnHTTP2GoAwayEvent(Sender: TObject; const Connection: TsgcHTTP2ConnectionClient;
  const GoAway: TsgcHTTP2GoAwayProperty);
begin
  Log(Format('GoAway received: last stream %d, error %d',
    [GoAway.LastStreamId, GoAway.ErrorCode]));
end;

イベントに戻る