QHttpServerRouterRule Class

成员函数文档

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

为pathPattern 和methods 创建一条路由规则，将其连接到指定的receiver 和slot 。

• slot 可以是函数指针、不可变的 lambda 表达式，或任何其他具有const 调用运算符的可复制可调用对象。
• 如果slot 是可调用的，则receiver 将作为其上下文对象。
• 该处理程序在receiver 被销毁之前一直有效。

该规则可处理任何可用的 HTTP 方法组合。

另请参阅 QHttpServerRequest::Methods 。

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

此重载会为pathPattern 构建一条路由规则，并将其与receiver 和slot 关联起来。

• 其默认值为QHttpServerRequest::Method::AnyKnown ，这意味着它将匹配任何被识别的 HTTP 方法。
• slot 可以是函数指针、不可变的 lambda 表达式，或任何其他具有const 调用运算符的可复制可调用对象。
• 如果slot 是可调用的，则receiver 将作为其上下文对象。
• 该处理程序在receiver 被销毁之前始终有效。

[virtual noexcept] QHttpServerRouterRule::~QHttpServerRouterRule()

销毁一个QHttpServerRouterRule 。

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

将给定的receiver 和slot 与从URL中提取的参数进行绑定。该函数返回一个已绑定的可调用对象，该对象会接收处理程序所需的任何剩余参数，并在将URL派生的值传递给slot 之后，将这些参数一并提供给 。

从 URL 中捕获的每个值（作为字符串）都会根据其位置转换为处理程序中对应的参数类型，以确保其能够作为match 传递。

QHttpServerRouter router;

autopageView= [](constQString&page, constquint32 num) {
    qDebug("page: %s, num: %d", qPrintable(page), num);
};
usingViewHandler=decltype(pageView);

autorule=std::make_unique<QHttpServerRouterRule>(
    "/<arg>/<arg>/log",
    [&router, &pageView](QRegularExpressionMatch&match,
                          constQHttpServerRequest&request,
                          QHttpServerResponder&&responder) {
    // 使用 match 捕获的字符串和 quint32 值绑定并调用 viewHandler：
    QHttpServerRouterRule::bindCaptured(pageView,match)();
});

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

const QObject *QHttpServerRouterRule::contextObject() const

获取与该规则关联的上下文对象。该对象作为负责处理请求的接收者。

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

执行该规则。处理给定的request ，检查其是否符合该规则。

• 当接收到新的request 时，QHttpServerRouter 会调用此函数。
• 如果request 与规则匹配，则通过提供的responder 发送响应来处理该请求，并返回true 。
• 如果不匹配，则返回false 。

[protected] bool QHttpServerRouterRule::hasValidMethods() const

验证请求方法。如果指定的 HTTP 方法有效，则返回true 。

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

确定所提供的request 是否符合本规则的条件。

• 该虚拟函数由exec()调用，用于评估request 。
• 如果请求匹配，则将详细信息存储在match 中（该对象不得是nullptr ），并且该函数返回true 。
• 否则，该函数返回false 。