request.h

/*
 * SPDX-FileCopyrightText: (C) 2013-2022 Daniel Nicoletti <dantti12@gmail.com>
 * SPDX-License-Identifier: BSD-3-Clause
 */
#ifndef CUTELYST_REQUEST_H
#define CUTELYST_REQUEST_H
 
#include <Cutelyst/cutelyst_global.h>
#include <Cutelyst/headers.h>
#include <Cutelyst/paramsmultimap.h>
 
#include <QtCore/qobject.h>
#include <QtCore/qstringlist.h>
 
class QIODevice;
class QHostAddress;
 
namespace Cutelyst {
 
class Engine;
class Upload;
class Context;

typedef QVector<Upload *> Uploads;
 
class EngineRequest;
class RequestPrivate;
class CUTELYST_LIBRARY Request final : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QString hostname READ hostname CONSTANT)
    Q_PROPERTY(quint16 port READ port CONSTANT)
    Q_PROPERTY(QUrl uri READ uri CONSTANT)
    Q_PROPERTY(QString base READ base CONSTANT)
    Q_PROPERTY(QString path READ path CONSTANT)
    Q_PROPERTY(QString match READ match CONSTANT)
    Q_PROPERTY(QStringList arguments READ arguments CONSTANT)
    Q_PROPERTY(QStringList args READ arguments CONSTANT)
    Q_PROPERTY(bool secure READ secure CONSTANT)
    Q_PROPERTY(QVariant bodyData READ bodyData CONSTANT)
    Q_PROPERTY(Cutelyst::ParamsMultiMap bodyParams READ bodyParameters CONSTANT)
    Q_PROPERTY(Cutelyst::ParamsMultiMap queryParams READ queryParameters CONSTANT)
    Q_PROPERTY(QString contentEncoding READ contentEncoding CONSTANT)
    Q_PROPERTY(QString contentType READ contentType CONSTANT)
    Q_PROPERTY(QString method READ method CONSTANT)
    Q_PROPERTY(QString protocol READ protocol CONSTANT)
    Q_PROPERTY(QString userAgent READ userAgent CONSTANT)
    Q_PROPERTY(QString referer READ referer CONSTANT)
    Q_PROPERTY(QString remoteUser READ remoteUser CONSTANT)
public:
    virtual ~Request();

    QHostAddress address() const noexcept;

    QString addressString() const;

    QString hostname() const;

    quint16 port() const;

    QUrl uri() const;

    QString base() const;

    QString path() const noexcept;

    QString match() const noexcept;

    void setMatch(const QString &match);

    QStringList arguments() const noexcept;

    void setArguments(const QStringList &arguments);

    inline QStringList args() const;

    QStringList captures() const noexcept;

    void setCaptures(const QStringList &captures);

    bool secure() const noexcept;

    QIODevice *body() const;

    QVariant bodyData() const;

    QJsonDocument bodyJsonDocument() const;

    QJsonObject bodyJsonObject() const;

    QJsonArray bodyJsonArray() const;

    QVariantMap bodyParametersVariant() const;

    ParamsMultiMap bodyParameters() const;

    inline QString bodyParameter(const QString &key, const QString &defaultValue = {}) const;

    QStringList bodyParameters(const QString &key) const;

    inline ParamsMultiMap bodyParams() const;

    inline QString bodyParam(const QString &key, const QString &defaultValue = {}) const;

    inline QStringList bodyParams(const QString &key) const;

    QString queryKeywords() const;

    QVariantMap queryParametersVariant() const;

    ParamsMultiMap queryParameters() const;

    inline QString queryParameter(const QString &key, const QString &defaultValue = {}) const;

    QStringList queryParameters(const QString &key) const;

    inline ParamsMultiMap queryParams() const;

    inline QString queryParam(const QString &key, const QString &defaultValue = {}) const;

    inline QStringList queryParams(const QString &key) const;

    inline QString contentEncoding() const;

    inline QString contentType() const;

    QString cookie(const QString &name) const;

    QStringList cookies(const QString &name) const;

    ParamsMultiMap cookies() const;

    inline QString header(const QString &key) const;

    Headers headers() const noexcept;

    QString method() const noexcept;

    bool isPost() const noexcept;

    bool isGet() const noexcept;

    bool isHead() const noexcept;

    bool isPut() const noexcept;

    bool isPatch() const noexcept;

    bool isDelete() const noexcept;

    QString protocol() const noexcept;

    bool xhr() const noexcept;

    inline QString userAgent() const;

    inline QString referer() const;

    QString remoteUser() const noexcept;

    QVector<Upload *> uploads() const;

    QMultiMap<QString, Upload *> uploadsMap() const;

    Uploads uploads(const QString &name) const;

    inline Upload *upload(const QString &name) const;

    ParamsMultiMap mangleParams(const ParamsMultiMap &args, bool append = false) const;

    QUrl uriWith(const ParamsMultiMap &args, bool append = false) const;

    Engine *engine() const noexcept;

    Request(EngineRequest *engineRequest);
 
Q_SIGNALS:
    void webSocketTextFrame(const QString &message, bool isLastFrame, Cutelyst::Context *c);

    void webSocketTextMessage(const QString &message, Cutelyst::Context *c);

    void webSocketBinaryFrame(const QByteArray &message, bool isLastFrame, Cutelyst::Context *c);

    void webSocketBinaryMessage(const QByteArray &message, Cutelyst::Context *c);

    void webSocketPong(const QByteArray &payload, Cutelyst::Context *c);

    void webSocketClosed(quint16 closeCode, const QString &reason);
 
protected:
    RequestPrivate *d_ptr;
 
private:
    friend class Application;
    friend class Dispatcher;
    friend class DispatchType;
    friend class Context;
    Q_DECLARE_PRIVATE(Request)
};
 
inline QStringList Request::args() const
{
    return arguments();
}
 
inline QString Request::bodyParameter(const QString &key, const QString &defaultValue) const
{
    return bodyParameters().value(key, defaultValue);
}
 
inline ParamsMultiMap Request::bodyParams() const
{
    return bodyParameters();
}
 
inline QString Request::bodyParam(const QString &key, const QString &defaultValue) const
{
    return bodyParameters().value(key, defaultValue);
}
 
inline QStringList Request::bodyParams(const QString &key) const
{
    return bodyParameters(key);
}
 
inline QString Request::queryParameter(const QString &key, const QString &defaultValue) const
{
    return queryParameters().value(key, defaultValue);
}
 
inline ParamsMultiMap Request::queryParams() const
{
    return queryParameters();
}
 
inline QString Request::queryParam(const QString &key, const QString &defaultValue) const
{
    return queryParameters().value(key, defaultValue);
}
 
inline QStringList Request::queryParams(const QString &key) const
{
    return queryParameters(key);
}
 
inline QString Request::contentEncoding() const
{
    return headers().contentEncoding();
}
 
inline QString Request::contentType() const
{
    return headers().contentType();
}
 
inline QString Request::header(const QString &key) const
{
    return headers().header(key);
}
 
inline QString Request::userAgent() const
{
    return headers().userAgent();
}
 
inline QString Request::referer() const
{
    return headers().referer();
}
 
inline Upload *Request::upload(const QString &name) const
{
    return uploadsMap().value(name);
}
 
} // namespace Cutelyst
 
#endif // CUTELYST_REQUEST_H