QGrpcOperationContext Class

Dokumentation der Mitgliedsfunktionen

[override virtual noexcept] QGrpcOperationContext::~QGrpcOperationContext()

Löscht den Operationskontext.

[noexcept] const QGrpcCallOptions &QGrpcOperationContext::callOptions() const &

Gibt die Call-Optionen zurück, die von diesem Operationskontext verwendet werden.

Informationen zu kanalweiten Optionen finden Sie unter QGrpcChannelOptions.

[signal] void QGrpcOperationContext::cancelRequested()

Dieses Signal wird von „ QGrpcOperation “ gesendet, wenn die Abbruch der Kommunikation angefordert wird.

Es wird erwartet, dass der Kanal seine Abbruchlogik an dieses Signal anschließt und versucht, den RPC abzubrechen und ihn mit einem Cancelled -Statuscode abzuschließen. Ein erfolgreicher Abbruch kann nicht garantiert werden. Eine weitere Verarbeitung der von einem Kanal empfangenen Daten ist nicht erforderlich und sollte vermieden werden.

Siehe auch QGrpcOperation::cancel.

[noexcept, since 6.11] QtGrpc::RpcDescriptor QGrpcOperationContext::descriptor() const

Gibt den „ QtGrpc::RpcDescriptor “ für diesen Operationskontext zurück.

Diese Funktion wurde in Qt 6.11 eingeführt.

[signal] void QGrpcOperationContext::finished(const QGrpcStatus &status)

Dieses Signal sollte vom Kanal ausgesendet werden, wenn ein RPC-Aufruf beendet ist.

Dies bedeutet in der Regel, dass der Server einen „ status “ für den angeforderten RPC gesendet und die Verbindung geschlossen hat. Implementierungen von ` QAbstractGrpcChannel ` sollten diese Situation erkennen und das Signal ausgeben.

Nach dem Empfang dieses Signals sollte über diesen Operationskontext keine weitere Kommunikation mehr stattfinden. Die Client-Seite kann dann das entsprechende RPC-Objekt sicher löschen.

Siehe auch „ QGrpcOperation::finished “.

[signal] void QGrpcOperationContext::messageReceived(const QByteArray &data)

Dieses Signal sollte vom Kanal ausgesendet werden, wenn ein neuer Datenblock von data vom Server empfangen wird.

Bei Client-Streams und unären Aufrufen bedeutet dies, dass die einzige und letzte Antwort eingegangen ist und die Kommunikation kurz vor dem Abschluss steht.

Bei Server- und bidirektionalen Streams sollte dieses Signal vom Kanal bei jedem Empfang einer neuen Nachricht kontinuierlich ausgesendet werden.

Siehe auch „ QGrpcServerStream::messageReceived “ und „ QGrpcBidiStream::messageReceived “.

[noexcept] QLatin1StringView QGrpcOperationContext::method() const

Gibt den Methodennamen des Dienstes zurück, der diesem Operationskontext zugeordnet ist.

[noexcept, since 6.11] quint64 QGrpcOperationContext::operationId() const

Gibt die eindeutige Kennung für diesen Operationskontext zurück.

Jede ID ist über alle Kanäle hinweg während der gesamten Lebensdauer der Anwendung eindeutig.

Diese Funktion wurde in Qt 6.11 eingeführt.

QMetaType QGrpcOperationContext::responseMetaType() const

Gibt den Metatyp der RPC-Ergebnismeldung zurück.

Siehe auch „ setResponseMetaType()“.

std::shared_ptr<const QAbstractProtobufSerializer> QGrpcOperationContext::serializer() const

Gibt den Serializer dieses Operationskontexts zurück

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

Gibt die vom Server vor dem Empfang von Antwortnachrichten empfangenen anfänglichen Metadaten zurück.

Die anfänglichen Metadaten werden vom Server unmittelbar nach dem Aufbau der Verbindung gesendet. Sie können Schlüssel-Wert-Paare enthalten, die Kontextinformationen für die Verbindung liefern.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch setServerInitialMetadata(), QGrpcOperation::serverInitialMetadata() und serverTrailingMetadata().

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

Dieses Signal wird ausgesendet, wenn der Server seine anfänglichen Metadaten übermittelt. Die anfänglichen Metadaten des Servers werden vor der ersten Antwort eines RPC an den Client gesendet.

Die empfangenen Metadaten werden in „ metadata “ bereitgestellt und sind auch über „ serverInitialMetadata “ () verfügbar.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch QGrpcOperation::serverInitialMetadataReceived und QGrpcBidiStream::writesDone.

[noexcept, until 6.13] const QHash<QByteArray, QByteArray> &QGrpcOperationContext::serverMetadata() const &

Diese Funktion wird in Version 6.13 als veraltet markiert.

Verwenden Sie stattdessen „ serverInitialMetadata()“ und „ serverTrailingMetadata()“.

Gibt die vom Server vor dem Empfang von Antwortnachrichten empfangenen anfänglichen Metadaten zurück.

Die anfänglichen Metadaten werden vom Server unmittelbar nach dem Aufbau der Verbindung gesendet. Sie können Schlüssel-Wert-Paare enthalten, die Kontextinformationen für die Verbindung liefern.

Siehe auch setServerMetadata(), serverInitialMetadata() und QGrpcOperation::serverInitialMetadata().

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

Gibt die vom Server nach allen Antwortnachrichten empfangenen abschließenden Metadaten zurück.

Abschließende Metadaten werden vom Server erst gesendet, nachdem alle Antwortnachrichten übermittelt wurden und unmittelbar bevor der RPC-Aufruf abgeschlossen wird. Sie können Schlüssel-Wert-Paare enthalten, die zusätzlichen Kontext zum abgeschlossenen Aufruf liefern.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch QGrpcOperation::serverTrailingMetadata() und setServerTrailingMetadata().

[noexcept] QLatin1StringView QGrpcOperationContext::service() const

Gibt den Namen des Dienstes zurück, der diesem Operationskontext zugeordnet ist.

void QGrpcOperationContext::setResponseMetaType(QMetaType metaType)

Speichert den „ metaType “ der RPC-Ergebnismeldung.

Siehe auch ` responseMetaType()`.

[since 6.10] void QGrpcOperationContext::setServerInitialMetadata(QMultiHash<QByteArray, QByteArray> &&metadata)

Legt den vom Server zu Beginn des RPC empfangenen „ metadata “ fest.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch ` serverInitialMetadata()`.

Diese Funktion soll in Version 6.13 als veraltet markiert werden.

Verwenden Sie stattdessen ` setServerInitialMetadata()`.

Legt die Metadaten fest, die zu Beginn des RPC vom Server empfangen wurden.

Siehe auch ` setServerInitialMetadata()`.

[since 6.10] void QGrpcOperationContext::setServerTrailingMetadata(QMultiHash<QByteArray, QByteArray> &&metadata)

Setzt das vom Server empfangene Nachhängungs metadata nach allen Antwortnachrichten.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch ` serverTrailingMetadata()`.

[signal] void QGrpcOperationContext::writeMessageRequested(const QByteArray &data)

Dieses Signal wird von QGrpcClientStream oder QGrpcBidiStream ausgesendet, wenn die serialisierten Daten data bereitstehen und über einen Kanal übertragen werden sollen.

Es wird erwartet, dass der Kanal seine Schreiblogik an dieses Signal anbindet und die serialisierten Daten in kanalbezogene Header einbettet, bevor er sie in das Netzwerk schreibt.

Siehe auch QGrpcClientStream::writeMessage und QGrpcBidiStream::writeMessage.

[signal] void QGrpcOperationContext::writesDoneRequested()

Dieses Signal wird von ` QGrpcClientStream ` oder ` QGrpcBidiStream ` ausgegeben, um anzuzeigen, dass das Schreiben von Nachrichten abgeschlossen ist. Der Kanal sollte darauf reagieren, indem er den Stream halb schließt.

Siehe auch ` QGrpcClientStream::writesDone ` und ` QGrpcBidiStream::writesDone`.