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;

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) {
    // マッチからキャプチャされた文字列と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 を返します。