qgsrequesthandler.h

Go to the documentation of this file.

/***************************************************************************
                              qgsrequesthandler.h
                 abstraction for reading from/ writing to a request datasource
                              -------------------
  begin                : May 16, 2006
  copyright            : (C) 2006 by Marco Hugentobler
                         (C) 2014 by Alessandro Pasotti
  email                : marco dot hugentobler at karto dot baug dot ethz dot ch
                         a dot pasotti at itopen dot it
 ***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   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 QGSREQUESTHANDLER_H
#define QGSREQUESTHANDLER_H

//Needed for HAVE_SERVER_PYTHON_PLUGINS
#include "qgsconfig.h"

#include <QMap>
#include <QString>
#include <QStringList>
#include <QPair>

#ifdef HAVE_SERVER_PYTHON_PLUGINS
#include "qgsserverfilter.h"
#endif

class QDomDocument;
class QImage;
class QgsMapServiceException;

class QgsRequestHandler
{

  public:

    QgsRequestHandler()
        : mHeadersSent( false )
        , mException( nullptr )
    {}
    virtual ~QgsRequestHandler() {}
    virtual void parseInput() = 0;
    virtual void setGetMapResponse( const QString& service, QImage* img, int imageQuality ) = 0;
    virtual void setGetCapabilitiesResponse( const QDomDocument& doc ) = 0;
    virtual void setGetFeatureInfoResponse( const QDomDocument& infoDoc, const QString& infoFormat ) = 0;
    virtual void setServiceException( QgsMapServiceException ex ) = 0;
    virtual void setXmlResponse( const QDomDocument& doc ) = 0;
    virtual void setXmlResponse( const QDomDocument& doc, const QString& mimeType ) = 0;
    virtual void setGetPrintResponse( QByteArray* b ) = 0;
    virtual bool startGetFeatureResponse( QByteArray* ba, const QString& infoFormat ) = 0;
    virtual void setGetFeatureResponse( QByteArray* ba ) = 0;

    virtual void endGetFeatureResponse( QByteArray* ba ) = 0;
    virtual void setGetCoverageResponse( QByteArray* ba ) = 0;
    virtual void setDefaultHeaders() {}
    virtual void setHeader( const QString &name, const QString &value ) = 0;
    virtual int removeHeader( const QString &name ) = 0;
    virtual void clearHeaders() = 0;
    virtual void appendBody( const QByteArray &body ) = 0;
    virtual void clearBody() = 0;
    virtual QByteArray body() { return mBody; }
    virtual void setInfoFormat( const QString &format ) = 0;
    virtual bool responseReady() const = 0;
    virtual void sendResponse() = 0;
    virtual bool exceptionRaised() const = 0;
    QMap<QString, QString> parameterMap() { return mParameterMap; }
    virtual void setParameter( const QString &key, const QString &value ) = 0;
    virtual int removeParameter( const QString &key ) = 0;
    virtual QString parameter( const QString &key ) const = 0;
    QString format() const { return mFormat; }
    QString infoFormat() const { return mInfoFormat; }
    bool headersSent() { return mHeadersSent; }
#ifdef HAVE_SERVER_PYTHON_PLUGINS

    virtual void setPluginFilters( QgsServerFiltersMap pluginFilters ) = 0;
#endif

    virtual QPair<QByteArray, QByteArray> getResponse() = 0;

  protected:
    virtual void sendHeaders() = 0;

    virtual void sendBody() = 0;
#ifdef HAVE_SERVER_PYTHON_PLUGINS
    QgsServerFiltersMap mPluginFilters;
#endif
    QByteArray mBody; // The response payload
    QString mFormat;
    QString mFormatString; //format string as it is passed in the request (with base)
    bool mHeadersSent;
    QString mService;
    QString mInfoFormat;
    QgsMapServiceException* mException; // Stores the exception
    QMap<QString, QString> mParameterMap;
    QMap<QString, QString> mHeaders;
    // TODO: if HAVE_SERVER_PYTHON
    // QByteArray mResponseHeader;
    // QByteArray mResponseBody;
};

#endif