qgsserverparameters.h

Go to the documentation of this file.

/***************************************************************************
                              qgsserverparameters.h
                              ------------------
  begin                : Jun 27, 2018
  copyright            : (C) 2018 by Paul Blottiere
  email                : paul dot blottiere at oslandia 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 QGSSERVERPARAMETERS_H
#define QGSSERVERPARAMETERS_H
 
#include "qgis_server.h"
#include "qgsgeometry.h"
 
#include <QColor>
#include <QMap>
#include <QMetaEnum>
#include <QUrlQuery>

class SERVER_EXPORT QgsServerParameterDefinition
{
  public:

    QgsServerParameterDefinition( const QMetaType::Type type = QMetaType::Type::QString, const QVariant defaultValue = QVariant( "" ) );
 

    Q_DECL_DEPRECATED QgsServerParameterDefinition( const QVariant::Type type, const QVariant defaultValue = QVariant( "" ) ) SIP_DEPRECATED;
 
    virtual ~QgsServerParameterDefinition() = default;

    QString typeName() const;

    virtual bool isValid() const;

    QString toString( bool defaultValue = false ) const;

    QStringList toStringList( char delimiter = ',', bool skipEmptyParts = true ) const;

    QList<int> toIntList( bool &ok, char delimiter = ',', bool skipEmptyParts = true ) const;

    QList<double> toDoubleList( bool &ok, char delimiter = ',', bool skipEmptyParts = true ) const;

    QList<QColor> toColorList( bool &ok, char delimiter = ',', bool skipEmptyParts = true ) const;

    QList<QgsGeometry> toGeomList( bool &ok, char delimiter = ',', bool skipEmptyParts = true ) const;

    QStringList toOgcFilterList() const;

    QStringList toExpressionList() const;

    QgsRectangle toRectangle( bool &ok ) const;

    int toInt( bool &ok ) const;

    double toDouble( bool &ok ) const;

    bool toBool() const;

    QColor toColor( bool &ok ) const;

    QUrl toUrl( bool &ok ) const;

    QString loadUrl( bool &ok ) const;

    static void raiseError( const QString &msg );
 
    QMetaType::Type mType;
    QVariant mValue;
    QVariant mDefaultValue;
};

class SERVER_EXPORT QgsServerParameter : public QgsServerParameterDefinition
{
    Q_GADGET
 
  public:
    enum Name
    {
      UNKNOWN,
      SERVICE,
      VERSION_SERVICE, // conflict with #define VERSION
      REQUEST,
      MAP,
      FILE_NAME
    };
    Q_ENUM( Name )
 
    
    QgsServerParameter( const QgsServerParameter::Name name = QgsServerParameter::UNKNOWN, const QMetaType::Type type = QMetaType::Type::QString, const QVariant defaultValue = QVariant( "" ) );

    Q_DECL_DEPRECATED QgsServerParameter( const QgsServerParameter::Name name, const QVariant::Type type, const QVariant defaultValue = QVariant( "" ) ) SIP_DEPRECATED;

    void raiseError() const;

    static QString name( const QgsServerParameter::Name name );

    static QgsServerParameter::Name name( const QString &name );
 
    QgsServerParameter::Name mName;
};

class SERVER_EXPORT QgsServerParameters
{
    Q_GADGET
 
  public:

    QgsServerParameters();

    QgsServerParameters( const QUrlQuery &query );
 
    virtual ~QgsServerParameters() = default;

    void load( const QUrlQuery &query );

    void clear();

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

    void remove( const QString &key );

    void remove( QgsServerParameter::Name name );

    QString value( const QString &key ) const;

    QUrlQuery urlQuery() const;

    QMap<QString, QString> toMap() const;

    QString service() const;

    virtual QString request() const;

    QString map() const;

    QString fileName() const;

    virtual QString version() const;
 
  protected:

    virtual bool loadParameter( const QString &name, const QString &value );
 
    QMap<QString, QString> mUnmanagedParameters;
 
  private:
    void save( const QgsServerParameter &parameter );
    QVariant value( QgsServerParameter::Name name ) const;
 
    QMap<QgsServerParameter::Name, QgsServerParameter> mParameters;
    QUrlQuery mUrlQuery;
};
 
#endif