TsgcHTTP3Client › Events › OnAltSvc

OnAltSvc Gebeurtenis

Wordt geactiveerd wanneer de server een Alt-Svc-header retourneert die alternatieve services adverteert.

Syntaxis

property OnAltSvc: TsgcAltSvcEvent;
// TsgcAltSvcEvent = procedure(Sender: TObject; const aEntries: TsgcAltSvcList) of object

Parameters

NaamTypeBeschrijving
SenderTObjectDe client die de Alt-Svc-header heeft ontvangen.
aEntriesTsgcAltSvcListGeparseerde lijst van geadverteerde alternatieve services. Elk item geeft Protocol, Host, Port, MaxAge en Persist bloot.

Standaardwaarde

—

Opmerkingen

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.

Voorbeeld


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;

Terug naar Events