QtGrpc Namespace
Der Namespace „QtGrpc“ enthält verschiedene Bezeichner, die in der gesamten QtGrpc-Bibliothek verwendet werden. Mehr...
| Header: | #include <QtGrpcNamespace> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Grpc) target_link_libraries(mytarget PRIVATE Qt6::Grpc) |
| Seit: | Qt 6.5 |
Klassen
(since 6.10) struct | MultiValue_t |
(since 6.11) struct | RpcDescriptor |
Typen
(since 6.12) enum class | CompressionAlgorithm { Identity, Deflate, Gzip } |
| flags | CompressionAlgorithms |
(since 6.11) flags | InterceptorCapabilities |
(since 6.11) enum class | InterceptorCapability { Start, InitialMetadata, MessageReceived, WriteMessage, WritesDone, …, Cancel } |
(since 6.11) enum class | RpcType { UnaryCall, ServerStreaming, ClientStreaming, BidiStreaming } |
| enum class | SerializationFormat { Default, Protobuf, Json } |
| enum class | StatusCode { Ok, Cancelled, InvalidArgument, DeadlineExceeded, NotFound, …, Unauthenticated } |
Variablen
(since 6.10) const struct QtGrpc::MultiValue_t | MultiValue |
Klassen
Klasse MultiValue_t
Tag-Typ für den Zugriff auf „ QMultiHash “-Metadaten. Mehr...
Klasse RpcDescriptor
Beschreibt eine gRPC-Methode mit ihrem Servicenamen, Methodennamen und RPC-Typ. Mehr...
Typdokumentation
[since 6.12] enum class QtGrpc::CompressionAlgorithm
flags QtGrpc::CompressionAlgorithms
Listet die für gRPC-Nachrichten unterstützten Komprimierungsalgorithmen auf.
Der „ HTTP/2 channel “ gibt die ausgewählten Algorithmen im Request-Header „ grpc-accept-encoding “ an und versendet ausgehende Nachrichten, die mit dem über „ setRequestCompression()“ ausgewählten Algorithmus komprimiert sind.
| Konstante | Wert | Beschreibung |
|---|---|---|
QtGrpc::CompressionAlgorithm::Identity | 0x01 | Keine Komprimierung. Immer in der akzeptierten Menge enthalten, da die gRPC-Spezifikation vorschreibt, dass unkomprimierte Nachrichten akzeptiert werden müssen. |
QtGrpc::CompressionAlgorithm::Deflate | 0x02 | Der Komprimierungsalgorithmus von „ deflate “. |
QtGrpc::CompressionAlgorithm::Gzip | 0x04 | Der Komprimierungsalgorithmus „ gzip “. |
Diese Aufzählung wurde in Qt 6.12 eingeführt.
Der Typ „CompressionAlgorithms“ ist ein typedef für „QFlags<CompressionAlgorithm>“. Er speichert eine OR-Kombination von „CompressionAlgorithm“-Werten.
Siehe auch „ QGrpcChannelOptions::setAcceptedCompressionAlgorithms()“, „ QGrpcChannelOptions::supportedCompressionAlgorithms()“, „ QGrpcChannelOptions::setRequestCompression()“ und „ QGrpcCallOptions::setRequestCompression()“.
[since 6.11] enum class InterceptorCapability
[since 6.11] flags InterceptorCapabilities
Gibt die von einem Interceptor unterstützten Interception-Hook-Punkte an.
Qt GRPC Verwendet „InterceptorCapability“-Werte, um zu beschreiben, welche Interception-Hook-Punkte ein Interceptor bereitstellt.
Eine einzelne Interceptor-Klasse kann mehrere Interceptor-Schnittstellen implementieren (z. B. „ QGrpcStartInterceptor “ und „ QGrpcFinishedInterceptor “) und somit mehrere Fähigkeiten unterstützen.
| Konstante | Wert | Beschreibung |
|---|---|---|
InterceptorCapability::Start | 0x01 | Der Interceptor implementiert „ QGrpcStartInterceptor “. |
InterceptorCapability::InitialMetadata | 0x02 | Der Interceptor implementiert „ QGrpcInitialMetadataInterceptor “. |
InterceptorCapability::MessageReceived | 0x04 | Der Interceptor implementiert „ QGrpcMessageReceivedInterceptor “. |
InterceptorCapability::WriteMessage | 0x08 | Der Interceptor implementiert „ QGrpcWriteMessageInterceptor “. |
InterceptorCapability::WritesDone | 0x10 | Der Interceptor implementiert „ QGrpcWritesDoneInterceptor “. |
InterceptorCapability::TrailingMetadata | 0x20 | Der Interceptor implementiert „ QGrpcTrailingMetadataInterceptor “. |
InterceptorCapability::Finished | 0x40 | Der Interceptor implementiert „ QGrpcFinishedInterceptor “. |
InterceptorCapability::Cancel | 0x80 | Der Interceptor implementiert „ QGrpcCancelInterceptor “. |
Diese Enumeration wurde in Qt 6.11 eingeführt.
Der Typ `InterceptorCapabilities` ist ein `typedef` für ` QFlags<InterceptorCapability>`. Er speichert eine OR-Kombination von `InterceptorCapability`-Werten.
[since 6.11] enum class QtGrpc::RpcType
Beschreibt den Typ des RPC (Remote Procedure Call).
Diese Enumeration gibt das von einer gRPC-Methode verwendete Kommunikationsmuster an.
| Konstante | Wert | Beschreibung |
|---|---|---|
QtGrpc::RpcType::UnaryCall | 0 | verwendet den Handler „ QGrpcCallReply “. |
QtGrpc::RpcType::ServerStreaming | 1 | Verwendet den Handler „ QGrpcServerStream “. |
QtGrpc::RpcType::ClientStreaming | 2 | verwendet den Handler „ QGrpcClientStream “. |
QtGrpc::RpcType::BidiStreaming | 3 | verwendet den Handler „ QGrpcBidiStream “. |
Diese Enumeration wurde in Qt 6.11 eingeführt.
Siehe auch „ QtGrpc::RpcDescriptor “.
enum class QtGrpc::SerializationFormat
Enthält voreingestellte Werte zur Konfiguration des Protobuf-Serialisierformats.
| Konstante | Wert | Beschreibung |
|---|---|---|
QtGrpc::SerializationFormat::Default | 0 | Die Standardvoreinstellung für den „ QGrpcSerializationFormat “. Diese Voreinstellung erstellt eine „ QProtobufSerializer “ mit einem leeren Inhaltstyp-Suffix. |
QtGrpc::SerializationFormat::Protobuf | 1 | Die Voreinstellung „embedded protobuf“ für „ QGrpcSerializationFormat “. Diese Voreinstellung erstellt einen „ QProtobufSerializer “ mit dem Content-Type-Suffix „ proto “. |
QtGrpc::SerializationFormat::Json | 2 | Die Voreinstellung „ QGrpcSerializationFormat “ für eingebettetes JSON. Diese Voreinstellung erstellt ein ` QProtobufJsonSerializer ` mit dem Content-Type-Suffix ` json `. |
Siehe auch „ QGrpcSerializationFormat “.
enum class QtGrpc::StatusCode
Statuscodes des Kanals.
| Konstante | Wert | Beschreibung |
|---|---|---|
QtGrpc::StatusCode::Ok | 0 | Kein Fehler |
QtGrpc::StatusCode::Cancelled | 1 | Der Vorgang wurde abgebrochen, in der Regel durch den Aufrufer. |
QtGrpc::StatusCode::InvalidArgument | 3 | Der Client hat ein ungültiges Argument angegeben, |
QtGrpc::StatusCode::DeadlineExceeded | 4 | Die Frist ist abgelaufen, bevor der Vorgang abgeschlossen werden konnte, |
QtGrpc::StatusCode::NotFound | 5 | Eine angeforderte Entität (z. B. eine Datei oder ein Verzeichnis) wurde nicht gefunden. |
QtGrpc::StatusCode::AlreadyExists | 6 | Die Entität, die ein Client zu erstellen versuchte (z. B. eine Datei oder ein Verzeichnis), existiert bereits. |
QtGrpc::StatusCode::PermissionDenied | 7 | Der Aufrufer verfügt nicht über die Berechtigung, den angegebenen Vorgang auszuführen. „ PermissionDenied “ darf nicht für Ablehnungen verwendet werden, die durch die Erschöpfung einer Ressource verursacht wurden (verwenden Sie stattdessen „ ResourceExhausted “ für diese Fehler). „ PermissionDenied “ darf nicht verwendet werden, wenn der Aufrufer nicht identifiziert werden kann (verwenden Sie stattdessen „ Unauthenticated “ für diese Fehler). Dieser Fehlercode bedeutet nicht, dass die Anfrage gültig ist oder dass die angeforderte Entität existiert oder andere Voraussetzungen erfüllt. |
QtGrpc::StatusCode::ResourceExhausted | 8 | Eine Ressource ist erschöpft, möglicherweise ein benutzerspezifisches Kontingent, oder es ist im gesamten Dateisystem kein Speicherplatz mehr verfügbar. |
QtGrpc::StatusCode::FailedPrecondition | 9 | Der Vorgang wurde abgelehnt, da sich das System nicht in einem für die Ausführung des Vorgangs erforderlichen Zustand befindet. |
QtGrpc::StatusCode::Aborted | 10 | Der Vorgang wurde abgebrochen, typischerweise aufgrund eines Parallelitätsproblems wie eines Fehlers bei der Sequenzerprüfung oder eines Transaktionsabbruchs. |
QtGrpc::StatusCode::OutOfRange | 11 | Der Vorgang wurde außerhalb des gültigen Bereichs versucht. |
QtGrpc::StatusCode::Unimplemented | 12 | Der Vorgang ist nicht implementiert oder wird in diesem Dienst nicht unterstützt bzw. ist nicht aktiviert. |
QtGrpc::StatusCode::Internal | 13 | Dies bedeutet, dass einige vom zugrunde liegenden System erwartete Invarianten verletzt wurden. |
QtGrpc::StatusCode::Unavailable | 14 | Der Dienst ist derzeit nicht verfügbar. Dies ist höchstwahrscheinlich ein vorübergehender Zustand, der durch einen erneuten Versuch mit einer Wartezeit behoben werden kann. Beachten Sie, dass es nicht immer sicher ist, nicht-idempotente Vorgänge erneut auszuführen. |
QtGrpc::StatusCode::DataLoss | 15 | Unwiederbringlicher Datenverlust oder Datenbeschädigung. |
QtGrpc::StatusCode::Unauthenticated | 16 | Die Anfrage enthält keine gültigen Authentifizierungsdaten für die Operation. |
Siehe auch gRPC-Statuscodes.
Variable Dokumentation
[since 6.10] const struct QtGrpc::MultiValue_t QtGrpc::MultiValue
Tag, das für den Zugriff auf Metadaten unter QMultiHash verwendet wird.
Diese Variable wurde in Qt 6.10 eingeführt.
Siehe auch „ QGrpcChannelOptions::metadata“ (QtGrpc::MultiValue_t) und „ QGrpcCallOptions::metadata “ (QtGrpc::MultiValue_t).
© 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.
