QHttpServerRouter Class

Member Function Documentation

Returns a map of converter types and regular expressions that are registered with this QHttpServerRouter. These are the types that can be used in path patterns of QHttpServerRouterRules.

The following converters are available by default:

See also addConverter and clearConverters.

QHttpServerRouter::QHttpServerRouter(QAbstractHttpServer *server)

Creates a QHttpServerRouter object with default converters.

See also converters.

[noexcept] QHttpServerRouter::~QHttpServerRouter()

Destroys a QHttpServerRouter.

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

Adds a new converter for Type that can be parsed with regexp, and returns true if this was successful, otherwise returns false. If successful, the registered type can be used as argument in handlers for QHttpServerRouterRule. The regular expression will be used to parse the path pattern of the rule.

If there is already a converter of type Type, that converter's regexp is replaced with regexp.

Minimal example:

struct CustomArg {
    int data = 10;

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

QHttpServerRouter router;
router.addConverter<CustomArg>(u"[+-]?\\d+"));

auto pageView = [] (const CustomArg &customArg) {
    qDebug("data: %d", customArg.data);
};
using ViewHandler = decltype(pageView);

auto rule = std::make_unique<QHttpServerRouterRule>(
    "/<arg>/log",
    [&router, &pageView] (QRegularExpressionMatch &match,
                          const QHttpServerRequest &request,
                          QHttpServerResponder &&responder) {
    // Bind and call viewHandler with match's captured string and quint32:
    QHttpServerRouterRule::bindCaptured(pageView, match)();
});

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

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

Adds a new converter for metaType that can be parsed with regexp. Having a converter for a metaType enables to use this type in a path pattern of a QHttpServerRouterRule. The regular expression is used to parse parameters of type metaType from the path pattern.

If there is already a converter of type metaType, that converter's regexp is replaced with regexp.

See also converters and clearConverters.

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

Adds a new rule to the router.

Returns a pointer to the new rule if successful or nullptr otherwise.

Inside addRule, we determine ViewHandler arguments and generate a list of their QMetaType::Type ids. Then we parse the URL and replace each <arg> with a regexp for its type from the list. The rule must not modify the QHttpServerRouter instance.

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()

Removes all converters.

See also converters and addConverter.

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

Handles each new request for the HTTP server using responder.

Iterates through the list of rules to find the first that matches, then executes this rule, returning true. Returns false if no rule matches the request.

void QHttpServerRouter::removeConverter(QMetaType metaType)

Removes the converter for type metaType.

See also addConverter.