TsgcHTTP3Client › Events › OnAltSvc
Wordt geactiveerd wanneer de server een Alt-Svc-header retourneert die alternatieve services adverteert.
property OnAltSvc: TsgcAltSvcEvent;
// TsgcAltSvcEvent = procedure(Sender: TObject; const aEntries: TsgcAltSvcList) of object
| Naam | Type | Beschrijving |
|---|---|---|
Sender | TObject | De client die de Alt-Svc-header heeft ontvangen. |
aEntries | TsgcAltSvcList | Geparseerde lijst van geadverteerde alternatieve services. Elk item geeft Protocol, Host, Port, MaxAge en Persist bloot. |
—
OnAltSvc wordt geactiveerd wanneer een antwoord een alt-svc-header bevat (RFC 7838), waarmee een server aankondigt dat dezelfde oorsprong ook bereikbaar is via een ander protocol, host of poort, bijvoorbeeld een HTTP/3-eindpunt ontdekt terwijl verbonden via HTTP/2. De header wordt geparseerd naar een TsgcAltSvcList en elke TsgcAltSvcEntry beschrijft één alternatieve service: het ALPN Protocol (zoals h3), de Host en Port, de MaxAge-versheidslevensduur in seconden, en de Persist-vlag. Gebruik de gebeurtenis om het aangekondigde eindpunt in de cache op te slaan en latere verzoeken ernaar te routeren. Een clear (alt-svc: clear)-instructie activeert de gebeurtenis niet.
procedure OnAltSvcEvent(Sender: TObject; const aEntries: TsgcAltSvcList);
var
i: Integer;
begin
for i := 0 to High(aEntries) do
Log(aEntries[i].Protocol + ' @ ' + aEntries[i].Host + ':' + IntToStr(aEntries[i].Port));
end;