QGrpcCallOptions Class
QGrpcCallOptions 类为微调单个 RPC 提供了各种选项。更多
| Header： | #include <QGrpcCallOptions> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Grpc)target_link_libraries(mytarget PRIVATE Qt6::Grpc) |
| 自 | Qt 6.6 |
| 在 QML 中： | GrpcCallOptions |
公共函数
| QGrpcCallOptions() | |
| QGrpcCallOptions(const QGrpcCallOptions &other) | |
| QGrpcCallOptions(QGrpcCallOptions &&other) | |
| ~QGrpcCallOptions() | |
| std::optional<std::chrono::milliseconds> | deadlineTimeout() const |
| QHash<QByteArray, QByteArray> | metadata() && |
| const QHash<QByteArray, QByteArray> & | metadata() const & |
| QGrpcCallOptions & | setDeadlineTimeout(std::chrono::milliseconds timeout) |
| QGrpcCallOptions & | setMetadata(QHash<QByteArray, QByteArray> &&metadata) |
| QGrpcCallOptions & | setMetadata(const QHash<QByteArray, QByteArray> &metadata) |
(since 6.8) void | swap(QGrpcCallOptions &other) |
(since 6.8) QVariant | operator QVariant() const |
| QGrpcCallOptions & | operator=(QGrpcCallOptions &&other) |
| QGrpcCallOptions & | operator=(const QGrpcCallOptions &other) |
相关非成员
(since 6.8) QDebug | operator<<(QDebug debug, const QGrpcCallOptions &callOpts) |
详细说明
QGrpcCallOptions 可让您自定义单个远程过程调用（RPC）。生成的客户端接口提供了传递 QGrpcCallOptions 的接入点。这些选项取代通过QGrpcChannelOptions 设置的选项。
要配置 RPC 共享的默认选项，请使用QGrpcChannelOptions 。
成员函数文档
QGrpcCallOptions &QGrpcCallOptions::setMetadata(QHash<QByteArray, QByteArray> &&metadata)
QGrpcCallOptions &QGrpcCallOptions::setMetadata(const QHash<QByteArray, QByteArray> &metadata)
为特定 RPC 设置客户端metadata ，并返回更新对象的引用。
QGrpcHttp2Channel 将元数据转换为适当的 HTTP/2 标头，并添加到 HTTP/2 请求中。
注意： 设置此字段会覆盖QGrpcChannelOptions::setMetadata() 为特定 RPC 设置的值。
QHash<QByteArray, QByteArray> QGrpcCallOptions::metadata() &&
[noexcept] const QHash<QByteArray, QByteArray> &QGrpcCallOptions::metadata() const &
返回特定 RPC 的客户端元数据。如果未设置该字段，则返回空元数据。
QGrpcCallOptions::QGrpcCallOptions()
Default-构造一个空的 QGrpcallOptions。
QGrpcCallOptions::QGrpcCallOptions(const QGrpcCallOptions &other)
从other 复制构造一个 QGrpcCallOptions。
[noexcept] QGrpcCallOptions::QGrpcCallOptions(QGrpcCallOptions &&other)
移动-从other 构建一个新的 QGrpcCallOptions。
注意： moved-from 对象other 处于部分形成状态，其中唯一有效的操作是销毁和赋新值。
[noexcept] QGrpcCallOptions::~QGrpcCallOptions()
[noexcept] std::optional<std::chrono::milliseconds> QGrpcCallOptions::deadlineTimeout() const
返回用于计算特定 RPC 截止时间的超时持续时间。
如果未设置此字段，则返回空std::optional 。
另请参阅 setDeadlineTimeout() 。
QGrpcCallOptions &QGrpcCallOptions::setDeadlineTimeout(std::chrono::milliseconds timeout)
设置特定 RPC 的timeout ，并返回更新对象的引用。
截止时间设定了客户端愿意等待服务器响应的时间限制。实际的截止时间是通过将timeout 与 RPC 的开始时间相加来计算的。
截止时间适用于 RPC 的整个生命周期，其中包括接收先前启动的调用的最终QGrpcStatus ，因此对于（长生命周期的）数据流来说，截止时间是不需要的。
注意： 设置此字段将覆盖 QGrpcChannelOptions::setDeadline() 为特定 RPC 设置的值。
另请参阅 deadlineTimeout().
[noexcept, since 6.8] void QGrpcCallOptions::swap(QGrpcCallOptions &other)
与该对象交换other 。该操作速度非常快，而且不会失败。
此函数在 Qt 6.8 中引入。
[since 6.8] QVariant QGrpcCallOptions::operator QVariant() const
从该对象构建一个新的QVariant 。
此函数在 Qt 6.8 中引入。
[noexcept] QGrpcCallOptions &QGrpcCallOptions::operator=(QGrpcCallOptions &&other)
Move 将other 赋值给QGrpcCallOptions ，并返回对更新对象的引用。
注意： 从移动对象other 将处于部分形成状态，在这种状态下，唯一有效的操作是销毁和分配新值。
QGrpcCallOptions &QGrpcCallOptions::operator=(const QGrpcCallOptions &other)
将other 指定为QGrpcCallOptions ，并返回更新对象的引用。
相关非成员
[since 6.8] QDebug operator<<(QDebug debug, const QGrpcCallOptions &callOpts)
将callOpts 写入指定的流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.
