TsgcHTTP3Client › Eventi › OnPushPromise
Si attiva quando il server annuncia un server push con un frame PUSH_PROMISE.
property OnPushPromise: TsgcHTTP3PushPromiseEvent;
// TsgcHTTP3PushPromiseEvent = procedure(Sender: TObject; aPushId: Int64; const aHeaders: TStringList) of object| Nome | Tipo | Descrizione |
|---|---|---|
Sender | TObject | Il client che ha ricevuto il frame PUSH_PROMISE. |
aPushId | Int64 | Identificatore del push promesso, utilizzato in seguito per correlare la risposta inviata in push o per annullarla. |
aHeaders | TStringList | Header della richiesta della risorsa che il server intende inviare tramite push, come coppie nome=valore. |
—
OnPushPromise viene generato quando il server invia un frame PUSH_PROMISE (RFC 9114 sezione 7.2.5), annunciando che intende inviare tramite push una risorsa che il client non ha esplicitamente richiesto. L'elenco aHeaders contiene gli header della richiesta (inclusi gli pseudo-header :path e :authority) che descrivono la risorsa promessa, in modo che l'applicazione possa decidere se è utile. Se la risorsa è già nella cache o non è necessaria, chiamare CancelPush con aPushId per rifiutarla. Il server push viene offerto solo dopo che il client ha aumentato il limite di push con SetMaxPushId.
procedure OnPushPromiseEvent(Sender: TObject; aPushId: Int64; const aHeaders: TStringList);
begin
Log('Push promised, id: ' + IntToStr(aPushId));
end;