QGrpcSerializationFormat Class
QGrpcSerializationFormat 类保存了 protobuf 消息序列化器和相关的内容类型后缀。更多
| 头文件： | #include <QGrpcSerializationFormat> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Grpc)target_link_libraries(mytarget PRIVATE Qt6::Grpc) |
| 自 | Qt 6.8 |
该类具有等价可比性。
公共函数
| QGrpcSerializationFormat(QtGrpc::SerializationFormat format = {}) | |
| QGrpcSerializationFormat(QByteArrayView suffix, std::shared_ptr<QAbstractProtobufSerializer> serializer) | |
| QGrpcSerializationFormat(const QGrpcSerializationFormat &other) | |
| QGrpcSerializationFormat(QGrpcSerializationFormat &&other) | |
| ~QGrpcSerializationFormat() | |
| std::shared_ptr<QAbstractProtobufSerializer> | serializer() const |
| QByteArrayView | suffix() const |
(since 6.8) void | swap(QGrpcSerializationFormat &other) |
(since 6.8) QVariant | operator QVariant() const |
| QGrpcSerializationFormat & | operator=(QGrpcSerializationFormat &&other) |
| QGrpcSerializationFormat & | operator=(const QGrpcSerializationFormat &other) |
相关非成员
(since 6.8) QDebug | operator<<(QDebug debug, const QGrpcSerializationFormat &sfmt) |
详细说明
QGrpcSerializationFormat 类包含用于序列化和反序列化 protobuf 消息的serializer ，以及相关的 content-typesuffix ，后者表示传输中的消息编码。有关 HTTP/2 的具体细节，请参阅Content-Type 部分。
注： 内容类型是传输类型，因此与具体实现有关。
该类可以使用SerializationFormat 预设之一或自定义后缀和序列化器构建：
QGrpcSerializationFormat jsonFormat(QtGrpc::SerializationFormat::Json);
这会创建一个带有json 后缀的QProtobufJsonSerializer 。对于 HTTP/2 传输，这将导致application/grpc+json content-type。
class DummySerializer : public QAbstractProtobufSerializer { ... }; QGrpcSerializationFormat dummyFormat("dummy", std::make_shared<DummySerializer>());
使用DummySerializer 对带有dummy 后缀的信息进行编码和解码。对于 HTTP/2 传输，这将导致application/grpc+dummy 内容类型。
注： 自定义序列化器要求服务器支持指定格式。
另请参阅 QGrpcChannelOptions::serializationFormat 。
成员函数文档
QGrpcSerializationFormat::QGrpcSerializationFormat(QtGrpc::SerializationFormat format = {})
使用指定的预设format 构建一个新的 QGrpcSerializationFormat。
默认使用的格式是SerializationFormat::Default 。
[explicit] QGrpcSerializationFormat::QGrpcSerializationFormat(QByteArrayView suffix, std::shared_ptr<QAbstractProtobufSerializer> serializer)
构建一个新的 QGrpcSerializationFormat，其自定义内容类型由suffix 和一个 protobuf 消息serializer 指定。
QGrpcSerializationFormat::QGrpcSerializationFormat(const QGrpcSerializationFormat &other)
构造other 的副本。
[noexcept] QGrpcSerializationFormat::QGrpcSerializationFormat(QGrpcSerializationFormat &&other)
移动-从other 构建一个新的 QGrpcSerializationFormat。
注意： 从other 移动来的对象处于部分形成状态，在这种状态下，唯一有效的操作是销毁和赋一个新值。
[noexcept] QGrpcSerializationFormat::~QGrpcSerializationFormat()
std::shared_ptr<QAbstractProtobufSerializer> QGrpcSerializationFormat::serializer() const
返回此序列化格式的序列化器。
/saQAbstractProtobufSerializer
[noexcept] QByteArrayView QGrpcSerializationFormat::suffix() const
返回此序列化格式的内容类型后缀。
[noexcept, since 6.8] void QGrpcSerializationFormat::swap(QGrpcSerializationFormat &other)
与该对象交换other 。该操作速度非常快，而且不会失败。
此函数在 Qt 6.8 中引入。
[since 6.8] QVariant QGrpcSerializationFormat::operator QVariant() const
从该对象构建一个新的QVariant 。
此函数在 Qt 6.8 中引入。
[noexcept] QGrpcSerializationFormat &QGrpcSerializationFormat::operator=(QGrpcSerializationFormat &&other)
Move 将other 赋值给QGrpcSerializationFormat 实例，并返回该实例的引用。
注意： 从移动对象other 将处于部分形成状态，在这种状态下，唯一有效的操作是销毁和分配新值。
QGrpcSerializationFormat &QGrpcSerializationFormat::operator=(const QGrpcSerializationFormat &other)
将other QGrpcSerializationFormat 对象分配给此对象。
相关非会员
[since 6.8] QDebug operator<<(QDebug debug, const QGrpcSerializationFormat &sfmt)
将sfmt 写入指定的流debug 。
该函数在 Qt 6.8 中引入。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
