Tutto ciò che fa sgcQUIC, mappato tra i quattro componenti e gli RFC che implementano. La coppia QUIC pura offre stream e datagrammi; la coppia HTTP/3 aggiunge richiesta/risposta, QPACK e WebTransport. Ogni funzionalità si comporta allo stesso modo in Delphi, C++ Builder e .NET, e ogni licenza include il codice sorgente completo. Clicca su un componente per la sua pagina dedicata con utilizzo ed esempi.
RFC 9000
RFC 9114 + QPACK
RFC 9220
TLS 1.3 / OpenSSL 3.5
Due livelli: trasporto QUIC puro, e richiesta/risposta HTTP/3 costruita sopra di esso.
| Componente | Classe | Famiglia | Descrizione |
|---|---|---|---|
| Client QUIC | TsgcQUICClient | QUIC | Client di trasporto QUIC puro: stream e datagrammi, 0-RTT, migrazione della connessione (RFC 9000). |
| Server QUIC | TsgcQUICServer | QUIC | Server di trasporto QUIC puro: si lega a una porta UDP, termina TLS 1.3, genera eventi per connessione e per stream. |
| Client HTTP/3 | TsgcHTTP3Client | HTTP/3 | Client HTTP/3 con QPACK, Alt-Svc, server push, Extended CONNECT e WebTransport (RFC 9114). |
| Server HTTP/3 | TsgcHTTP3Server | HTTP/3 | Server HTTP/3: serve le richieste su QUIC, server push, sessioni WebTransport e datagrammi. |
Il livello di trasporto, esposto direttamente per costruire il tuo protocollo sopra QUIC.
| Funzionalità | Client | Server | Note |
|---|---|---|---|
| Handshake unico combinato di trasporto + TLS 1.3 | ✓ | ✓ | Un solo invio completa la connessione; nessun round trip TLS separato. |
| Stream bidirezionali indipendenti | ✓ | ✓ | Un pacchetto perso blocca solo gli stream i cui dati trasportava. |
| Stream unidirezionali | ✓ | ✓ | OpenStream(aUnidirectional := True) sul motore builtin. |
| Più stream per connessione | ✓ | ✓ | EnableMultiStream / OpenStream sul motore qmBuiltin. |
| Ripresa 0-RTT | ✓ | ✓ | Una sessione ripresa può trasportare dati anticipati nel primo invio. |
| Migrazione della connessione | ✓ | ✓ | Basata su connection ID; sopravvive al cambio di rete del client. |
| Invio / ricezione byte | WriteData | WriteData(connection, …) | Payload String o TBytes su uno stream. |
| Eventi del ciclo di vita della connessione | OnQUICConnect / OnQUICDisconnect | OnQUICConnect / OnQUICDisconnect | Più OnQUICException per gli errori di trasporto. |
| Evento dati stream in ingresso | OnQUICStreamData | OnQUICStreamData / OnQUICData | Si attiva all'arrivo dei byte dello stream. |
Semantica HTTP su QUIC, con i meccanismi specifici di HTTP/3 esposti come metodi ed eventi.
| Funzionalità | Client | Server | Note |
|---|---|---|---|
| Metodi di richiesta | GET, HEAD, POST, PUT, DELETE, PATCH, OPTIONS, TRACE, CONNECT, QUERY | ✓ | Ognuno una chiamata bloccante sul client, la maggior parte con una variante asincrona. |
| Compressione delle intestazioni QPACK | ✓ | ✓ | RFC 9204, con aggiornamenti della tabella dinamica su stream dedicati di encoder/decoder. |
| Discovery Alt-Svc | OnAltSvc | annuncia | RFC 7838; il client analizza l'intestazione e lascia che la tua app decida quando passare. |
| Server push | SetMaxPushId / OnPushPromise / OnPush | push da OnH3Request | Il client annuncia un limite e può rifiutare le risposte inviate in push. |
| Tunnel Extended CONNECT | ExtendedConnect / TunnelSend / OnTunnelData | OnH3TunnelData / TunnelSend | RFC 9220 tunnelizza un altro protocollo attraverso uno stream di richiesta. |
| Evento richiesta | — | OnH3Request | Si attiva per ogni richiesta; l'applicazione compila la risposta. |
| Chiusura controllata | OnGoAway | GOAWAY | Segnalazione di chiusura connessione di RFC 9114. |
| Certificato / chiave | — | QUICOptions.SSLOptions.CertFile / KeyFile | Certificato PEM e chiave privata per il listener. |
Sessioni negoziate tramite Extended CONNECT che consegnano direttamente all'applicazione stream QUIC.
| Funzionalità | Client | Server | Note |
|---|---|---|---|
| Stabilire una sessione | WebTransportConnect | OnWebTransportSession | Avviata tramite una richiesta Extended CONNECT di HTTP/3. |
| Stream bidirezionali | ✓ | ✓ | Traffico bidirezionale a bassa latenza sul motore builtin. |
| Datagrammi | ✓ | SendDatagram | Datagrammi non affidabili insieme agli stream della sessione. |
| Richiede il motore builtin | ✓ | ✓ | Una sessione necessita di più stream su una connessione (qmBuiltin). |
Uno stack basato su standard sul motore QUIC nativo di OpenSSL 3.5.
| Area | Dettaglio |
|---|---|
| RFC 9000 | Trasporto QUIC — stream, connection ID, migrazione, handshake combinato di trasporto + TLS. |
| RFC 9114 | HTTP/3 — semantica HTTP mappata sugli stream QUIC. |
| RFC 9204 | QPACK — compressione delle intestazioni per HTTP/3. |
| RFC 9220 | Avvio di WebTransport su HTTP/3 (Extended CONNECT). |
| RFC 7838 | Alt-Svc — disponibilità di HTTP/3 annunciata dal server. |
| TLS | TLS 1.3, integrato nell'handshake QUIC. |
| Motore crittografico | QUIC nativo in OpenSSL 3.5 (qmBuiltin, multi-stream). Esiste un percorso qmCustom per build in stile quictls, limitato a un singolo stream per connessione. |
| Piattaforme | Win32, Win64 e Linux64, oltre a macOS, iOS e Android dove il motore QUIC di OpenSSL 3.5 è disponibile. |
| Linguaggi | Delphi e C++ Builder (dalla 7 alla 13), e .NET con le classi Tsgc dallo stesso nome. |