QHttpServerRouterRule Class

Documentation sur les fonctions membres

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

Crée une règle de routage pour pathPattern et methods, en les reliant aux adresses spécifiées receiver et slot.

• La fonction slot peut être un pointeur de fonction, un lambda non modifiable ou tout autre objet appelable copiable doté de l'opérateur d'appel const.
• Si slot est une entité appelable, receiver fait office d’objet de contexte.
• Le gestionnaire reste valide jusqu’à ce que l’ receiver soit détruit.

La règle peut gérer n'importe quelle combinaison de méthodes HTTP disponibles.

Voir également QHttpServerRequest::Methods.

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

Cette surcharge crée une règle de routage pour pathPattern et l'associe à receiver et slot.

• La valeur par défaut est QHttpServerRequest::Method::AnyKnown, ce qui signifie qu'elle correspondra à toute méthode HTTP reconnue.
• La fonction slot peut être un pointeur de fonction, un lambda non modifiable ou tout autre objet appelable copiable doté de l'opérateur d'appel const.
• Si slot est un objet appelable, receiver fait office d’objet de contexte.
• Le gestionnaire reste valide jusqu’à la destruction de l’ receiver.

[virtual noexcept] QHttpServerRouterRule::~QHttpServerRouterRule()

Supprime un objet de type « QHttpServerRouterRule ».

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

Lie les URL receiver et slot aux arguments extraits de l'URL. La fonction renvoie une fonction appelable liée qui prend tous les arguments restants requis par le gestionnaire, en les transmettant à slot après les valeurs dérivées de l'URL.

Chaque valeur capturée à partir de l’URL (sous forme de chaîne de caractères) est convertie en type de paramètre correspondant dans le gestionnaire en fonction de sa position, ce qui garantit qu’elle peut être transmise sous la forme match.

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) {
    // Lier et appeler viewHandler avec la chaîne et le quint32 capturés par match :
    QHttpServerRouterRule::bindCaptured(pageView, match)();
});

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

const QObject *QHttpServerRouterRule::contextObject() const

Récupère l'objet de contexte associé à cette règle. Cet objet fait office de récepteur chargé de traiter la requête.

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

Exécute la règle. Traite l'request ion fournie en vérifiant si elle correspond à cette règle.

• Cette fonction est appelée par QHttpServerRouter lorsqu’une nouvelle request est reçue.
• Si l'request correspond à la règle, elle traite la requête en envoyant une réponse via l'responder fournie et renvoie true.
• S'il n'y a pas de correspondance, elle renvoie false.

[protected] bool QHttpServerRouterRule::hasValidMethods() const

Vérifie la validité de la méthode de requête. Renvoie « true » si la méthode HTTP indiquée est valide.

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

Détermine si l'request fournie remplit les conditions de cette règle.

• Cette fonction virtuelle est appelée par ` exec()` pour évaluer ` request`.
• Si la requête correspond, les détails sont stockés dans ` match ` (qui ne doit pas être ` nullptr`), et la fonction renvoie ` true`.
• Sinon, elle renvoie false.