QGrpcInterceptorChain Class

Dokumentation der Mitgliedsfunktionen

QGrpcInterceptorChain::QGrpcInterceptorChain()

Erstellt eine leere Interceptor-Kette.

[delete] QGrpcInterceptorChain::QGrpcInterceptorChain(const QGrpcInterceptorChain &)

Erstellt eine Instanz von ` QGrpcInterceptorChain` durch Kopieren. Diese Funktion wurde gelöscht.

[noexcept] QGrpcInterceptorChain::~QGrpcInterceptorChain()

Zerstört die Abfangkette.

template <typename T> requires QtGrpcPrivate::if_interceptor<T> bool QGrpcInterceptorChain::add(T *interceptor)

Fügt „ interceptor “ zur Kette hinzu, ohne die Eigentumsrechte zu übernehmen.

Gibt „ true “ zurück, wenn der Interceptor hinzugefügt wurde; andernfalls wird „ false “ zurückgegeben.

Beim Festlegen von Interceptoren über einen Rohzeiger behält der Aufrufer die Eigentumsrechte. Die ` QGrpcInterceptorChain ` speichert Referenzen ohne Eigentumsrechte auf die bereitgestellten Interceptoren.

Die Interceptor-Kette wird an den Kanal übertragen und geht in dessen Besitz über. Daher müssen alle Interceptor-Objekte während der gesamten Lebensdauer des Kanals, der die Kette verwendet, gültig bleiben.

Der folgende Code zeigt, wie ein benutzerdefinierter Deleter verwendet wird, um die Lebensdauer eines Interceptors an einen einzelnen Kanal zu binden:

auto *metricsInterceptor = new MetricsInterceptor();
auto *authInterceptor = new AuthInterceptor();
~~~
QGrpcInterceptorChain chain;
if (!chain.add(metricsInterceptor))
    qFatal("Failed to add metrics interceptor");
if (!chain.add(authInterceptor))
    qFatal("Failed to add auth interceptor");

auto channel = std::shared_ptr<QGrpcHttp2Channel>(
    new QGrpcHttp2Channel(QUrl("you_uri:port"), std::move(chain)),
    [&metricsInterceptor, &authInterceptor](QGrpcHttp2Channel* ptr) {
        delete ptr;
        qDebug() << "Channel destroyed.";
       // Wenn diese Interceptors nicht von anderen Kanälen gemeinsam genutzt werden,
        // ist dies der geeignete Ort, um sie zu löschen. Andernfalls  muss  ihre
        // Lebensdauer extern verwaltet werden.
       delete metricsInterceptor;
        delete authInterceptor;
        metricsInterceptor = nullptr;
        authInterceptor = nullptr;
    }
);

Jeder Interceptor-Typ muss mindestens eine Interceptor-Schnittstelle (z. B. ` QGrpcStartInterceptor ` oder ` QGrpcFinishedInterceptor`) implementieren, um Interceptor-Funktionen bereitzustellen.

Siehe auch set() und clear().

template <typename T> requires QtGrpcPrivate::if_interceptor<T> bool QGrpcInterceptorChain::add(std::unique_ptr<T> &&interceptor)

Fügt interceptor zur Kette hinzu und übernimmt die Verantwortung dafür.

Gibt „ true “ zurück, wenn der Interceptor hinzugefügt wurde; andernfalls wird „ false “ zurückgegeben.

Die Eigentumsrechte an ` interceptor ` werden nur dann an die Kette übertragen, wenn der Interceptor erfolgreich hinzugefügt wurde. Wenn die Funktion ` false` zurückgibt, verbleiben die Eigentumsrechte beim Aufrufer.

Jeder Interceptor-Typ muss mindestens eine Interceptor-Schnittstelle (z. B. ` QGrpcStartInterceptor ` oder ` QGrpcFinishedInterceptor`) implementieren, um Interception-Funktionen bereitzustellen.

Siehe auch ` set()` und ` clear()`.

[noexcept] QtGrpc::InterceptorCapabilities QGrpcInterceptorChain::capabilities() const

Gibt die kombinierten Funktionen aller in der Kette gespeicherten Interceptoren zurück.

Der Rückgabewert ist das bitweise ODER der von den Interceptoren bereitgestellten Funktionen.

Siehe auch hasHandlerFor(), capabilitiesAt() und QtGrpc::InterceptorCapability.

QtGrpc::InterceptorCapabilities QGrpcInterceptorChain::capabilitiesAt(qsizetype index) const

Gibt die vom Interceptor bereitgestellten Funktionen unter index zurück.

Siehe auch ` capabilities()` und ` size()`.

void QGrpcInterceptorChain::clear()

Löscht die Kette.

Entfernt alle Interceptoren aus der Kette. Alle Interceptoren, die zur Kette gehören, werden zerstört.

Siehe auch add() und set().

[noexcept] bool QGrpcInterceptorChain::empty() const

Gibt „ true “ zurück, wenn die Kette keine Interceptoren enthält; andernfalls wird „ false “ zurückgegeben.

Siehe auch size() und isEmpty().

[noexcept] bool QGrpcInterceptorChain::hasHandlerFor(QtGrpc::InterceptorCapability cap) const

Gibt „ true “ zurück, wenn die Kette mindestens einen Interceptor enthält, der einen Handler für die Fähigkeit „ cap “ bereitstellt; andernfalls wird „ false “ zurückgegeben.

Siehe auch capabilities() und capabilitiesAt().

[noexcept] bool QGrpcInterceptorChain::isEmpty() const

Gibt „ true “ zurück, wenn die Kette keine Interceptoren enthält; andernfalls wird „ false “ zurückgegeben.

Siehe auch size() und empty().

template <typename... Ts> requires QtGrpcPrivate::if_interceptor<Ts...> bool QGrpcInterceptorChain::set(Ts *... interceptors)

Ersetzt den Inhalt der Kette durch „ interceptors “, ohne die Eigentumsrechte daran zu übernehmen.

Gibt „ true “ zurück, wenn alle Interceptoren erfolgreich hinzugefügt wurden; andernfalls wird „ false “ zurückgegeben und die Kette bleibt unverändert.

Beim Setzen von Interceptoren über einen Rohzeiger behält der Aufrufer das Eigentumsrecht. Die ` QGrpcInterceptorChain ` speichert Referenzen ohne Eigentumsrecht auf die bereitgestellten Interceptoren.

Die Interceptor-Kette wird an den Kanal übertragen und geht in dessen Besitz über. Daher müssen alle Interceptor-Objekte während der gesamten Lebensdauer des Kanals, der die Kette verwendet, gültig bleiben.

Der folgende Code zeigt, wie man einen benutzerdefinierten Deleter verwendet, um die Lebensdauer eines Interceptors an einen einzelnen Kanal zu binden:

auto *metricsInterceptor = new MetricsInterceptor();
auto *authInterceptor = new AuthInterceptor();
~~~
QGrpcInterceptorChain chain;
if (!chain.set(metricsInterceptor, authInterceptor))
    qFatal("Failed to set interceptors to chain");

auto channel = std::shared_ptr<QGrpcHttp2Channel>(
    new QGrpcHttp2Channel(QUrl("you_uri:port"), std::move(chain)),
    [&metricsInterceptor, &authInterceptor](QGrpcHttp2Channel* ptr) {
        delete ptr;
        qDebug() << "Channel destroyed.";
       // Wenn diese Interceptoren nicht von anderen Kanälen gemeinsam genutzt werden,
        // ist dies der geeignete Ort, um sie zu löschen. Andernfalls  muss  ihre
        // Lebensdauer extern verwaltet werden.
       delete metricsInterceptor;
        delete authInterceptor;
        metricsInterceptor = nullptr;
        authInterceptor = nullptr;
    }
);

Jeder Interceptor-Typ muss mindestens eine Interceptor-Schnittstelle (z. B. ` QGrpcStartInterceptor ` oder ` QGrpcFinishedInterceptor`) implementieren, um Interception-Funktionen bereitzustellen.

Siehe auch „ add()“ und „ clear()“.

template <typename... Ts> requires QtGrpcPrivate::if_interceptor<Ts...> bool QGrpcInterceptorChain::set(std::unique_ptr<Ts> &&... interceptors)

Ersetzt den Inhalt der Kette durch interceptors und übernimmt die Eigentumsrechte daran.

Gibt „ true “ zurück, wenn alle Interceptoren erfolgreich hinzugefügt wurden; andernfalls wird „ false “ zurückgegeben und die Kette bleibt unverändert.

Interceptoren werden in der Reihenfolge verarbeitet, in der sie an diese Funktion übergeben werden. Wenn alle Hinzufügungen erfolgreich sind, wird die Kette durch die neuen Interceptoren in dieser Reihenfolge ersetzt.

Die Eigentumsübertragung erfolgt schrittweise, während die Interceptoren verarbeitet werden. Wenn der Vorgang fehlschlägt, werden alle Interceptoren, die vor dem Fehler erfolgreich hinzugefügt wurden, zerstört, während die verbleibenden (noch nicht verarbeiteten) `unique_ptrs` gültig bleiben.

Jeder Interceptor-Typ muss mindestens eine Interceptor-Schnittstelle (z. B. ` QGrpcStartInterceptor ` oder ` QGrpcFinishedInterceptor`) implementieren, um Interception-Funktionen bereitzustellen.

Siehe auch ` add()` und ` clear()`.

[noexcept] qsizetype QGrpcInterceptorChain::size() const

Gibt die Anzahl der in der Kette gespeicherten Interceptoren zurück.

Siehe auch ` isEmpty()`.

[noexcept] void QGrpcInterceptorChain::swap(QGrpcInterceptorChain &other)

Tauscht „ other “ gegen dieses Objekt aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

[delete] QGrpcInterceptorChain &QGrpcInterceptorChain::operator=(const QGrpcInterceptorChain &)

Weist dieser „ QGrpcInterceptorChain “-Instanz „ other “ per Kopierzuweisung zu. Diese Funktion wird gelöscht.