Qt GRPC Interceptors
For an introduction to the interception mechanism and how interceptor interfaces participate in the lifecycle of an RPC, see the Qt GRPC Interceptors Overview.
Qt GRPC provides the following interceptor interfaces as hook points in the RPC lifecycle:
| Interface | Hook Point | Direction | Can Modify |
|---|---|---|---|
| QGrpcStartInterceptor | Before the RPC is initiated | Outbound | Initial message object, call options |
| QGrpcWriteMessageInterceptor | Before an outgoing message is written | Outbound | Message object |
| QGrpcWritesDoneInterceptor | When the client indicates writes are done | Outbound | — |
| QGrpcCancelInterceptor | When the RPC is cancelled | Outbound | — |
| QGrpcInitialMetadataInterceptor | When initial metadata is received | Inbound | Metadata |
| QGrpcMessageReceivedInterceptor | When a message payload is received | Inbound | Serialized message data |
| QGrpcTrailingMetadataInterceptor | When trailing metadata is received | Inbound | Metadata |
| QGrpcFinishedInterceptor | When the RPC completes | Inbound | Final status |
The following classes and pages form the Qt GRPC interceptor mechanism:
Intercepts cancellation requests for an RPC | |
Intercepts the completion status of an RPC | |
Intercepts initial metadata for an RPC | |
Provides contextual information to interceptor callbacks | |
Stores and manages a sequence of interceptors | |
Intercepts incoming message payloads for an RPC | |
Intercepts the start of an RPC | |
Intercepts trailing metadata for an RPC | |
Intercepts outgoing messages written for an RPC | |
Intercepts the completion of message writes for an RPC | |
Provides an overview of the Qt GRPC interceptor mechanism. | |
Controls whether an intercepted RPC should proceed | |
Specifies interception hook points supported by an interceptor | |
A QFlags type that stores a combination of InterceptorCapability values |
© 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.
