action.h

/*
 * SPDX-FileCopyrightText: (C) 2013-2024 Daniel Nicoletti <dantti12@gmail.com>
 * SPDX-License-Identifier: BSD-3-Clause
 */
#pragma once
 
#include <Cutelyst/component.h>
#include <Cutelyst/context.h>
#include <Cutelyst/cutelyst_export.h>
 
#include <QtCore/QMetaMethod>
#include <QtCore/QStringList>
 
namespace Cutelyst {
 
class Controller;
class Dispatcher;
class ActionPrivate;
class CUTELYST_EXPORT Action : public Component
{
    Q_OBJECT
public:
    explicit Action(QObject *parent = nullptr);
 
    virtual ~Action() override = default;
 
    virtual Modifiers modifiers() const override;
 
    [[nodiscard]] ParamsMultiMap attributes() const noexcept;
 
    [[nodiscard]] QString attribute(const QString &name, const QString &defaultValue = {}) const;
 
    void setAttributes(const ParamsMultiMap &attributes);
 
    [[nodiscard]] QString className() const noexcept;
 
    [[nodiscard]] Controller *controller() const noexcept;
 
    inline bool dispatch(Context *c) { return c->execute(this); }
 
    [[nodiscard]] virtual bool match(int numberOfArgs) const noexcept;
 
    [[nodiscard]] virtual bool matchCaptures(int numberOfCaptures) const noexcept;
 
    [[nodiscard]] QString ns() const noexcept;
 
    [[nodiscard]] virtual qint8 numberOfArgs() const;
 
    [[nodiscard]] virtual qint8 numberOfCaptures() const;
 
protected:
    friend class Dispatcher;
    friend class ControllerPrivate;
 
    explicit Action(ActionPrivate *ptr, QObject *parent = nullptr);
 
    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