TsgcHTTP3Client › 事件 › OnGoAway

OnGoAway 事件

当服务器发送 GOAWAY 帧以结束连接时触发。

语法

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

参数

名称	类型	描述
Sender	TObject	接收到 GOAWAY 帧的客户端。
aStreamId	Int64	服务器将处理的最后一条请求流的标识符。更高流 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;

返回事件