QGrpcOperation Class
QGrpcOperationクラスは、クライアント側からの通信を処理するための共通オペレーションを提供する。 gRPC™を提供します。詳細...
| ヘッダー | #include <QGrpcOperation> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Grpc)target_link_libraries(mytarget PRIVATE Qt6::Grpc) |
| 以来： | Qt 6.5 |
| 継承 | QObject |
| によって継承されています： | QGrpcBidiStream,QGrpcCallReply,QGrpcClientStream, およびQGrpcServerStream |
パブリック関数
| virtual | ~QGrpcOperation() override |
| bool | isFinished() const |
| const QHash<QByteArray, QByteArray> & | metadata() const & |
| QLatin1StringView | method() const |
| std::optional<T> | read() const |
(since 6.8) bool | read(QProtobufMessage *message) const |
パブリックスロット
| void | cancel() |
シグナル
| void | finished(const QGrpcStatus &status) |
詳細説明
QGrpcOperationは、次の4つのメソッドの基本クラスとして機能します。 gRPC™QGrpcCallReply （単方向呼び出し）、QGrpcServerStream （サーバー・ストリーミング）、QGrpcClientStream （クライアント・ストリーミング）、QGrpcBidiStream （双方向ストリーミング）。QGrpcOperationは、これらのリモート・プロシージャ・コール（RPC）と相互作用するための共通インタフェースを提供します。
各QGrpcOperationは、生成されたクライアント・インターフェースを通じて要求された特定のRPCに対応する。
高レベルの概要については、Qt GRPC クライアント・ガイドを参照してください。
メンバ関数ドキュメント
[override virtual noexcept] QGrpcOperation::~QGrpcOperation()
QGrpcOperation を破壊する。
[slot] void QGrpcOperation::cancel()
RPCを直ちにキャンセルしようとする。キャンセルの成功は保証できない。Cancelled ステータスコードとともにfinished シグナルを発する。
QGrpcOperationContext::cancelRequestedも参照のこと 。
[signal] void QGrpcOperation::finished(const QGrpcStatus &status)
このシグナルは、以前に開始された RPC が終了したときに発行される。status は、RPC の結果に関する追加情報を提供する。
このシグナルを受信した後は、operation オブジェ クトに対してそれ以上書き込みや読み出しの操作を行 わないでください。この時点で、RPC オブジェクトを再利用または破棄しても安全です。
注意： このシグナルは一度だけ発信されるため、ほとんどの場合、シグナル受信後にラムダ・キャプチャが破棄されないなどの問題を避けるために、受信後すぐに切断することをお勧めします。これを実現する簡単な方法は、SingleShotConnection 接続タイプを使用することです。詳細はSingle Shot RPCsを参照。
[noexcept] bool QGrpcOperation::isFinished() const
この操作が終了した場合、つまり対応する RPC に対してこれ以上操作ができない場合は true を返し、そうでない場合は false を返します。
[noexcept] const QHash<QByteArray, QByteArray> &QGrpcOperation::metadata() const &
チャネルから受け取ったサーバのメタデータを返します。
注意: HTTP/2 channels の場合、通常はサーバから受け取った HTTP ヘッダが含まれます。
[noexcept] QLatin1StringView QGrpcOperation::method() const
この RPC 操作に関連付けられたメソッド名を返します。
template <typename T, QtProtobuf::if_protobuf_message<T> = true> std::optional<T> QGrpcOperation::read() const
この操作オブジェクト内に格納されている生のバイト配列からメッセージを読み取ります。
オプションで、デシリアライズされたメッセージを返します。失敗すると、std::nullopt が返されます。
注意： この関数は、T がQProtobufMessage のサブクラスである場合にのみ、オーバーロード解決に参加します。
read(QProtobufMessage *)も参照してください 。
[since 6.8] bool QGrpcOperation::read(QProtobufMessage *message) const
この操作オブジェクト内に格納されている生のバイト配列からメッセージを読み込みます。
この関数は、デシリアライズされた値をmessage ポインタに書き込みます。
デシリアライズに成功した場合、この関数はtrue を返します。そうでない場合は、false を返します。
この関数は Qt 6.8 で導入されました。
read()も参照してください 。
© 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.
