dispatcher.h

/*
 * SPDX-FileCopyrightText: (C) 2013-2023 Daniel Nicoletti <dantti12@gmail.com>
 * SPDX-License-Identifier: BSD-3-Clause
 */
#pragma once
 
#include <Cutelyst/action.h>
#include <Cutelyst/cutelyst_export.h>
 
#include <QtCore/qhash.h>
#include <QtCore/qobject.h>
#include <QtCore/qstringlist.h>
 
namespace Cutelyst {
 
class Context;
class Controller;
class DispatchType;
class DispatcherPrivate;

class CUTELYST_EXPORT Dispatcher : public QObject
{
    Q_OBJECT
public:
    explicit Dispatcher(QObject *parent = nullptr);

    ~Dispatcher();

    [[nodiscard]] Action *getAction(QStringView name, QStringView nameSpace = {}) const;

    [[nodiscard]] Action *getActionByPath(QStringView path) const;

    [[nodiscard]] ActionList getActions(QStringView name, QStringView nameSpace) const;

    [[nodiscard]] Controller *controller(QStringView name) const;

    [[nodiscard]] QList<Controller *> controllers() const;

    [[nodiscard]] QString uriForAction(Action *action, const QStringList &captures) const;

    [[nodiscard]] Action *expandAction(const Context *c, Action *action) const;

    [[nodiscard]] QVector<DispatchType *> dispatchers() const;
 
protected:
    void setupActions(const QVector<Controller *> &controllers,
                      const QVector<DispatchType *> &dispatchers,
                      bool printActions);

    bool dispatch(Context *c);

    bool forward(Context *c, Component *component);

    bool forward(Context *c, QStringView opname);

    void prepareAction(Context *c);
 
protected:
    friend class Application;
    friend class Context;
    friend class Controller;
    DispatcherPrivate *d_ptr;
 
private:
    Q_DECLARE_PRIVATE(Dispatcher)
};
 
} // namespace Cutelyst