Native gRPC client component for Delphi/C++Builder. Unary and streaming calls over HTTP/2, custom metadata, deadlines, gzip compression, interceptors, automatic retry and TLS via OpenSSL or Windows SChannel. Bring any Protocol Buffers encoder; the component frames and ships your message bytes.
A typed gRPC client that runs on top of the native TsgcHTTP2Client transport. Unary and all three streaming modes, status and trailer parsing, no external gRPC runtime or C library.
TsgcGRPCClient
gRPC over HTTP/2 (RFC 9113)
Windows, macOS, Linux, iOS, Android
Enterprise
Drop a TsgcHTTP2Client and a TsgcGRPCClient on a form, assign the transport, then call your service method with the request bytes.
uses
sgcHTTP2, sgcGRPC_Client, sgcGRPC_Classes, sgcGRPC_Types;
var
HTTP2: TsgcHTTP2Client;
GRPC: TsgcGRPCClient;
oResponse: TsgcGRPCResponse;
begin
// gRPC runs over an HTTP/2 transport
HTTP2 := TsgcHTTP2Client.Create(nil);
HTTP2.Host := 'grpc.example.com';
HTTP2.Port := 443;
HTTP2.TLS := True;
GRPC := TsgcGRPCClient.Create(nil);
GRPC.Client := HTTP2;
// default metadata sent on every call (auth, tracing...)
GRPC.DefaultMetadata.Add('authorization', 'Bearer eyJ...');
// unary call: pass your serialized protobuf message as TBytes
oResponse := GRPC.Call('helloworld.Greeter', 'SayHello', RequestBytes);
if oResponse.StatusCode = grpcOK then
Memo1.Text := oResponse.DataString
else
ShowMessage('gRPC error: ' + oResponse.StatusMessage);
end;// uses: sgcHTTP2, sgcGRPC_Client, sgcGRPC_Classes, sgcGRPC_Types
TsgcHTTP2Client *HTTP2 = new TsgcHTTP2Client(NULL);
HTTP2->Host = "grpc.example.com";
HTTP2->Port = 443;
HTTP2->TLS = true;
TsgcGRPCClient *GRPC = new TsgcGRPCClient(NULL);
GRPC->Client = HTTP2;
GRPC->DefaultMetadata->Add("authorization", "Bearer eyJ...");
TsgcGRPCResponse *oResponse = GRPC->Call("helloworld.Greeter", "SayHello", RequestBytes);
if (oResponse->StatusCode == grpcOK)
Memo1->Text = oResponse->DataString;A complete gRPC client built on the sgcHTTP2 framing engine. Four call types, channel tuning, metadata, deadlines, interceptors and retry.
Call blocks and returns a TsgcGRPCResponse with StatusCode, StatusMessage, Data and Trailers. CallAsync returns immediately and fires OnGRPCResponse.
ServerStreamingCall sends one request and receives a stream of messages. Each message raises OnGRPCStreamMessage; OnGRPCStreamEnd fires with the final status.
OpenClientStream opens the stream, SendStreamMessage pushes each message, and CloseClientStream half-closes and reads the single server reply.
OpenBidiStream, SendBidiMessage and CloseBidiStream run a full-duplex exchange over a single HTTP/2 stream, both sides sending at once.
DefaultMetadata and per-call metadata carry auth and tracing headers. A per-call timeout maps to the grpc-timeout header, and CancelCall aborts an in-flight stream.
ChannelOptions tunes gzip Compression, ContentType, MaxMessageSize and MaxMetadataSize for the whole channel.
An Interceptors chain wraps every call, RetryPolicy retries on configurable status codes, and ServiceConfig plus MetricsCollector add per-method policy and counters.
The transport is TsgcHTTP2Client: ALPN h2, TLS via OpenSSL or SChannel, and parsing of grpc-status / grpc-message trailers into typed status codes.
Calls take and return raw message bytes, so any Protocol Buffers library works. Typed Google Cloud clients (Pub/Sub, Speech, Translation, Vision, BigQuery, Vertex AI) ship on top.
Authoritative sources for the protocol this component implements.
Deep-link to the component reference, grab the ready-to-run demo project, and download the trial.
| Online Help — TsgcGRPCClient Full property, method and event reference for this component. | Open | |
| Demo Project — Demos\21.GRPC\01.GRPC_Client Ready-to-run example project. Ships inside the sgcWebSockets package — download the trial below. | Open | |
| Technical Document (PDF) Features, quick start, code samples for Delphi & C++ Builder and primary-source references — this component only. | Open | |
| User Manual (PDF) Comprehensive manual covering every component in the library. | Open |