TsgcHTTP3Client › イベント › OnGoAway

OnGoAway イベント

サーバーが接続を終了するために GOAWAY フレームを送信したときに発生します。

構文

property OnGoAway: TsgcHTTP3GoAwayEvent;
// TsgcHTTP3GoAwayEvent = procedure(Sender: TObject; aStreamId: Int64) of object

パラメータ

名前タイプ説明
SenderTObjectGOAWAY フレームを受信したクライアント。
aStreamIdInt64サーバーが処理する最後のリクエストストリームの識別子。より高いストリーム ID のリクエストは処理されず、新しい接続で再試行する必要があります。

デフォルト値

—

解説

OnGoAway は、サーバーが GOAWAY フレーム(RFC 9114 セクション 5.2)を送信したときに発生します。これはクライアントに対して、接続が閉じられるため新しいストリームの開始を停止するよう通知するグレースフルシャットダウンシグナルです。aStreamId パラメータは、サーバーが処理を約束している最後のリクエストの識別子です。より高いストリーム ID で既に送信されたリクエストは処理されず、新しい接続で再発行する必要があります。このイベントを使用して処理中の作業をドレインし、再接続することで、サーバーのシャットダウンやロードバランサーのドレイン中にリクエストが無視されないようにしてください。

使用例


procedure OnGoAwayEvent(Sender: TObject; aStreamId: Int64);
begin
  Log('Server going away, last stream: ' + IntToStr(aStreamId));
end;

イベントに戻る