QGrpcCallOptions Class
QGrpcCallOptionsクラスは、個々のRPCを微調整するための様々なオプションを提供します。詳細...
| ヘッダー | #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 ヘッダーとして転送します。キーは大文字小文字を区別しない ASCII 文字列です。: (擬似ヘッダ)、grpc- 、またはqtgrpc- という内部接頭辞の使用は避けなければなりません。値はASCII 文字列またはバイナリ・データです。詳細はRFC 7540のセクション8.1.2を参照。
注： このフィールドを設定すると、特定の RPC に対してQGrpcChannelOptions::setMetadata() で設定された値が上書きされる。
QHash<QByteArray, QByteArray> QGrpcCallOptions::metadata() &&
[noexcept] const QHash<QByteArray, QByteArray> &QGrpcCallOptions::metadata() const &
特定の RPC のクライアント・メタデータを返します。このフィールドが設定されていない場合は、空のメタデータを返します。
注意: QGrpcHttp2Channel は、メタデータを HTTP/2 ヘッダーとして転送します。キーは大文字小文字を区別しない ASCII 文字列です。: (擬似ヘッダー)、grpc- 、またはqtgrpc- という内部接頭辞の使用は避けなければなりません。値はASCII文字列またはバイナリデータです。詳細はRFC 7540のセクション8.1.2を参照のこと。
QGrpcCallOptions::QGrpcCallOptions()
Default-空の QGrpcCallOptions を構築します。
QGrpcCallOptions::QGrpcCallOptions(const QGrpcCallOptions &other)
other から QGrpcCallOptions をコピー構築する。
[noexcept] QGrpcCallOptions::QGrpcCallOptions(QGrpcCallOptions &&other)
移動-other から新しい QGrpcCallOptions を構築する。
注： 移動元のオブジェクトother は、部分的に形成された状態に置かれ、その中で有効な操作は破壊と新しい値の割り当てのみである。
[noexcept] QGrpcCallOptions::~QGrpcCallOptions()
QGrpcCallOptions を破壊する。
[noexcept] std::optional<std::chrono::milliseconds> QGrpcCallOptions::deadlineTimeout() const
特定の RPC の期限を計算するために使用されるタイムアウト時間を返す。
このフィールドが設定されていない場合は、空のstd::optional を返します。
setDeadlineTimeout()も参照してください 。
QGrpcCallOptions &QGrpcCallOptions::setDeadlineTimeout(std::chrono::milliseconds timeout)
特定の RPC のtimeout を設定し、更新されたオブジェクトへの参照を返す。
デッドラインは、クライアントがサーバーからの応答を待つことができる時間の制限を設定する。実際のデッドラインは、RPCの開始時刻にtimeout を加算して計算されます。
デッドラインは RPC の全ライフタイムに適用される。これには、以前に開始された呼の最終的なQGrpcStatus を受信することも含まれるため、(長寿命の) ストリームでは不要となる可能性がある。
注意: このフィールドを設定すると、特定の RPC に対して QGrpcChannelOptions::setDeadline() によって設定された値がオーバーライドされます。
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-assignother をこのQGrpcCallOptions に割り当て、更新されたオブジェクトへの参照を返す。
注： 移動元のオブジェクトother は、部分的に形成された状態に置かれる。この状態では、有効な操作は破壊と新しい値の割り当てのみである。
QGrpcCallOptions &QGrpcCallOptions::operator=(const QGrpcCallOptions &other)
このQGrpcCallOptions にother を割り当て、更新されたオブジェクトへの参照を返します。
関連する非会員
[since 6.8] QDebug operator<<(QDebug debug, const QGrpcCallOptions &callOpts)
callOpts を指定されたストリームdebug に書き込みます。
この関数は Qt 6.8 で導入されました。
© 2026 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.
