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 로 대체됩니다.

사용자 정의 변환기는 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)

regexp 으로 구문 분석할 수 있는 metaType 에 대한 새 변환기를 추가합니다. metaType 에 대한 변환기가 있으면 QHttpServerRouterRule 의 경로 패턴에서 이 유형을 사용할 수 있습니다. 이 정규식은 경로 패턴에서 metaType 유형의 매개 변수를 구문 분석하는 데 사용됩니다.

metaType 유형의 변환기가 이미 있는 경우 해당 변환기의 정규식은 regexp 으로 대체됩니다.

converters 및 clearConverters도 참조하세요 .

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

라우터에 새 rule 을 추가합니다.

성공하면 새 규칙에 대한 포인터를 반환하고, 그렇지 않으면 nullptr 을 반환합니다.

addRule 내부에서 ViewHandler 인수를 결정하고 QMetaType::Type 아이디 목록을 생성합니다. 그런 다음 경로를 구문 분석하고 각 <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도 참조하세요 .