sgcQUIC가 제공하는 모든 기능을, 네 개의 컴포넌트와 각각이 구현하는 RFC별로 정리했습니다. 원시 QUIC 페어는 스트림과 데이터그램을 제공하고, HTTP/3 페어는 요청/응답, QPACK, WebTransport를 추가합니다. 모든 기능은 Delphi, C++ Builder, .NET에서 동일하게 동작하며, 모든 라이선스에는 전체 소스 코드가 포함됩니다. 컴포넌트를 클릭하면 사용법과 예제가 담긴 해당 페이지로 이동합니다.
두 개의 계층입니다. 원시 QUIC 전송 계층과, 그 위에 구축된 HTTP/3 요청/응답 계층입니다.
| 컴포넌트 | 클래스 | 패밀리 | 설명 |
|---|---|---|---|
| QUIC Client | TsgcQUICClient | QUIC | 원시 QUIC 전송 클라이언트입니다. 스트림과 데이터그램, 0-RTT, 연결 마이그레이션을 지원합니다(RFC 9000). |
| QUIC Server | TsgcQUICServer | QUIC | 원시 QUIC 전송 서버입니다. UDP 포트를 바인딩하고, TLS 1.3을 종료하며, 연결 및 스트림별 이벤트를 발생시킵니다. |
| HTTP/3 Client | TsgcHTTP3Client | HTTP/3 | QPACK, Alt-Svc, 서버 푸시, Extended CONNECT, WebTransport를 지원하는 HTTP/3 클라이언트입니다(RFC 9114). |
| HTTP/3 Server | TsgcHTTP3Server | HTTP/3 | HTTP/3 서버입니다. QUIC를 통해 요청을 처리하고, 서버 푸시, WebTransport 세션, 데이터그램을 지원합니다. |
QUIC 위에 자신만의 프로토콜을 구축할 수 있도록 직접 노출되는 전송 계층입니다.
| 기능 | 클라이언트 | 서버 | 비고 |
|---|---|---|---|
| 전송 + TLS 1.3 핸드셰이크 통합 | ✓ | ✓ | 하나의 플라이트로 연결이 완료됩니다. 별도의 TLS 왕복이 필요 없습니다. |
| 독립적인 양방향 스트림 | ✓ | ✓ | 패킷 손실이 발생해도 그 데이터를 담고 있던 스트림만 지연됩니다. |
| 단방향 스트림 | ✓ | ✓ | 빌트인 엔진에서 OpenStream(aUnidirectional := True)를 사용합니다. |
| 연결당 다중 스트림 | ✓ | ✓ | qmBuiltin 엔진에서 EnableMultiStream / OpenStream을 사용합니다. |
| 0-RTT 재개 | ✓ | ✓ | 재개된 세션은 첫 번째 플라이트에 초기 데이터를 실을 수 있습니다. |
| 연결 마이그레이션 | ✓ | ✓ | 연결 ID 기반이며, 클라이언트의 네트워크 변경에도 유지됩니다. |
| 바이트 송수신 | WriteData | WriteData(connection, …) | 스트림에 실리는 문자열 또는 TBytes 페이로드입니다. |
| 연결 수명 주기 이벤트 | OnQUICConnect / OnQUICDisconnect | OnQUICConnect / OnQUICDisconnect | 전송 오류에는 OnQUICException이 추가로 발생합니다. |
| 인바운드 스트림 데이터 이벤트 | OnQUICStreamData | OnQUICStreamData / OnQUICData | 스트림 바이트가 도착할 때 발생합니다. |
QUIC 위에서의 HTTP 시맨틱과, 메서드 및 이벤트로 노출되는 HTTP/3 전용 기능입니다.
| 기능 | 클라이언트 | 서버 | 비고 |
|---|---|---|---|
| 요청 메서드 | GET, HEAD, POST, PUT, DELETE, PATCH, OPTIONS, TRACE, CONNECT, QUERY | ✓ | 클라이언트에서 각각 블로킹 호출로 제공되며, 대부분 비동기 버전도 있습니다. |
| QPACK 헤더 압축 | ✓ | ✓ | RFC 9204이며, 동적 테이블 업데이트는 전용 인코더/디코더 스트림으로 전달됩니다. |
| Alt-Svc 검색 | OnAltSvc | 알림 제공 | RFC 7838입니다. 클라이언트가 헤더를 파싱하며, 전환 시점은 애플리케이션이 결정합니다. |
| 서버 푸시 | SetMaxPushId / OnPushPromise / OnPush | OnH3Request에서 푸시 | 클라이언트가 한도를 알리며 푸시된 응답을 거부할 수 있습니다. |
| Extended CONNECT 터널 | ExtendedConnect / TunnelSend / OnTunnelData | OnH3TunnelData / TunnelSend | RFC 9220은 요청 스트림을 통해 다른 프로토콜을 터널링합니다. |
| 요청 이벤트 | — | OnH3Request | 요청마다 발생하며, 애플리케이션이 응답을 채웁니다. |
| 정상 종료 | OnGoAway | GOAWAY | RFC 9114의 연결 종료 시그널링입니다. |
| 인증서 / 키 | — | QUICOptions.SSLOptions.CertFile / KeyFile | 리스너용 PEM 인증서 및 개인 키입니다. |
Extended CONNECT를 통해 협상되며, 애플리케이션에 QUIC 스트림을 직접 전달하는 세션입니다.
| 기능 | 클라이언트 | 서버 | 비고 |
|---|---|---|---|
| 세션 수립 | WebTransportConnect | OnWebTransportSession | HTTP/3 Extended CONNECT 요청 위에서 부트스트래핑됩니다. |
| 양방향 스트림 | ✓ | ✓ | 빌트인 엔진에서의 저지연 양방향 트래픽입니다. |
| 데이터그램 | ✓ | SendDatagram | 세션의 스트림과 함께 전달되는 비신뢰성 데이터그램입니다. |
| 빌트인 엔진 필요 | ✓ | ✓ | 세션은 하나의 연결에서 여러 스트림을 필요로 합니다(qmBuiltin). |
네이티브 OpenSSL 3.5 QUIC 엔진 기반의 표준 준수 스택입니다.
| 영역 | 세부 사항 |
|---|---|
| RFC 9000 | QUIC 전송 — 스트림, 연결 ID, 마이그레이션, 전송+TLS 핸드셰이크 통합. |
| RFC 9114 | HTTP/3 — HTTP 시맨틱을 QUIC 스트림에 매핑. |
| RFC 9204 | QPACK — HTTP/3용 헤더 압축. |
| RFC 9220 | HTTP/3(Extended CONNECT) 위에서의 WebTransport 부트스트래핑. |
| RFC 7838 | Alt-Svc — 서버가 알리는 HTTP/3 가용성. |
| TLS | QUIC 핸드셰이크에 내장된 TLS 1.3. |
| 암호화 엔진 | OpenSSL 3.5의 네이티브 QUIC(qmBuiltin, 다중 스트림). quictls 계열 빌드를 위한 qmCustom 경로도 있으며, 연결당 하나의 스트림으로 제한됩니다. |
| 플랫폼 | Win32, Win64, Linux64와, OpenSSL 3.5 QUIC 엔진을 사용할 수 있는 macOS, iOS, Android입니다. |
| 언어 | Delphi 및 C++ Builder(7부터 13까지)와, 동일한 이름의 Tsgc 클래스를 제공하는 .NET입니다. |