QHttpServerRouter Class

Dokumentation der Mitgliedsfunktionen

Gibt eine Karte der Konvertertypen und regulären Ausdrücke zurück, die bei diesem QHttpServerRouter registriert sind. Dies sind die Typen, die in Pfadmustern von QHttpServerRouterRules verwendet werden können.

Die folgenden Konverter sind standardmäßig verfügbar:

Siehe auch addConverter und clearConverters.

QHttpServerRouter::QHttpServerRouter(QAbstractHttpServer *server)

Erzeugt ein QHttpServerRouter-Objekt mit Standardkonvertern.

Siehe auch converters.

[noexcept] QHttpServerRouter::~QHttpServerRouter()

Zerstört eine QHttpServerRouter.

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

Fügt einen neuen Konverter für Type hinzu, der mit regexp geparst werden kann, und gibt true zurück, wenn dies erfolgreich war, ansonsten false. Wenn dies erfolgreich war, kann der registrierte Typ als Argument in Handlern für QHttpServerRouterRule verwendet werden. Der reguläre Ausdruck wird zum Parsen des Pfadmusters der Regel verwendet.

Wenn es bereits einen Konverter vom Typ Type gibt, wird der Regexp dieses Konverters durch regexp ersetzt.

Minimales Beispiel:

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) { // Binden und Aufrufen von viewHandler mit der erfassten Zeichenkette von match und quint32:    QHttpServerRouterRule::bindCaptured(pageView, match)(); }); router.addRule<ViewHandler>(std::move(rule));

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

Fügt einen neuen Konverter für metaType hinzu, der mit regexp geparst werden kann. Ein Konverter für metaType ermöglicht die Verwendung dieses Typs in einem Pfadmuster von QHttpServerRouterRule. Der reguläre Ausdruck wird verwendet, um Parameter des Typs metaType aus dem Pfadmuster zu parsen.

Wenn es bereits einen Konverter des Typs metaType gibt, wird der regexp dieses Konverters durch regexp ersetzt.

Siehe auch converters und clearConverters.

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

Fügt dem Router eine neue rule hinzu.

Gibt im Erfolgsfall einen Zeiger auf die neue Regel zurück, andernfalls nullptr.

Innerhalb von addRule ermitteln wir die ViewHandler-Argumente und erstellen eine Liste ihrer QMetaType::Type ids. Dann wird die URL geparst und jedes <arg> durch einen Regexp für seinen Typ aus der Liste ersetzt. Die rule darf die Instanz QHttpServerRouter nicht verändern.

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

Entfernt alle Konverter.

Siehe auch converters und addConverter.

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

Behandelt jede neue request für den HTTP-Server mit responder.

Iteriert durch die Liste der Regeln, um die erste passende Regel zu finden, führt diese dann aus und gibt true zurück. Gibt false zurück, wenn keine Regel auf die Anfrage zutrifft.

void QHttpServerRouter::removeConverter(QMetaType metaType)

Entfernt den Konverter für den Typ metaType.

Siehe auch addConverter.