看它实际运行

两分钟了解 sgcHTTP

适用于 Delphi 和 C++Builder 的 HTTP 服务器、HTTP/2 与 gRPC 客户端，另含现成的 Google Cloud、Amazon 和 Apple Push 集成。

购买前须知

两件值得先了解的事

sgcHTTP 需要您准备什么，以及不需要什么。两个答案都很简短。

sgcHTTP 是自包含的

作为独立产品，已包含 sgcWebSockets Core 运行时：HTTP 服务器、每个客户端发出请求所使用的 HTTP/TLS 客户端栈，以及解析 Google Cloud 响应的 JSON 层。一个 SKU，一个安装程序。

每份授权都附带完整源代码，因此 HTTP 服务器、全部五个客户端及其底层运行时都可以在您自己的调试器中单步跟踪，而不会消失在二进制文件里。

五分之二需要附加包

HTTP/2 和 gRPC 需要 sgcCustomIndy

HTTP/2 在 TLS 握手期间通过 ALPN 协商 h2 协议，而 RAD Studio 自带的标准 Indy 库不支持 ALPN。因此 sgcHTTP 的 HTTP/2 客户端和 gRPC 客户端改为构建在 sgcCustomIndy 之上，订购 sgcHTTP 时始终包含在内，所显示的价格已经包含它。

三个 Google Cloud 客户端 Pub/Sub、Calendar 和 Firebase Cloud Messaging 都是纯 HTTPS。它们直接运行在 Core 运行时之上，完全不需要 sgcCustomIndy。

包含内容

三个面板组件，三个 Google Cloud 客户端

HTTP 服务器、HTTP/2 客户端和 gRPC 客户端是 SGC HTTP 面板页上的非可视化组件。服务器声明在内置 Core 运行时的 sgcHTTP_Server 单元中，两个客户端声明在 sgcHTTP 单元中。可以拖放到窗体上，也可以在代码中创建，设置连接选项，接好事件，然后调用带类型的请求方法。三个 Google Cloud 客户端位于同一个单元中，是纯代码类，没有可拖放到窗体上的内容：创建一个实例，设置 GoogleCloudOptions，然后直接调用其方法。

HTTP 服务器1 个组件

发布 HTTP 端点和静态文件

TsgcHTTPServer 可将您的 Delphi 或 C++ Builder 应用程序变成 HTTP 服务器。设置 Port，处理 OnCommandGet，把 Active 设为 true，每个请求就会连同其请求和响应对象一起到达您的代码，而 OnCommandOther 则涵盖 PUT 和 DELETE 等其他方法。将 DocumentRoot 指向一个文件夹，服务器就会从中返回静态文件。HTTPCompression 压缩响应，KeepAlive 复用连接，SessionState 配合 OnSessionStart 和 OnSessionEnd 跟踪会话，MaxRequestBodySize 限制请求正文大小，HTTPUploadFiles 将上传的文件保存到磁盘。用于生产环境时，SSL 和 SSLOptions 启用 TLS，Authentication 和 OnAuthentication 保护您的端点，ThreadPool 和 MaxConnections 控制其扩展方式。它与 sgcWebSockets WebSocket 服务器采用相同的引擎，只是没有 WebSocket 部分，并随内置的 Core 运行时一同提供。

TsgcHTTPServer 随 Core 运行时提供

HTTP/21 个组件

在一条 TLS 连接上实现多路复用流

TsgcHTTP2Client 使用 HTTP/2（RFC 9113）协议：多个请求作为独立的流共享同一条 TCP 连接，因此一个响应慢不会阻塞排在它后面的其他请求。头部使用 HPACK 压缩，h2 协议在 TLS 握手期间通过 ALPN 协商，这也是该组件构建在 sgcCustomIndy 而非标准 Indy 库之上的原因。所有动词均已覆盖：Connect、Get、Post、Put、Patch、Delete 和 Options，每一个都有同步调用和对应的 Async 版本。事件覆盖连接的整个生命周期：OnHTTP2Connect、OnHTTP2Response、用于分块响应体的 OnHTTP2ResponseFragment、用于服务器推送的 OnHTTP2PushPromise，以及 OnHTTP2GoAway 和 OnHTTP2Disconnect。HTTP2Options 配置本地设置帧，TLSOptions 和 Authentication 则沿用 sgc HTTP 技术栈的其余部分。

TsgcHTTP2Client 需要 sgcCustomIndy

gRPC1 个组件

基于 HTTP/2 客户端的一元和流式 RPC

TsgcGRPCClient 构建在 HTTP/2 客户端之上，因此继承了多路复用连接，并在其上添加了 gRPC 线路格式：在 HTTP/2 流上传输带长度前缀的 Protocol Buffers 消息。Call 和 CallAsync 覆盖一元 RPC，ServerStreamingCall 处理针对一个请求的响应流，OpenClientStream/SendStreamMessage/CloseClientStream 以及 OpenBidiStream/SendBidiMessage/CloseBidiStream 则覆盖客户端流式和双向流式 RPC。OnGRPCResponse、OnGRPCStreamMessage 和 OnGRPCStreamEnd 负责传递流量，RetryPolicy、Interceptors 和 ServiceConfig 在不改动调用点的情况下添加重试行为、横切逻辑和服务配置。与它所基于的 HTTP/2 客户端一样，它也需要 sgcCustomIndy 来支持 ALPN。

TsgcGRPCClient 需要 sgcCustomIndy

Google Cloud3 个类

Pub/Sub、Calendar 与推送通知，纯 HTTPS

另外三个类通过纯 HTTPS 对接 Google Cloud 服务，使用 Google 服务账号进行身份验证，且都不需要 sgcCustomIndy。TsgcHTTPGoogleCloud_PubSub_Client 发布和拉取消息，并管理主题、订阅和快照：Publish、Pull、Acknowledge、CreateTopic、CreateSubscription，以及其余 Pub/Sub REST 接口。TsgcHTTPGoogleCloud_Calendar_Client 封装了 Google Calendar API v3：NewCalendar、NewEvent、LoadEvents 和 LoadCalendars，并提供 OnGetCalendar 和 OnGetCalendarEvent 事件用于同步。TsgcHTTPGoogleCloud_FCM_Client 只需一次调用 SendMessage 即可向 Firebase 项目发送推送通知负载。三者都是纯代码类：创建实例，设置 GoogleCloudOptions，调用方法即可。

TsgcHTTPGoogleCloud_PubSub_Client TsgcHTTPGoogleCloud_Calendar_Client TsgcHTTPGoogleCloud_FCM_Client

工作原理

两个依赖，而不是五个

这五个类根据底层所需依赖清晰地分成两组。HTTP/2 和 gRPC 需要 ALPN，也就是需要 sgcCustomIndy。Google Cloud 除了 HTTPS 和一个服务账号之外什么都不需要，而内置的 Core 运行时已经提供了这些。

HTTP/2 需要 ALPN，因此需要 sgcCustomIndy

应用层协议协商（ALPN）在 TLS 握手期间选定 h2 协议，而 RAD Studio 自带的标准 Indy 库不支持 ALPN。因此 TsgcHTTP2Client 改为构建在 eSeGeCe 定制的 Indy 编译版本 sgcCustomIndy 之上。

gRPC 是搭载在 HTTP/2 客户端上的 Protocol Buffers

TsgcGRPCClient 不会打开自己的连接，它的 Client 属性就是一个 TsgcHTTP2Client。一元、服务端流式、客户端流式和双向调用底层都是作为 HTTP/2 流传输的。

Google Cloud 就是 HTTPS 加一个服务账号

三个 Google Cloud 客户端使用 GoogleCloudOptions.JWT 进行身份验证，即 Google 服务账号的项目 id、客户端邮箱和私钥，并通过 Core 运行时的纯 HTTPS 栈调用 REST API。OnAuthToken 和 OnAuthTokenError 呈现令牌交换过程。

内置 Core 运行时

作为独立产品，已包含 sgcWebSockets Core 运行时。它提供 TsgcHTTPServer 以及全部五个客户端调用所使用的 HTTP/TLS 客户端栈，其完整源代码也和其他一切一样，是本产品包的一部分。

快速入门

HTTP 服务器、HTTP/2 与 gRPC，并肩使用

两个客户端声明在 sgcHTTP 单元中，服务器声明在 sgcHTTP_Server 中，TsgcGRPCClient 通过其 Client 属性携带自己的 HTTP/2 连接。同一份代码可在 Delphi 7 到 13 以及 C++ Builder 中编译。

uses
  sgcHTTP, sgcHTTP_Server;

var
  Server: TsgcHTTPServer;
  HTTP2: TsgcHTTP2Client;
  GRPC: TsgcGRPCClient;
begin
  // HTTP server: endpoints and static files
  Server := TsgcHTTPServer.Create(nil);
  Server.Port := 8080;
  Server.DocumentRoot := 'C:\www';
  Server.OnCommandGet := ServerCommandGet;
  Server.Active := True;

  // HTTP/2: multiplexed requests over one TLS connection
  HTTP2 := TsgcHTTP2Client.Create(nil);
  HTTP2.Host := 'https://api.example.com';
  HTTP2.OnHTTP2Response := HTTP2Response;
  HTTP2.Active := True;

  HTTP2.GetAsync('/v1/status');

  // gRPC: built on the HTTP/2 client, unary and streaming RPC
  GRPC := TsgcGRPCClient.Create(nil);
  GRPC.Client.Host := 'https://grpc.example.com';
  GRPC.OnGRPCResponse := GRPCResponse;

  GRPC.CallAsync('example.OrderService', 'GetOrder', RequestBytes);
end;

procedure TForm1.HTTP2Response(Sender: TObject;
  const Connection: TsgcHTTP2ConnectionClient;
  const Request: TsgcHTTP2RequestProperty;
  const Response: TsgcHTTP2ResponseProperty);
begin
  Memo1.Lines.Add(Response.DataString);
end;

procedure TForm1.GRPCResponse(Sender: TObject;
  const aResponse: TsgcGRPCResponse);
begin
  Memo1.Lines.Add(aResponse.DataString);
end;

procedure TForm1.ServerCommandGet(AContext: TIdContext;
  ARequestInfo: TIdHTTPRequestInfo; AResponseInfo: TIdHTTPResponseInfo);
begin
  if ARequestInfo.Document = '/api/status' then
  begin
    AResponseInfo.ContentType := 'application/json';
    AResponseInfo.ContentText := '{"status":"ok"}';
  end;
end;

// include: sgcHTTP.hpp, sgcHTTP_Server.hpp

// HTTP server: endpoints and static files
TsgcHTTPServer *Server = new TsgcHTTPServer(this);
Server->Port = 8080;
Server->DocumentRoot = "C:\\www";
Server->OnCommandGet = ServerCommandGet;
Server->Active = true;

// HTTP/2: multiplexed requests over one TLS connection
TsgcHTTP2Client *HTTP2 = new TsgcHTTP2Client(this);
HTTP2->Host = "https://api.example.com";
HTTP2->OnHTTP2Response = HTTP2Response;
HTTP2->Active = true;

HTTP2->GetAsync("/v1/status");

// gRPC: built on the HTTP/2 client, unary and streaming RPC
TsgcGRPCClient *GRPC = new TsgcGRPCClient(this);
GRPC->Client->Host = "https://grpc.example.com";
GRPC->OnGRPCResponse = GRPCResponse;

GRPC->CallAsync("example.OrderService", "GetOrder", RequestBytes);

void __fastcall TForm1::HTTP2Response(TObject *Sender,
    const TsgcHTTP2ConnectionClient* Connection,
    const TsgcHTTP2RequestProperty* Request,
    const TsgcHTTP2ResponseProperty* Response)
{
  Memo1->Lines->Add(Response->DataString);
}

void __fastcall TForm1::GRPCResponse(TObject *Sender,
    const TsgcGRPCResponse* aResponse)
{
  Memo1->Lines->Add(aResponse->DataString);
}

void __fastcall TForm1::ServerCommandGet(TIdContext *AContext,
    TIdHTTPRequestInfo *ARequestInfo, TIdHTTPResponseInfo *AResponseInfo)
{
  if (ARequestInfo->Document == "/api/status")
  {
    AResponseInfo->ContentType = "application/json";
    AResponseInfo->ContentText = "{\"status\":\"ok\"}";
  }
}

平台

两个客户端需要一个依赖，另外三个则不需要

HTTP/2 客户端和 gRPC 客户端构建在 sgcCustomIndy 之上，其平台覆盖范围与 sgcWebSockets 本身一致。Google Cloud 客户端是纯 HTTPS，因此可以在 Core 运行时支持的任何平台上运行。

TsgcHTTP2Client & TsgcGRPCClient 为支持 ALPN 而构建在 sgcCustomIndy 之上

Windows Win32 Windows Win64 Linux64 macOS iOS Android

Google Cloud 客户端 纯 HTTPS，无需 sgcCustomIndy

Windows Win32 Windows Win64 Linux64 macOS iOS Android

IDE 支持 一份源码树，每个版本各有设计期包

Delphi 7 到 13 C++ Builder

试用安装程序 sgcWebSockets All-Access 试用版包含 sgcHTTP 组件

一次下载，服务器和全部五个客户端

下载试用安装程序 →

价格

一个独立的包

sgcHTTP 单独授权，单个开发者起价 €398。所有授权均包含完整源代码、1 年更新，以及 50% 到 70% 的续订折扣：续订 1 个包为 50%，2 个包为 60%，3 个及以上为 70%。sgcAI、sgcMQ、sgcSocial、sgcCustomIndy、sgcAuth、sgcHTTP 和 sgcREST 各算作一个包。sgcHTTP 也包含在 All-Access 套装中。

sgcHTTP

€398

提供 Single、Team 和 Site 授权。

HTTP 服务器，支持静态文件、会话和 TLS
HTTP/2 客户端，支持多路复用和 HPACK
gRPC 客户端，支持一元和流式 RPC
Google Cloud Pub/Sub、Calendar 和 FCM 客户端
已包含 sgcWebSockets Core 运行时
Delphi 7 到 13 和 C++ Builder
完整源代码
1 年更新

HTTP/2 和 gRPC 需要 sgcCustomIndy 附加包。它始终包含在您的订单中，所显示的价格已经包含它。

购买 Single 授权 €398

Team €648 Site €1,048

结算页面会列出三项：计价为零的 sgcWebSockets Core 运行时授权、sgcHTTP 包本身，以及始终包含的 sgcCustomIndy 附加包。查看完整价格详情。

eSeGeCe 的更多产品

eSeGeCe 的其他产品

把 sgcHTTP 与我们其他的 Delphi、C++ Builder 和 .NET 组件库搭配使用。

sgcCustomIndy

sgcHTTP 的 HTTP/2 和 gRPC 客户端所基于的定制 Indy 库：ALPN、TLS 1.3 与静态 OpenSSL 链接。

了解更多 →

sgcWebSockets

完整的库：WebSocket 客户端和服务器、HTTP/2、gRPC、IoT、P2P 和 AI 组件。它的 Enterprise 版本也包含 gRPC。

了解更多 →

sgcAI

AI、LLM 与 MCP 组件。一个聊天组件即可接入 OpenAI、Anthropic、Gemini、DeepSeek、Ollama、Grok 和 Mistral。

了解更多 →

sgcMQ

原生 MQTT 3.1.1/5.0、AMQP 0.9.1、AMQP 1.0、Apache Kafka 和 STOMP 客户端组件，已内置 Core 运行时。

了解更多 →

sgcSocial

WhatsApp Business Cloud API 和 Telegram TDLib 客户端组件，已内置 Core 运行时。

了解更多 →

sgcQUIC

基于 OpenSSL 3.5 原生 QUIC 引擎构建的 QUIC (RFC 9000) 与 HTTP/3 (RFC 9114) 客户端和服务器组件。

了解更多 →

sgcWebRTC

完整的 WebRTC 媒体引擎：音视频通话、数据通道和屏幕共享。sgcWebSockets Enterprise 的附加组件。

了解更多 →

sgcCrypto

对称与非对称加密算法、哈希和后量子算法。自 sgcWebSockets Standard 起免费提供。

了解更多 →

sgcHTTP：面向 Delphi 和 C++ Builder 的 HTTP 服务器、HTTP/2、gRPC 与 Google Cloud 组件

两分钟了解 sgcHTTP

两件值得先了解的事

sgcHTTP 是自包含的

HTTP/2 和 gRPC 需要 sgcCustomIndy

三个面板组件，三个 Google Cloud 客户端

发布 HTTP 端点和静态文件

在一条 TLS 连接上实现多路复用流

基于 HTTP/2 客户端的一元和流式 RPC

Pub/Sub、Calendar 与推送通知，纯 HTTPS

两个依赖，而不是五个

HTTP 服务器、HTTP/2 与 gRPC，并肩使用

两个客户端需要一个依赖，另外三个则不需要

一个独立的包

sgcHTTP

在原生代码中使用现代 HTTP、gRPC 和 Google Cloud

eSeGeCe 的其他产品

sgcCustomIndy

sgcWebSockets

sgcAI

sgcMQ

sgcSocial

sgcQUIC

sgcWebRTC

sgcCrypto