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 でパース可能な型の新しいコンバータを追加し、成功した場合はtrue を返し、そうでない場合はfalse を返す。成功した場合、登録された型はQHttpServerRouterRule のハンドラの引数として使用できる。正規表現は、ルールのパスパターンを解析するために使用される。

Type型のコンバーターがすでに存在する場合、そのコンバーターの正規表現はregexp に置き換えられる。

最小限の例：

structCustomArg {intdata= 10; CustomArg() {} ; CustomArg(constQString&urlArg) : data(urlArg.toInt()) {} }; Q_DECLARE_METATYPE(CustomArg)；QHttpServerRouterrouter; router.addConverter<CustomArg>(u"[+-]?    qDebug("data: %d", customArg.data);
};usingViewHandler=decltype(pageView);autorule=std::make_unique<QHttpServerRouterRule>("/<arg>/log", [&router, &pageView](QRegularExpressionMatch&match, constQHttpServerRequest&request、               QHttpServerResponder&&responder) {// マッチがキャプチャした文字列とquint32でviewHandlerをバインドして呼び出す：    QHttpServerRouterRule::bindCaptured(pageView,match)(); }); router.addRule<ViewHandler>(std::move(rule));

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 ID のリストを生成します。次に、URLを解析し、<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

HTTPサーバーの各新規request を、responder を使用して処理する。

ルールのリストを繰り返し、最初にマッチするルールを見つけ、そのルールを 実行してtrue を返す。リクエストにマッチするルールがない場合はfalse を返す。

void QHttpServerRouter::removeConverter(QMetaType metaType)

metaType 型のコンバータを削除する。

addConverterも参照のこと 。