TsgcHTTP3Client › Events › OnPushPromise

OnPushPromise Gebeurtenis

Wordt geactiveerd wanneer de server een server-push aankondigt met een PUSH_PROMISE-frame.

Syntaxis

property OnPushPromise: TsgcHTTP3PushPromiseEvent;
// TsgcHTTP3PushPromiseEvent = procedure(Sender: TObject; aPushId: Int64; const aHeaders: TStringList) of object

Parameters

NaamTypeBeschrijving
SenderTObjectDe client die het PUSH_PROMISE-frame heeft ontvangen.
aPushIdInt64Identifier van de beloofde push, later gebruikt om de gepushte respons te correleren of te annuleren.
aHeadersTStringListVerzoekheaders van de resource die de server wil pushen, als naam=waarde-paren.

Standaardwaarde

—

Opmerkingen

OnPushPromise wordt geactiveerd wanneer de server een PUSH_PROMISE-frame verstuurt (RFC 9114 Sectie 7.2.5), waarmee het aankondigt dat het een resource wil pushen die de client niet expliciet heeft aangevraagd. De lijst aHeaders bevat de verzoekheaders (inclusief de :path- en :authority-pseudo-headers) die de aangekondigde resource beschrijven, zodat de toepassing kan beslissen of deze nuttig is. Als de resource al in de cache staat of niet nodig is, roep dan CancelPush aan met aPushId om deze te weigeren. Server-push wordt alleen aangeboden nadat de client de pushlimiet heeft verhoogd met SetMaxPushId.

Voorbeeld


procedure OnPushPromiseEvent(Sender: TObject; aPushId: Int64; const aHeaders: TStringList);
begin
  Log('Push promised, id: ' + IntToStr(aPushId));
end;

Terug naar Events