QHttpServerRouterRule Class

멤버 함수 문서

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

pathPattern 및 methods 에 대한 라우팅 규칙을 생성하여, 이를 지정된 receiver 및 slot 에 연결합니다.

• slot 는 함수 포인터, 변경 불가능한 람다, 또는 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 는 함수 포인터, 변경 불가능한 람다 또는 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;

auto pageView = [] (const QString&page, const quint32 num) {
    qDebug("page: %s, num: %d", qPrintable(page), num);
};
using ViewHandler = decltype(pageView);

auto rule = std::make_unique<QHttpServerRouterRule>(
    "/<arg>/<arg>/log",
    [&router, &pageView] (QRegularExpressionMatch&match,
                          const QHttpServerRequest&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 을 반환합니다.