QGrpcHttp2Channel Class

Descripción detallada

La clase QGrpcHttp2Channel implementa QAbstractGrpcChannel, permitiendo gRPC™ comunicación a través de HTTP/2.

HTTP/2 introduce varias ventajas sobre su predecesor, HTTP/1.1, haciendo que QGrpcHttp2Channel sea muy adecuado para aplicaciones de alto rendimiento y en tiempo real que requieren una comunicación eficiente, sin sacrificar la seguridad o la fiabilidad, mediante el uso de conexiones TCP multiplexadas.

El canal puede ser personalizado con soporte SSL, un serializationFormat personalizado, u otras opciones construyéndolo con un QGrpcChannelOptions que contenga las personalizaciones requeridas.

Esquema de transporte

La implementación de QGrpcHttp2Channel prefiere diferentes métodos de transporte basados en el hostUri, scheme y las opciones proporcionadas. Se aplican los siguientes criterios:

Tipo de contenido

El tipo de contenido en gRPC sobre HTTP/2 determina el formato de serialización del mensaje. Debe empezar por application/grpc y puede incluir un sufijo. El formato sigue este esquema:

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

Por ejemplo

• application/grpc+proto especifica la codificación Protobuf.
• application/grpc+json especifica la codificación JSON.

El formato de serialización puede configurarse especificando content-type dentro de los metadatos o configurando directamente serializationFormat. Por defecto, se utiliza el tipo de contenido application/grpc.

Para configurar QGrpcHttp2Channel con el formato de serialización JSON utilizando los metadatos content-type:

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

Para un serializador personalizado y content-type, puede configurar directamente el formato de serialización:

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

Esto utiliza DummySerializer para codificar y decodificar mensajes con el sufijo dummy. Para el transporte HTTP/2, esto da como resultado el tipo de contenido application/grpc+dummy.