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 に供給する、バインドされた callable を返します。

URLから(文字列として)取り出された各値は、その位置に基づいてハンドラの対応する パラメータ型に変換され、match として確実に渡すことができる。

QHttpServerRouterルーター;autopageView= [](constQStringページ, constquint32num)    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 がこのルールの条件を満たすかどうかを判定する。

• この仮想関数は、request を評価するためにexec()から呼び出される。
• リクエストがマッチする場合、その詳細はmatch (nullptr であってはならない)に格納され、関数はtrue を返す。
• マッチしない場合、この関数はfalse を返す。