QGrpcHttp2Channel Class

Description détaillée

La classe QGrpcHttp2Channel implémente QAbstractGrpcChannel, permettant une communication gRPC™ la communication par le biais d'une trame HTTP/2.

HTTP/2 présente plusieurs avantages par rapport à son prédécesseur, HTTP/1.1, ce qui rend QGrpcHttp2Channel bien adapté aux applications en temps réel à haute performance qui nécessitent une communication efficace, sans sacrifier la sécurité ou la fiabilité, en utilisant des connexions TCP multiplexées.

Le canal peut être personnalisé avec la prise en charge de SSL, un serializationFormat personnalisé ou d'autres options en le construisant avec un QGrpcChannelOptions contenant les personnalisations requises.

Schéma de transport

L'implémentation de QGrpcHttp2Channel préfère différentes méthodes de transport basées sur les hostUri, scheme et les options fournies. Les critères suivants s'appliquent :

Type de contenu

Le type de contenu dans gRPC sur HTTP/2 détermine le format de sérialisation du message. Il doit commencer par application/grpc et peut inclure un suffixe. Le format suit ce schéma :

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

Par exemple :

• application/grpc+proto spécifie l'encodage Protobuf.
• application/grpc+json spécifie le codage JSON.

Le format de sérialisation peut être configuré soit en spécifiant le content-type dans les métadonnées, soit en définissant directement le serializationFormat. Par défaut, le type de contenu application/grpc est utilisé.

Pour configurer QGrpcHttp2Channel avec le format de sérialisation JSON en utilisant les métadonnées content-type:

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

Pour un sérialiseur personnalisé et content-type, vous pouvez définir directement le format de sérialisation :

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

Ceci utilise DummySerializer pour encoder et décoder les messages avec le suffixe dummy. Pour le transport HTTP/2, cela se traduit par le type de contenu application/grpc+dummy.