QGrpcHttp2Channel Class

详细说明

QGrpcHttp2Channel 类实现了QAbstractGrpcChannel ，可通过 HTTP/2 框架进行通信。 gRPC™通过HTTP/2 框架进行通信。

HTTP/2 与其前身 HTTP/1.1 相比具有多项优势，因此 QGrpcHttp2Channel 非常适合需要高效通信的高性能实时应用程序，通过使用多路复用 TCP 连接，不会牺牲安全性或可靠性。

通过使用包含所需定制功能的QGrpcChannelOptions 构建该通道，可以定制SSL支持、定制serializationFormat 或其他选项。

传输方案

QGrpcHttp2Channel 实现会根据所提供的hostUri 、scheme 和选项选择不同的传输方式。适用的标准如下：

内容类型

gRPC over HTTP/2 中的内容类型决定了消息的序列化格式。它必须以application/grpc 开头，并可包含后缀。格式遵循此方案：

"content-type": "application/grpc" [("+proto" / "+json" / {custom})]

例如

• application/grpc+proto 指定 Protobuf 编码。
• application/grpc+json 指定 JSON 编码。

可以通过在元数据中指定content-type 或直接设置serializationFormat 来配置序列化格式。默认情况下，使用application/grpc content-type。

要使用content-type 元数据配置 QGrpcHttp2Channel 的 JSON 序列化格式：

auto jsonChannel = std::make_shared<QGrpcHttp2Channel>(
    QUrl("http://localhost:50051"_L1),
    QGrpcChannelOptions().setMetadata({
        { "content-type"_ba, "application/grpc+json"_ba },
    })
);

对于自定义序列化器和content-type ，可以直接设置序列化格式：

class DummySerializer : public QAbstractProtobufSerializer
{
    ...
};
QGrpcSerializationFormat dummyFormat("dummy", std::make_shared<DummySerializer>());

auto dummyChannel = std::make_shared<QGrpcHttp2Channel>(
    QUrl("http://localhost:50051"_L1),
    QGrpcChannelOptions().setSerializationFormat(dummyFormat)
);

这将使用DummySerializer 对带有dummy 后缀的消息进行编码和解码。对于 HTTP/2 传输，这将导致application/grpc+dummy content-type。