OnAltSvc Evento

Si attiva quando il server restituisce un header Alt-Svc che annuncia servizi alternativi.

Sintassi

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

Parametri

Nome	Tipo	Descrizione
`Sender`	`TObject`	Il client che ha ricevuto l'header Alt-Svc.
`aEntries`	`TsgcAltSvcList`	Elenco analizzato dei servizi alternativi annunciati. Ogni voce espone `Protocol`, `Host`, `Port`, `MaxAge` e `Persist`.

Valore predefinito

—

Note

OnAltSvc viene generato quando una risposta contiene un header alt-svc (RFC 7838), tramite il quale un server annuncia che la stessa origine è raggiungibile anche tramite un altro protocollo, host o porta, ad esempio un endpoint HTTP/3 scoperto mentre si è connessi tramite HTTP/2. L'header viene analizzato in un TsgcAltSvcList e ogni TsgcAltSvcEntry descrive un servizio alternativo: il Protocol ALPN (come h3), l'Host e la Port, la durata di freschezza MaxAge in secondi e il flag Persist. Utilizzare l'evento per memorizzare nella cache l'endpoint annunciato e instradarvi le richieste successive. Una direttiva di azzeramento (alt-svc: clear) non attiva l'evento.

Esempio


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;

Torna agli Eventi