QHttpServerRouter Class

Documentation des fonctions membres

QHttpServerRouter::QHttpServerRouter(QAbstractHttpServer *server)

Crée un objet QHttpServerRouter avec les convertisseurs par défaut.

Voir aussi converters.

[noexcept] QHttpServerRouter::~QHttpServerRouter()

Détruit un QHttpServerRouter.

template <typename Type> bool QHttpServerRouter::addConverter(QAnyStringView regexp)

Ajoute un nouveau convertisseur pour le type qui peut être analysé avec regexp, et renvoie true si cela a réussi, sinon renvoie false. En cas de succès, le type enregistré peut être utilisé comme argument dans les gestionnaires de QHttpServerRouterRule. L'expression régulière sera utilisée pour analyser le modèle de chemin de la règle.

S'il existe déjà un convertisseur de type Type, l'expression rationnelle de ce convertisseur est remplacée par regexp.

Les convertisseurs personnalisés peuvent étendre les conversions de type disponibles via le système QMetaType.

Définissez une classe avec un constructeur QString:

struct CustomArg {
    int data = 10;

    CustomArg() {} ;
    CustomArg(const QString &urlArg) : data(urlArg.toInt()) {}
};

Pour utiliser un type personnalisé avec HTTP server, enregistrez-le à l'aide de cette fonction et définissez un gestionnaire route utilisant le nouveau type :

server.router()->addConverter<CustomArg>(u"[+-]?\\d+");
server.route("/customTest/<arg>", [] (const CustomArg custom) { return QString::number(custom.data); });

Voir également converters et clearConverters.

void QHttpServerRouter::addConverter(QMetaType metaType, QAnyStringView regexp)

Ajoute un nouveau convertisseur pour metaType qui peut être analysé avec regexp. Le fait d'avoir un convertisseur pour metaType permet d'utiliser ce type dans un motif de chemin d'accès de QHttpServerRouterRule. L'expression régulière est utilisée pour analyser les paramètres de type metaType à partir du motif de chemin d'accès.

S'il existe déjà un convertisseur de type metaType, l'expression rationnelle de ce convertisseur est remplacée par regexp.

Voir également converters et clearConverters.

template <typename ViewHandler, typename ViewTraits = QHttpServerRouterViewTraits<ViewHandler>> QHttpServerRouterRule *QHttpServerRouter::addRule(std::unique_ptr<QHttpServerRouterRule> rule)

Ajoute une nouvelle rule au routeur.

Renvoie un pointeur sur la nouvelle règle en cas de succès, sinon il renvoie nullptr.

Dans addRule, nous déterminons les arguments ViewHandler et générons une liste de leurs identifiants QMetaType::Type. Ensuite, nous analysons le chemin et remplaçons chaque "<arg>" par une expression rationnelle correspondant à son type dans la liste.

L'adresse rule fournie ne doit pas modifier l'instance QHttpServerRouter.

QHttpServerRouter router;

using ViewHandler = decltype([] (const QString &page, const quint32 num) { });

auto rule = std::make_unique<QHttpServerRouterRule>(
    "/<arg>/<arg>/log",
    [] (QRegularExpressionMatch &match,
        const QHttpServerRequest &request,
        QHttpServerResponder &&responder) {
});

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

void QHttpServerRouter::clearConverters()

Supprime tous les convertisseurs.

Voir aussi converters et addConverter.

Renvoie une carte des types de convertisseurs et des expressions régulières enregistrés sur ce site QHttpServerRouter. Il s'agit des types qui peuvent être utilisés dans les motifs de chemin d'accès de QHttpServerRouterRules.

Les convertisseurs suivants sont disponibles par défaut :

Voir également addConverter et clearConverters.

bool QHttpServerRouter::handleRequest(const QHttpServerRequest &request, QHttpServerResponder &responder) const

Traite chaque nouvelle adresse request pour le serveur HTTP en utilisant responder.

Interroge la liste des règles pour trouver la première qui correspond, puis exécute cette règle et renvoie true. Renvoie false si aucune règle ne correspond à la demande.

void QHttpServerRouter::removeConverter(QMetaType metaType)

Supprime le convertisseur pour le type metaType.

Voir aussi addConverter.