TsgcHTTP3Client › Zdarzenia › OnAltSvc

OnAltSvc Zdarzenie

Uruchamiane, gdy serwer zwraca nagłówek Alt-Svc ogłaszający alternatywne usługi.

Składnia

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

Parametry

NazwaTypOpis
SenderTObjectKlient, który odebrał nagłówek Alt-Svc.
aEntriesTsgcAltSvcListPrzetworzona lista ogłoszonych alternatywnych usług. Każdy wpis udostępnia Protocol, Host, Port, MaxAge i Persist.

Wartość domyślna

—

Uwagi

OnAltSvc jest wywoływane, gdy odpowiedź zawiera nagłówek alt-svc (RFC 7838), przez który serwer ogłasza, że to samo źródło jest również dostępne przez inny protokół, host lub port, na przykład punkt końcowy HTTP/3 odkryty podczas połączenia przez HTTP/2. Nagłówek jest parsowany do TsgcAltSvcList, a każdy wpis TsgcAltSvcEntry opisuje jedną alternatywną usługę: Protocol ALPN (np. h3), Host i Port, czas aktualności MaxAge w sekundach oraz flagę Persist. Użyj zdarzenia, aby buforować ogłoszony punkt końcowy i kierować do niego późniejsze żądania. Dyrektywa clear (alt-svc: clear) nie wywołuje zdarzenia.

Przykład


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;

Powrót do Zdarzeń