QGrpcHttp2Channel Class

詳しい説明

QGrpcHttp2Channel クラスはQAbstractGrpcChannel を実装しています。 gRPC™を実装しています。

HTTP/2は、その前身であるHTTP/1.1よりもいくつかの利点を導入しており、QGrpcHttp2Channelは、多重化されたTCP接続を使用することで、セキュリティや信頼性を犠牲にすることなく、効率的な通信を必要とする高性能なリアルタイムアプリケーションに適しています。

このチャネルは、必要なカスタマイズを含むQGrpcChannelOptions を使って構築することで、SSLサポートやカスタムserializationFormat 、その他のオプションでカスタマイズすることができます。

転送スキーム

QGrpcHttp2Channelの実装は、提供されたhostUri 、scheme 、オプションに基づいて、さまざまな転送方式を好みます。以下の基準が適用されます：

コンテントタイプ

gRPC over HTTP/2のcontent-typeは、メッセージのシリアライズ形式を決定します。これはapplication/grpc で始まり、接尾辞を含むことができます。フォーマットはこのスキームに従います：

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

例えば

• application/grpc+proto はProtobufエンコーディングを指定します。
• application/grpc+json はJSONエンコーディングを指定します。

シリアライズ形式は、メタデータ内でcontent-type を指定するか、serializationFormat を直接設定することで設定できます。デフォルトでは、application/grpc content-typeが使用されます。

QGrpcHttp2ChannelをJSONシリアライズフォーマットで設定するには、content-type メタデータを使用します：

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)
);

これは、dummy サフィックスを持つメッセージのエンコードとデコードにDummySerializer を使用します。HTTP/2トランスポートでは、これはapplication/grpc+dummy content-typeになります。