sgcHTTP가 제공하는 모든 기능을, HTTP 서버, FastCGI / SCGI 게이트웨이, HTTP/2 클라이언트, gRPC 클라이언트, 세 개의 Google Cloud 클라이언트를 기준으로 정리했습니다. 모든 기능이 Delphi와 C++ Builder에서 동일하게 동작하며, 모든 라이선스에 전체 소스 코드가 제공됩니다. 이번 출시에서는 컴포넌트 하위 페이지가 아직 게시되지 않아, 아래 각 항목은 이 페이지 안에서 자체적으로 완결됩니다.
엔드포인트, 정적 파일, 세션, TLS
PHP & Python을 서버 뒤에서
멀티플렉싱 스트림, HPACK, ALPN
unary & 스트리밍 RPC
Pub/Sub, Calendar & FCM
Delphi 7부터 13까지, C++ Builder
sgcHTTP는 자체 완결형 제품입니다. sgcWebSockets Core 런타임이 함께 포함되어 제공되므로 애드온이 아닙니다. HTTP 서버인 TsgcHTTPServer는 이 런타임에 포함되어 있습니다.
HTTP/2와 gRPC에는 sgcCustomIndy가 필요합니다. 두 클래스 모두 TLS 프로토콜 협상에 ALPN이 필요한데, 표준 Indy 라이브러리는 이를 지원하지 않으므로 대신 sgcCustomIndy 위에 구축되어 있습니다. 주문에 항상 포함되며, 표시된 sgcHTTP 가격에 이미 포함되어 있습니다. 세 개의 Google Cloud 클라이언트는 순수 HTTPS이며 필요하지 않습니다. FastCGI / SCGI 게이트웨이도 마찬가지로, RAD Studio에 기본으로 포함된 표준 Indy에서 동작합니다.
SGC HTTP 팔레트 페이지의 컴포넌트 4종과 코드 전용 Google Cloud 클래스 3종입니다. HTTP 서버는 번들로 포함된 Core 런타임의 sgcHTTP_Server 유닛에, FastCGI / SCGI 게이트웨이는 sgcHTTP_Gateway 유닛에, 나머지는 모두 sgcHTTP 유닛에 선언되어 있습니다.
| 컴포넌트 | 클래스 | 팔레트? | 설명 |
|---|---|---|---|
| HTTP 서버 | TsgcHTTPServer | 있음 | HTTP 서버입니다. 요청 이벤트, 문서 루트의 정적 파일, 압축, keep-alive, 세션, 업로드, TLS, 인증을 지원하며, Core 런타임과 함께 제공됩니다. |
| FastCGI / SCGI 게이트웨이 | TsgcHTTPGateway | 있음 | HTTP 서버가 받은 요청을 PHP-FPM이나 Python SCGI 서버 같은 FastCGI 및 SCGI 애플리케이션 서버로 TCP를 통해 전달합니다. 유닛은 sgcHTTP_Gateway입니다. 표준 Indy를 사용하며 sgcCustomIndy가 필요하지 않습니다. |
| HTTP/2 클라이언트 | TsgcHTTP2Client | 있음 | 네이티브 HTTP/2 클라이언트입니다. 멀티플렉싱 스트림, HPACK 헤더 압축, ALPN 협상을 지원하며, sgcCustomIndy가 필요합니다. |
| gRPC 클라이언트 | TsgcGRPCClient | 있음 | HTTP/2 클라이언트 위에 구축된 gRPC 클라이언트입니다. unary, 서버 스트리밍, 클라이언트 스트리밍, 양방향 RPC를 지원하며, sgcCustomIndy가 필요합니다. |
| Google Cloud Pub/Sub | TsgcHTTPGoogleCloud_PubSub_Client | 없음, 코드 전용 | Google Cloud Pub/Sub REST API입니다. 토픽, 구독, 스냅샷, 게시, 가져오기를 지원합니다. Core 위의 순수 HTTPS입니다. |
| Google Cloud Calendar | TsgcHTTPGoogleCloud_Calendar_Client | 없음, 코드 전용 | Google Calendar API v3입니다. 캘린더와 이벤트의 생성, 수정, 목록 조회, 삭제를 지원합니다. Core 위의 순수 HTTPS입니다. |
| Google Cloud FCM | TsgcHTTPGoogleCloud_FCM_Client | 없음, 코드 전용 | Firebase Cloud Messaging HTTP v1 API입니다. 호출 한 번으로 푸시 알림 페이로드를 전송합니다. Core 위의 순수 HTTPS입니다. |
TsgcHTTPServer는 사용자 애플리케이션에서 HTTP 엔드포인트와 정적 파일을 게시합니다. sgcWebSockets WebSocket 서버에서 WebSocket 부분만 뺀 것과 같은 엔진이며, 번들로 포함된 Core 런타임과 함께 제공됩니다.
| 기능 | API | 비고 |
|---|---|---|
| 수신 대기 | Port, Bindings, Active | 포트를 설정하거나 특정 주소에 바인딩한 다음 서버를 활성화합니다. |
| 요청 | OnCommandGet, OnCommandOther | 모든 요청이 요청 및 응답 객체와 함께 사용자 코드에 전달됩니다. OnCommandOther는 PUT, DELETE 같은 메서드를 처리합니다. |
| 정적 파일 | DocumentRoot | 지정한 폴더의 정적 파일을 반환합니다. |
| 압축 | HTTPCompression | 응답 압축 옵션입니다. |
| 연결 | KeepAlive, MaxConnections | 요청 사이에 연결을 유지하고, 동시에 열 수 있는 연결 수를 제한합니다. |
| 세션 | SessionState, AutoStartSession, SessionTimeOut, OnSessionStart, OnSessionEnd | 타임아웃이 있는 서버 측 세션과 시작 및 종료 이벤트입니다. |
| 요청 제한 | MaxRequestBodySize | 요청 본문의 크기를 제한합니다. |
| 업로드 | HTTPUploadFiles | 업로드된 파일을 지정한 디렉터리에 저장합니다. |
| TLS | SSL, SSLOptions | 사용자 인증서로 HTTPS를 제공합니다. |
| 인증 | Authentication, OnAuthentication | 요청을 처리하기 전에 사용자 코드에서 자격 증명을 검증합니다. |
| 스레드 | ThreadPool, ThreadPoolOptions | 연결마다 스레드를 만들지 않고 풀의 작업 스레드를 재사용합니다. |
| 런타임 | sgcWebSockets Core | 번들로 포함된 Core 런타임의 sgcHTTP_Server 유닛에 SGC HTTP 팔레트 페이지로 선언되어 있습니다. |
TsgcHTTPGateway는 TsgcHTTPServer 또는 TsgcWebSocketHTTPServer가 받은 요청을 TCP를 통해 FastCGI 및 SCGI 애플리케이션 서버로 전달합니다. Apache의 mod_proxy_fcgi와 mod_proxy_scgi, 또는 nginx의 fastcgi_pass와 scgi_pass가 하던 일을 대신하므로, 앞단에 Apache나 nginx 없이 Delphi 서버에서 PHP와 Python 애플리케이션을 제공할 수 있습니다.
| 기능 | API | 비고 |
|---|---|---|
| 백엔드 | FastCGI, SCGI | PHP는 PHP-FPM 또는 php-cgi -b를 통해, Python 애플리케이션은 flup 같은 SCGI 또는 FastCGI 서버를 통해 실행할 수 있습니다. |
| 요청 | Process | 서버의 OnCommandGet과 OnCommandOther 이벤트에서 호출합니다. 핸들러가 일치하고 응답이 채워졌으면 true를, 사용자 코드가 요청에 응답해야 하면 false를 반환합니다. |
| 핸들러 | Handlers.Add | Handlers.Add('*.php', 'fcgi://127.0.0.1:9000') 또는 Handlers.Add('/app/', 'scgi://127.0.0.1:4000')처럼 등록합니다. 핸들러는 확장자(*.php), 접두사(/app/) 또는 정확한 경로로 일치 여부를 판단합니다. |
| 핸들러 설정 | Path, URL, Protocol, Host, Port, DocumentRoot, Enabled | 각 핸들러의 백엔드를 하나의 URL 또는 프로토콜, 호스트, 포트로 지정하고, 백엔드의 문서 루트를 설정합니다. |
| CGI 환경 | SCRIPT_NAME, PATH_INFO, SCRIPT_FILENAME, QUERY_STRING, REMOTE_ADDR, HTTPS | RFC 3875에 따라 구성되며, 모든 요청 헤더가 HTTP_* 변수로 전달됩니다. |
| 추가 변수 | Environment, OnBeforeRequest | Environment로 핸들러별로, 또는 OnBeforeRequest에서 요청별로 변수를 추가합니다. |
| 응답 | CGI 응답 | Status 헤더, Location 리디렉션, 응답 헤더와 본문을 파싱합니다. 여러 Set-Cookie 헤더도 모두 유지됩니다. |
| 게이트웨이 오류 | OnError | 502 Bad Gateway, FastCGI 백엔드가 과부하일 때의 503 Service Unavailable, 504 Gateway Timeout을 각각 OnError로 알립니다. |
| 백엔드 오류 | OnStdErr | FastCGI 백엔드가 보내는 stderr 출력을 전달합니다. |
| 연결 | ConnectTimeout, ReadTimeout, KeepAlive, MaxIdleConnections | 타임아웃은 핸들러별로 설정하며, FastCGI용 선택적 keep-alive 연결 풀(FCGI_KEEP_CONN)도 있습니다. 기본값은 꺼짐입니다. SCGI는 요청마다 연결을 하나씩 엽니다. |
| FastCGI 역할 | Responder | FastCGI Responder 역할입니다. 요청은 하나의 연결에서 멀티플렉싱되지 않습니다. |
| 보안 | 내장 | Proxy 요청 헤더는 HTTP_PROXY로 전달되지 않으며(httpoxy), ..가 포함된 경로는 403으로 거부되고, 밑줄이 들어간 헤더 이름은 무시됩니다. |
| 제한 사항 | TCP, 버퍼링 | TCP 백엔드만 지원하며, Unix 도메인 소켓은 아직 지원하지 않습니다. 백엔드 프로세스는 이미 실행 중이어야 하며, 게이트웨이가 시작하지 않습니다. 응답은 버퍼링되므로 Server-Sent Events 같은 스트리밍은 지원되지 않습니다. |
| 의존성 | 표준 Indy | RAD Studio에 기본으로 포함된 Indy 라이브러리에서 동작하며 sgcCustomIndy가 필요하지 않습니다. Windows와 Linux를 지원합니다. |
| 유닛 및 데모 | sgcHTTP_Gateway | SGC HTTP 팔레트 페이지에 있습니다. 데모는 Demos\20.HTTP_Protocol\18.FastCGI_SCGI_Gateway에 있습니다. |
TsgcHTTP2Client는 ALPN으로 협상되는 단일 TLS 연결 위에서 HTTP/2(RFC 9113)로 통신합니다. 이것이 sgcCustomIndy 위에 구축된 이유입니다.
| 기능 | API | 비고 |
|---|---|---|
| 연결 | Host, Port, Active | 하나의 TLS 연결이 멀티플렉싱되는 모든 요청 스트림을 실어 나릅니다. |
| 연결 열기 | Connect, ConnectAsync | 연결을 열고 같은 호출에서 선택적으로 요청을 발행합니다. |
| 읽기 | Get, GetAsync | 동기 호출이거나, 응답을 이벤트로 전달받는 발사 후 망각 방식입니다. |
| 쓰기 | Post, PostAsync, Put, PutAsync, Patch, PatchAsync | 요청 본문이 스트림이므로 업로드가 메모리에 다 들어갈 필요가 없습니다. |
| Delete & Options | Delete, DeleteAsync, Options, OptionsAsync | 나머지 HTTP 메서드 전체이며, 동일한 동기/비동기 짝을 이룹니다. |
| 응답 | OnHTTP2Response | 요청 객체와 응답 객체를 함께 전달하며, Response.DataString과 상태도 포함됩니다. |
| 청크 본문 | OnHTTP2ResponseFragment | 청크 응답의 각 조각이 도착할 때마다 최종 OnHTTP2Response보다 먼저 발생합니다. |
| 서버 푸시 | OnHTTP2PushPromise | HTTP/2 서버 푸시 리소스가 도착하는 대로 드러냅니다. |
| 연결 생명 주기 | OnHTTP2Connect, OnHTTP2Disconnect, OnHTTP2GoAway, OnHTTP2RSTStream | HTTP/2가 정의하는 연결, 연결 해제, 스트림 리셋 신호입니다. |
| 설정 | HTTP2Options, Settings | 상대방에게 전송되는 로컬 HTTP/2 SETTINGS 프레임 값입니다. |
| 안정성 | WatchDog, HeartBeat, Throttle | 자동 재연결, 킵얼라이브, 요청 스로틀링이며, sgc HTTP 스택 나머지와 공유됩니다. |
| 인증 & TLS | Authentication, TLSOptions, OnHTTP2Authorization | 표준 인증 방식과 TLS 구성, 그리고 커스텀 인증 헤더를 위한 훅입니다. |
| 의존성 | sgcCustomIndy | ALPN이 TLS 핸드셰이크 중 h2 프로토콜을 협상합니다. 표준 Indy 라이브러리는 이를 지원하지 않습니다. |
TsgcGRPCClient는 HTTP/2 클라이언트의 멀티플렉싱 스트림 위에서 Protocol Buffers 페이로드를 실어 나르므로, gRPC의 네 가지 호출 형태를 모두 지원합니다.
| 기능 | API | 비고 |
|---|---|---|
| 전송 | Client | TsgcHTTP2Client 인스턴스입니다. gRPC 클라이언트는 자체 연결을 여는 대신 이 위에 올라탑니다. |
| unary RPC | Call, CallAsync, CallString | 하나의 요청, 하나의 응답입니다. Call은 블로킹되어 TsgcGRPCResponse를 반환하고, CallAsync는 OnGRPCResponse로 전달합니다. |
| 서버 스트리밍 | ServerStreamingCall | 하나의 요청, OnGRPCStreamMessage로 전달되는 응답 스트림이며 OnGRPCStreamEnd까지 이어집니다. |
| 클라이언트 스트리밍 | OpenClientStream, SendStreamMessage, CloseClientStream, CloseClientStreamAsync | 요청 스트림이며, 스트림이 닫힐 때 최종 응답 하나를 받습니다. |
| 양방향 스트리밍 | OpenBidiStream, SendBidiMessage, CloseBidiStream | 같은 호출 위에서 양쪽이 독립적으로 스트리밍합니다. |
| 취소 | CancelCall | 스트림 id로 진행 중인 호출을 취소합니다. |
| 응답 | OnGRPCResponse, OnGRPCStreamMessage, OnGRPCStreamEnd | TsgcGRPCResponse가 StatusCode, Data/DataString, Headers, Trailers를 담습니다. |
| 오류 | OnGRPCError, OnGRPCException | gRPC 상태 코드 오류와 전송 계층 예외를 별도로 전달합니다. |
| 메타데이터 | DefaultMetadata, OnGRPCBeforeRequest | 호출별 및 기본 gRPC 메타데이터 헤더입니다. |
| 복원력 | RetryPolicy, Interceptors, ServiceConfig | 개별 호출 지점을 건드리지 않고도 재시도 동작, 횡단 관심사 인터셉터 체인, 서비스 구성을 제공합니다. |
| 관찰 가능성 | MetricsCollector | 클라이언트의 호출 지표를 수집합니다. |
| 의존성 | sgcCustomIndy | 기반이 되는 HTTP/2 클라이언트에서 물려받으며, ALPN이 동일한 방식으로 필요합니다. |
Google 서비스 계정으로 인증하고 순수 HTTPS로 통신하는 코드 전용 클래스 3종입니다. 어느 것도 sgcCustomIndy가 필요하지 않습니다.
| 기능 | API | 비고 |
|---|---|---|
| 인증 | GoogleCloudOptions.JWT, OnAuthToken, OnAuthTokenError | 서비스 계정 JWT입니다: 프로젝트 ID, 클라이언트 이메일, 개인 키. 세 클라이언트 모두 동일한 형태를 공유합니다. |
| Pub/Sub: 게시 & 가져오기 | Publish, Pull, Acknowledge, Seek | TsgcHTTPGoogleCloud_PubSub_Client. 토픽에 메시지를 보내고, 구독에서 메시지를 가져와 확인합니다. |
| Pub/Sub: 토픽 | CreateTopic, DeleteTopic, GetTopic, ListTopics | 코드에서 직접 토픽을 관리합니다. |
| Pub/Sub: 구독 | CreateSubscription, DeleteSubscripton, ListSubscriptions, ModifyAckDeadlineSubscription | ack 기한 및 push-config 변경을 포함한 구독 생명 주기 전체입니다. |
| Pub/Sub: 스냅샷 | CreateSnapshot, DeleteSnapshot, ListSnapshots | 나중에 재생할 수 있도록 구독의 확인 상태를 스냅샷으로 저장합니다. |
| Calendar: 캘린더 | NewCalendar, UpdateCalendar, DeleteCalendar, LoadCalendars | TsgcHTTPGoogleCloud_Calendar_Client. Google Calendar API v3의 캘린더 목록을 감쌉니다. |
| Calendar: 이벤트 | NewEvent, UpdateEvent, DeleteEvent, LoadEvents | 지정한 캘린더에서 이벤트를 생성, 변경, 삭제합니다. |
| Calendar: 동기화 | LoadCalendarsChanged, LoadEventsChanged, OnGetCalendar, OnGetCalendarEvent | 마지막 동기화 이후 변경된 캘린더와 이벤트를 위한 증분 동기화 훅입니다. |
| FCM: 푸시 | SendMessage | TsgcHTTPGoogleCloud_FCM_Client. 호출 한 번으로 프로젝트에 Firebase Cloud Messaging v1 페이로드를 전송합니다. |
| TLS와 로깅 | TLSOptions, LogFile | 세 Google Cloud 클라이언트 전체에서 공유됩니다. |
와이어 위의 공식 표준을, 지원하는 모든 컴파일러에서 동일한 소스로 사용합니다.
| 영역 | 내용 |
|---|---|
| HTTP 서버 | TsgcHTTPServer를 통한 HTTP 요청과 응답, 정적 파일, 세션, HTTPS입니다. |
| FastCGI / SCGI | TsgcHTTPGateway를 통한 FastCGI Responder 역할과 TCP 기반 SCGI이며, CGI 환경은 RFC 3875에 따라 구성됩니다. |
| HTTP/2 | RFC 9113이며, HPACK 헤더 압축과 ALPN 프로토콜 협상을 포함합니다. |
| gRPC | gRPC 와이어 프로토콜을 따르는, HTTP/2 스트림 위의 Protocol Buffers 페이로드입니다. |
| Google Cloud | Pub/Sub REST API, Google Calendar API v3, Firebase Cloud Messaging HTTP v1 API이며, 모두 Google 서비스 계정으로 인증합니다. |
| 플랫폼 | 다섯 클라이언트 클래스 모두 Windows Win32, Windows Win64, Linux64, macOS, iOS, Android를 지원합니다. FastCGI / SCGI 게이트웨이는 Windows와 Linux에서 동작합니다. |
| 의존성 | HTTP/2와 gRPC 클라이언트는 ALPN을 위해 sgcCustomIndy가 필요합니다. Google Cloud 클라이언트는 번들로 포함된 Core 런타임만 필요합니다. FastCGI / SCGI 게이트웨이는 RAD Studio에 기본으로 포함된 표준 Indy에서 동작하며 sgcCustomIndy가 필요하지 않습니다. |
| 컴파일러 | Delphi와 C++ Builder 7부터 13까지. |
| 에디션 | HTTP/2, gRPC, FastCGI / SCGI 게이트웨이는 sgcWebSockets Enterprise 에디션부터, Google Cloud 클라이언트는 Standard 에디션부터 함께 제공됩니다. HTTP 서버는 Core 런타임에 포함되므로 모든 sgcWebSockets 에디션에도 들어 있습니다. |
| 라이선스 | 단독 제품입니다. sgcWebSockets Core 런타임이 함께 포함되며 전체 소스 코드가 제공됩니다. |