QHttpServerRouter Class

成员函数文档

返回已在QHttpServerRouter 注册的转换器类型和正则表达式的映射。这些类型可用于QHttpServerRouterRules 的路径模式。

默认情况下可使用以下转换器：

另请参阅 addConverter 和clearConverters 。

QHttpServerRouter::QHttpServerRouter(QAbstractHttpServer *server)

创建带有默认转换器的 QHttpServerRouter 对象。

另请参阅 converters 。

[noexcept] QHttpServerRouter::~QHttpServerRouter()

销毁QHttpServerRouter.

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

为可使用regexp 解析的Type添加新转换器，如果成功则返回true ，否则返回false 。如果成功，注册的类型可用作QHttpServerRouterRule 的处理程序的参数。正则表达式将用于解析规则的路径模式。

如果已经存在Type 类型的转换器，该转换器的 regexp 将被替换为regexp 。

自定义转换器可以通过QMetaType 系统扩展可用的类型转换。

定义一个带有QString 构造函数的类：

struct CustomArg {
    int data = 10;

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

要在HTTP server 中使用自定义类型，请使用此函数对其进行注册，并使用新类型定义一个route 处理程序：

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

另请参阅 converters 和clearConverters 。

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

为metaType 添加新的转换器，该转换器可与regexp 一起解析。有了metaType 的转换器，就可以在QHttpServerRouterRule 的路径模式中使用该类型。正则表达式用于解析路径模式中metaType 类型的参数。

如果已有metaType 类型的转换器，则转换器的 regexp 将被替换为regexp 。

另请参见 converters 和clearConverters 。

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

向路由器添加新的rule 。

如果成功，则返回指向新规则的指针，否则返回nullptr 。

在 addRule 中，我们确定 ViewHandler 参数并生成一个QMetaType::Type id 列表。然后解析路径，用列表中的 regexp 类型替换每个<arg> 。rule 不得修改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()

删除所有转换器。

另请参阅 converters 和addConverter 。

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

使用responder 处理 HTTP 服务器的每个新request 。

遍历规则列表，找到第一个匹配的规则，然后执行该规则，返回true 。如果没有规则匹配请求，则返回false 。

void QHttpServerRouter::removeConverter(QMetaType metaType)

移除metaType 类型的转换器。

另请参阅 addConverter 。