<QGrpcInterceptor> - Interceptor types
<QGrpcInterceptor> ヘッダーファイルには、基本的なインターセプタ型が定義されています。詳細...
| Header: | #include <QGrpcInterceptor> |
| Since: | Qt 6.11 |
型
(since 6.11) flags | InterceptorCapabilities |
(since 6.11) enum class | InterceptorCapability { Start, InitialMetadata, MessageReceived, WriteMessage, WritesDone, …, Cancel } |
詳細な説明
Qt GRPC <QtGrpcInterceptor> ヘッダーファイルに一般的にまとめられているさまざまな型を提供します。
インターセプトの仕組みや、インターセプタインターフェースが RPC のライフサイクルにどのように関与するかについての概要については、「Qt GRPC インターセプタの概要」を参照してください。
Qt GRPC RPCライフサイクルにおけるフックポイントとして、以下のインターセプタインターフェースを提供します:
| インターフェース | フックポイント | 方向 | 変更可能 |
|---|---|---|---|
| QGrpcStartInterceptor | RPCの開始前 | アウトバウンド | 初期メッセージオブジェクト、呼び出しオプション |
| QGrpcWriteMessageInterceptor | 送信メッセージが書き込まれる前 | 送信 | メッセージオブジェクト |
| QGrpcWritesDoneInterceptor | クライアントが書き込み完了を通知したとき | 送信 | — |
| QGrpcCancelInterceptor | RPCがキャンセルされたとき | 送信 | — |
| QGrpcInitialMetadataInterceptor | 初期メタデータを受信したとき | 受信時 | メタデータ |
| QGrpcMessageReceivedInterceptor | メッセージのペイロードを受信したとき | 受信 | シリアライズされたメッセージデータ |
| QGrpcTrailingMetadataInterceptor | 末尾のメタデータを受信したとき | 受信時 | メタデータ |
| QGrpcFinishedInterceptor | RPCが完了したとき | 受信 | 最終ステータス |
インターセプタ機構
以下のクラスおよびページが、Qt GRPC のインターセプタ機構を構成しています:
- QGrpcCancelInterceptor
- QGrpcFinishedInterceptor
- QGrpcInitialMetadataInterceptor
- QGrpcInterceptionContext
- QGrpcInterceptorChain
- QGrpcMessageReceivedInterceptor
- QGrpcStartInterceptor
- QGrpcTrailingMetadataInterceptor
- QGrpcWriteMessageInterceptor
- QGrpcWritesDoneInterceptor
- Qt GRPC Interceptors Overview
- QGrpcStartInterceptor::Continuation
- InterceptorCapability
- InterceptorCapabilities
タイプのドキュメント
[since 6.11] enum class InterceptorCapability
[since 6.11] flags InterceptorCapabilities
インターセプタがサポートするインターセプト・フックポイントを指定します。
Qt GRPC InterceptorCapability の値を使用して、インターセプタが提供するインターセプトフックポイントを記述します。
1つのインターセプタクラスは、複数のインターセプタインターフェース(たとえば、QGrpcStartInterceptor やQGrpcFinishedInterceptor など)を実装することができ、したがって複数の機能に対応することができます。
| 定数 | 値 | 説明 |
|---|---|---|
InterceptorCapability::Start | 0x01 | インターセプタは `QGrpcStartInterceptor` を実装します。 |
InterceptorCapability::InitialMetadata | 0x02 | インターセプタは `QGrpcInitialMetadataInterceptor` を実装しています。インターセプタは ` ` を実装しています。 |
InterceptorCapability::MessageReceived | 0x04 | このインターセプタは、QGrpcMessageReceivedInterceptor を実装しています。このインターセプタは、 を実装しています。 |
InterceptorCapability::WriteMessage | 0x08 | このインターセプタは、QGrpcWriteMessageInterceptor を実装しています。 |
InterceptorCapability::WritesDone | 0x10 | このインターセプタは、QGrpcWritesDoneInterceptor を実装しています。 |
InterceptorCapability::TrailingMetadata | 0x20 | このインターセプタは、QGrpcTrailingMetadataInterceptor を実装しています。 |
InterceptorCapability::Finished | 0x40 | このインターセプタは、QGrpcFinishedInterceptor を実装しています。 |
InterceptorCapability::Cancel | 0x80 | このインターセプターは `QGrpcCancelInterceptor` を実装しています。 |
この列挙型は Qt 6.11 で導入されました。
InterceptorCapabilities 型は、QFlags<InterceptorCapability> の typedef です。これは、InterceptorCapability 値の OR 組み合わせを格納します。
© 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.