qgsserverrequest.h

Go to the documentation of this file.

/***************************************************************************
                          qgsserverrequest.h

  Define request class for getting request contents
  -------------------
  begin                : 2016-12-05
  copyright            : (C) 2016 by David Marteau
  email                : david dot marteau at 3liz dot com
 ***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
#ifndef QGSSERVERREQUEST_H
#define QGSSERVERREQUEST_H

#include <QUrl>
#include <QMap>
#include "qgis_server.h"
#include "qgsserverparameters.h"

// Note about design: this interface must be passed along to Python and thus signatures methods must be
// compatible with pyQGIS/pyQT api and rules.

class SERVER_EXPORT QgsServerRequest
{
    Q_GADGET

  public:

    typedef QMap<QString, QString> Parameters;
    typedef QMap<QString, QString> Headers;

    enum Method
    {
      HeadMethod,
      PutMethod,
      GetMethod,
      PostMethod,
      DeleteMethod,
      PatchMethod
    };
    Q_ENUM( Method )


    
    QgsServerRequest() = default;

    QgsServerRequest( const QString &url, QgsServerRequest::Method method = QgsServerRequest::GetMethod, const QgsServerRequest::Headers &headers = QgsServerRequest::Headers() );

    QgsServerRequest( const QUrl &url, QgsServerRequest::Method method = QgsServerRequest::GetMethod, const QgsServerRequest::Headers &headers = QgsServerRequest::Headers() );

    virtual ~QgsServerRequest() = default;

    static QString methodToString( const Method &method );


    QUrl url() const;

    QgsServerRequest::Method method() const;

    QgsServerRequest::Parameters parameters() const;

    QgsServerParameters serverParameters() const;

    void setParameter( const QString &key, const QString &value );

    QString parameter( const QString &key, const QString &defaultValue = QString() ) const;

    void removeParameter( const QString &key );

    QString header( const QString &name ) const;

    void setHeader( const QString &name, const QString &value );

    QMap<QString, QString> headers() const;

    void removeHeader( const QString &name );

    virtual QByteArray data() const;

    void setUrl( const QUrl &url );

    QUrl originalUrl() const;

    void setMethod( QgsServerRequest::Method method );

    const QString queryParameter( const QString &name, const QString &defaultValue = QString( ) ) const;

  protected:

    void setOriginalUrl( const QUrl &url );


  private:
    // Url as seen by QGIS server after web server rewrite
    QUrl       mUrl;
    // Unrewritten url as seen by the web server
    QUrl       mOriginalUrl;
    Method     mMethod = GetMethod;
    // We mark as mutable in order
    // to support lazy initialization
    mutable Headers mHeaders;
    QgsServerParameters mParams;
};

#endif