action.h

/*
 * SPDX-FileCopyrightText: (C) 2013-2022 Daniel Nicoletti <dantti12@gmail.com>
 * SPDX-License-Identifier: BSD-3-Clause
 */
#ifndef CUTELYST_ACTION_H
#define CUTELYST_ACTION_H
 
#include <Cutelyst/component.h>
#include <Cutelyst/context.h>
#include <Cutelyst/cutelyst_global.h>
 
#include <QtCore/QMetaMethod>
#include <QtCore/QStringList>
 
namespace Cutelyst {
 
class Controller;
class Dispatcher;
class ActionPrivate;
class CUTELYST_LIBRARY Action : public Component
{
    Q_OBJECT
public:
    explicit Action(QObject *parent = nullptr);
    virtual ~Action() override = default;
 
    virtual Modifiers modifiers() const override;

    ParamsMultiMap attributes() const noexcept;

    QString attribute(const QString &name, const QString &defaultValue = {}) const;

    void setAttributes(const ParamsMultiMap &attributes);

    QString className() const;

    Controller *controller() const;

    inline bool dispatch(Context *c) { return c->execute(this); }

    virtual bool match(int numberOfArgs) const noexcept;

    virtual bool matchCaptures(int numberOfCaptures) const noexcept;

    QString ns() const noexcept;

    virtual qint8 numberOfArgs() const noexcept;

    virtual qint8 numberOfCaptures() const noexcept;
 
protected:
    friend class Dispatcher;
    friend class ControllerPrivate;

    explicit Action(ActionPrivate *ptr, QObject *parent = nullptr);

    virtual bool doExecute(Context *c) override;

    void setMethod(const QMetaMethod &method);

    void setController(Controller *controller);

    void setupAction(const QVariantHash &args, Application *app);
 
private:
    Q_DECLARE_PRIVATE(Action)
};

typedef QVector<Action *> ActionList;
 
} // namespace Cutelyst
 
#endif // CUTELYST_ACTION_H