QGrpcOperation Class

メンバ関数のドキュメント

[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の結果に関する追加情報を提供します。

このシグナルを受信した後は、操作オブジェクトに対してそれ以上の書き込みや読み取り操作を行ってはなりません。この時点で、RPCオブジェクトを再利用したり破棄したりしても安全です。

[noexcept] bool QGrpcOperation::isFinished() const

この操作が完了した場合（つまり、対応するRPCに対してこれ以上の操作が行われなくなった場合）、trueを返します。それ以外の場合はfalseを返します。

[noexcept, until 6.13] const QHash<QByteArray, QByteArray> &QGrpcOperation::metadata() const &

この関数は、バージョン 6.13 で非推奨となる予定です。

代わりに、serverInitialMetadata() およびserverTrailingMetadata() を使用してください。

レスポンスメッセージが送信される前に、サーバーから受信した初期メタデータを返します。

初期メタデータは、呼び出しが確立された直後にサーバーから送信されます。これには、呼び出しのコンテキストを提供するキーと値のペアが含まれる場合があります。

serverInitialMetadata() およびserverTrailingMetadata()も参照してください 。

[noexcept] QLatin1StringView QGrpcOperation::method() const

この RPC 操作に関連付けられたメソッド名を返します。

template <typename T> requires QtProtobuf::if_protobuf_message<T> std::optional<T> QGrpcOperation::read() const

この操作オブジェクト内に格納されている生のバイト配列からメッセージを読み取ります。

デシリアライズされたメッセージ（オプション）を返します。失敗した場合は、std::nullopt が返されます。

関連項目: ` read(QProtobufMessage *)`。

[since 6.8] bool QGrpcOperation::read(QProtobufMessage *message) const

この操作オブジェクト内に格納されている生のバイト配列からメッセージを読み取ります。

この関数は、デシリアライズされた値をmessage ポインタに書き込みます。

デシリアライズに成功した場合、この関数はtrue を返します。そうでない場合は、false を返します。

この関数は Qt 6.8 で導入されました。

read()も参照してください 。

QMetaType QGrpcOperation::responseMetaType() const

RPC応答メッセージのメタタイプを返します。

[noexcept, since 6.10] const QMultiHash<QByteArray, QByteArray> &QGrpcOperation::serverInitialMetadata() const &

レスポンスメッセージが送信される前に、サーバーから受信した初期メタデータを返します。

初期メタデータは、接続が確立された直後にサーバーから送信されます。これには、呼び出しのコンテキストを提供するキーと値のペアが含まれる場合があります。

メタデータには、同じキーの下に複数のエントリを含めることができます。

この関数は Qt 6.10 で導入されました。

serverInitialMetadataReceived() およびserverTrailingMetadata()も参照してください 。

[signal, since 6.11] void QGrpcOperation::serverInitialMetadataReceived(const QMultiHash<QByteArray, QByteArray> &metadata)

このシグナルは、サーバーが初期メタデータを含む応答を返した際に発生します。サーバーからの初期メタデータは、RPCの初期応答の前にクライアントに送信されます。

受信したメタデータは `metadata ` に格納されており、`serverInitialMetadata()` を通じて取得することも可能です。

この関数は Qt 6.11 で導入されました。

serverInitialMetadata()も参照してください 。

[noexcept, since 6.10] const QMultiHash<QByteArray, QByteArray> &QGrpcOperation::serverTrailingMetadata() const &

すべての応答メッセージの後に、サーバーから受信した末尾のメタデータを返します。

末尾のメタデータは、すべての応答メッセージの送信が完了し、RPCが終了する直前に、サーバーから一度だけ送信されます。これには、完了した呼び出しに関する追加のコンテキストを提供するキーと値のペアが含まれる場合があります。

メタデータには、同一のキーの下に複数のエントリを含めることができます。

この関数は Qt 6.10 で導入されました。

serverInitialMetadata()も参照してください 。