QHttpServerRouterRule Class

Dokumentation zu Mitgliedsfunktionen

template <typename Functor> QHttpServerRouterRule::QHttpServerRouterRule(const QString &pathPattern, const QHttpServerRequest::Methods methods, const QObject *receiver, Functor &&slot)

Erstellt eine Routing-Regel für pathPattern und methods und verbindet diese mit den angegebenen Adressen receiver und slot.

• slot kann ein Funktionszeiger, ein unveränderliches Lambda oder ein beliebiges anderes kopierbares, aufrufbares Objekt mit einem Aufrufoperator const sein.
• Wenn ` slot ` aufrufbar ist, fungiert ` receiver ` als dessen Kontextobjekt.
• Der Handler bleibt gültig, bis „ receiver “ zerstört wird.

Die Regel kann jede beliebige Kombination der verfügbaren HTTP-Methoden verarbeiten.

Siehe auch QHttpServerRequest::Methods.

template <typename Functor> QHttpServerRouterRule::QHttpServerRouterRule(const QString &pathPattern, const QObject *receiver, Functor &&slot)

Diese Überladung erstellt eine Weiterleitungsregel für pathPattern und ordnet sie receiver und slot zu.

• Standardmäßig ist „ QHttpServerRequest::Method::AnyKnown “ eingestellt, was bedeutet, dass jede erkannte HTTP-Methode abgeglichen wird.
• slot kann ein Funktionszeiger, ein nicht veränderbares Lambda oder ein beliebiges anderes kopierbares, aufrufbares Objekt mit dem Aufrufoperator const sein.
• Ist „ slot “ aufrufbar, fungiert „ receiver “ als dessen Kontextobjekt.
• Der Handler bleibt gültig, bis „ receiver “ zerstört wird.

[virtual noexcept] QHttpServerRouterRule::~QHttpServerRouterRule()

Löscht einen ` QHttpServerRouterRule`.

[static] template <typename Functor, typename ViewTraits = QHttpServerRouterViewTraits<Functor>> typename ViewTraits::BindableType QHttpServerRouterRule::bindCaptured(QObject *receiver, Functor &&slot, const QRegularExpressionMatch &match)

Bindet die angegebenen Funktionen „ receiver “ und „ slot “ mit den aus der URL extrahierten Argumenten. Die Funktion gibt ein gebundenes aufrufbares Objekt zurück, das alle verbleibenden, vom Handler benötigten Argumente entgegennimmt und diese nach den aus der URL abgeleiteten Werten an „ slot “ übergibt.

Jeder aus der URL erfasste Wert (als Zeichenkette) wird im Handler entsprechend seiner Position in den entsprechenden Parametertyp konvertiert, um sicherzustellen, dass er als ` match` übergeben werden kann.

QHttpServerRouter router;

auto pageView = [] (const QString&page, const quint32 num) {
    qDebug("page: %s, num: %d", qPrintable(page), num);
};
using ViewHandler = decltype(pageView);

auto rule = std::make_unique<QHttpServerRouterRule>(
    "/<arg>/<arg>/log",
    [&router, &pageView] (QRegularExpressionMatch&match,
                          const QHttpServerRequest&request,
                          QHttpServerResponder&&responder) {
    // Binde den ViewHandler und rufe ihn mit der erfassten Zeichenkette und dem „quint32“-Wert des Matches auf:
    QHttpServerRouterRule::bindCaptured(pageView, match)();
});

router.addRule<ViewHandler>(std::move(rule));

const QObject *QHttpServerRouterRule::contextObject() const

Ruft das dieser Regel zugeordnete Kontext-Objekt ab. Dieses Objekt dient als Empfänger, der für die Bearbeitung der Anfrage zuständig ist.

[protected] bool QHttpServerRouterRule::exec(const QHttpServerRequest &request, QHttpServerResponder &responder) const

Führt die Regel aus. Verarbeitet die angegebene request, indem geprüft wird, ob sie dieser Regel entspricht.

• Diese Funktion wird von QHttpServerRouter aufgerufen, wenn ein neuer request empfangen wird.
• Wenn der „ request “ mit der Regel übereinstimmt, bearbeitet er die Anfrage, indem er eine Antwort über den angegebenen „ responder “ sendet, und gibt „ true “ zurück.
• Wenn keine Übereinstimmung vorliegt, wird ` false` zurückgegeben.

[protected] bool QHttpServerRouterRule::hasValidMethods() const

Überprüft die Anfrage-Methode. Gibt „ true “ zurück, wenn die angegebene HTTP-Methode gültig ist.

[virtual protected] bool QHttpServerRouterRule::matches(const QHttpServerRequest &request, QRegularExpressionMatch *match) const

Prüft, ob das angegebene request die Bedingungen dieser Regel erfüllt.

• Diese virtuelle Funktion wird von ` exec()` aufgerufen, um die ` request` auszuwerten.
• Wenn die Anfrage übereinstimmt, werden die Details in ` match ` gespeichert (das nicht ` nullptr` sein darf ), und die Funktion gibt ` true` zurück.
• Andernfalls gibt sie false zurück.