qgsmaplayerserverproperties.h

Go to the documentation of this file.

/***************************************************************************
                             qgsmaplayerserverproperties.h
                             ------------------
  begin                : June 21, 2021
  copyright            : (C) 2021 by Etienne Trimaille
  email                : etrimaille 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 QGSMAPLAYERSERVERPROPERTIES_H
#define QGSMAPLAYERSERVERPROPERTIES_H
 
#include "qgis_sip.h"
#include "qgis_core.h"
#include <QMap>
#include <QString>
#include <QMetaType>
#include <QVariant>
 
class QgsMapLayer;
 
class QDomNode;
class QDomDocument;
 
class CORE_EXPORT QgsServerMetadataUrlProperties
{
    Q_GADGET
 
  public:
 
    struct CORE_EXPORT MetadataUrl
    {
 
      MetadataUrl( const QString &url = QString(), const QString &type = QString(), const QString &format = QString() )
        : url( url )
        , type( type )
        , format( format )
      {}
 
      QString url;
 
      QString type;
 
      QString format;
 
      // TODO c++20 - replace with = default
 
      bool operator==( const QgsServerMetadataUrlProperties::MetadataUrl &other ) const;
    };
 
    virtual ~QgsServerMetadataUrlProperties() = default;
 
    QList<QgsServerMetadataUrlProperties::MetadataUrl> metadataUrls() const { return mMetadataUrls; };
 
    void setMetadataUrls( const QList<QgsServerMetadataUrlProperties::MetadataUrl> &metaUrls ) { mMetadataUrls = metaUrls; };
 
    void addMetadataUrl( const QgsServerMetadataUrlProperties::MetadataUrl &metaUrl ) { mMetadataUrls << metaUrl; };
 
    virtual const QgsMapLayer *layer() const = 0;
 
    // TODO c++20 - replace with = default
 
    bool operator==( const QgsServerMetadataUrlProperties &other ) const;
    bool operator!=( const QgsServerMetadataUrlProperties &other ) const;
 
  protected:
    void writeXml( QDomNode &layerNode, QDomDocument &document ) const SIP_SKIP;
 
    void readXml( const QDomNode &layerNode ) SIP_SKIP;
 
    void copyTo( QgsServerMetadataUrlProperties *properties ) const SIP_SKIP;
 
    void reset() SIP_SKIP;
 
  private:
    QList<MetadataUrl> mMetadataUrls;
 
};
 
 
class CORE_EXPORT QgsServerWmsDimensionProperties
{
    Q_GADGET
 
  public:
 
    enum PredefinedWmsDimensionName
    {
      TIME,
      DATE,
      ELEVATION
    };
    Q_ENUM( PredefinedWmsDimensionName )
 
    
    struct CORE_EXPORT WmsDimensionInfo
    {
 
      enum DefaultDisplay
      {
        AllValues = 0, 
        MinValue = 1, 
        MaxValue = 2, 
        ReferenceValue = 3, 
      };
 
      explicit WmsDimensionInfo( const QString &dimName,
                                 const QString &dimFieldName,
                                 const QString &dimEndFieldName = QString(),
                                 const QString &dimUnits = QString(),
                                 const QString &dimUnitSymbol = QString(),
                                 const int &dimDefaultDisplayType = QgsServerWmsDimensionProperties::WmsDimensionInfo::AllValues,
                                 const QVariant &dimReferenceValue = QVariant() )
        : name( dimName )
        , fieldName( dimFieldName )
        , endFieldName( dimEndFieldName )
        , units( dimUnits )
        , unitSymbol( dimUnitSymbol )
        , defaultDisplayType( dimDefaultDisplayType )
        , referenceValue( dimReferenceValue )
      {}
 
      bool operator==( const WmsDimensionInfo &other ) const;
      bool operator!=( const WmsDimensionInfo &other ) const;
 
      QString name;
      QString fieldName;
      QString endFieldName;
      QString units;
      QString unitSymbol;
      int defaultDisplayType;
      QVariant referenceValue;
    };
 
    virtual ~QgsServerWmsDimensionProperties() = default;
 
    // TODO c++20 - replace with = default
 
    bool operator==( const QgsServerWmsDimensionProperties &other ) const;
    bool operator!=( const QgsServerWmsDimensionProperties &other ) const;
 
    static QMap<int, QString> wmsDimensionDefaultDisplayLabels();
 
    bool addWmsDimension( const QgsServerWmsDimensionProperties::WmsDimensionInfo &wmsDimInfo );
 
    bool removeWmsDimension( const QString &wmsDimName );
 
    void setWmsDimensions( const QList<QgsServerWmsDimensionProperties::WmsDimensionInfo> &dimensions );
 
    const QList<QgsServerWmsDimensionProperties::WmsDimensionInfo> wmsDimensions() const;
 
    virtual const QgsMapLayer *layer() const = 0;
 
  protected:
 
    void writeXml( QDomNode &layer_node, QDomDocument &document ) const SIP_SKIP;
 
    void readXml( const QDomNode &layer_node ) SIP_SKIP;
 
    void copyTo( QgsServerWmsDimensionProperties *properties ) const SIP_SKIP;
 
    void reset() SIP_SKIP;
 
  private:                       // Private attributes
    QList<WmsDimensionInfo> mWmsDimensions;
};
 
 
class CORE_EXPORT QgsMapLayerServerProperties: public QgsServerMetadataUrlProperties, public QgsServerWmsDimensionProperties
{
    Q_GADGET
 
  public:
 
    QgsMapLayerServerProperties( QgsMapLayer *layer = nullptr );
 
    // TODO c++20 - replace with = default
 
    bool operator==( const QgsMapLayerServerProperties &other ) const;
    bool operator!=( const QgsMapLayerServerProperties &other ) const;
 
    void copyTo( QgsMapLayerServerProperties *properties ) const;
 
    void writeXml( QDomNode &layer_node, QDomDocument &document ) const; // cppcheck-suppress duplInheritedMember
 
    void readXml( const QDomNode &layer_node ); // cppcheck-suppress duplInheritedMember
 
    void reset(); // cppcheck-suppress duplInheritedMember
 
    void setShortName( const QString &name ) { mShortName = name; }
 
    QString shortName() const { return mShortName; }
 
    void setTitle( const QString &title ) { mTitle = title; }
 
    void setWfsTitle( const QString &title ) { mWfsTitle = title; }
 
    QString title() const { return mTitle; }
 
    QString wfsTitle() const { return mWfsTitle.isEmpty() ? mTitle : mWfsTitle; }
 
    void setAbstract( const QString &abstract ) { mAbstract = abstract; }
 
    QString abstract() const { return mAbstract; }
 
    void setKeywordList( const QString &keywords ) { mKeywordList = keywords; }
 
    QString keywordList() const { return mKeywordList; }
 
    void setDataUrl( const QString &dataUrl ) { mDataUrl = dataUrl; }
 
    QString dataUrl() const { return mDataUrl; }
 
    void setDataUrlFormat( const QString &dataUrlFormat ) { mDataUrlFormat = dataUrlFormat; }
 
    QString dataUrlFormat() const { return mDataUrlFormat; }
 
    void setAttribution( const QString &attrib ) { mAttribution = attrib; }
 
    QString attribution() const { return mAttribution; }
 
    void setAttributionUrl( const QString &url ) { mAttributionUrl = url; }
 
    QString attributionUrl() const { return mAttributionUrl; }
 
    void setLegendUrl( const QString &legendUrl ) { mLegendUrl = legendUrl; }
 
    QString legendUrl() const { return mLegendUrl; }
 
    void setLegendUrlFormat( const QString &legendUrlFormat ) { mLegendUrlFormat = legendUrlFormat; }
 
    QString legendUrlFormat() const { return mLegendUrlFormat; }
 
    const QgsMapLayer *layer() const override { return mLayer; };
 
  private:
    QgsMapLayer *mLayer = nullptr;
 
    QString mShortName;
    QString mTitle;
    QString mWfsTitle;  // optional WFS title
 
    QString mAttribution;
    QString mAttributionUrl;
 
    QString mDataUrl;
    QString mDataUrlFormat;
 
    QString mAbstract;
    QString mKeywordList;
 
    QString mLegendUrl;
    QString mLegendUrlFormat;
};
 
// XXX How to make a proper SIP type alias ?
//using QgsVectorLayerServerProperties = QgsMapLayerServerProperties;
 
class CORE_EXPORT QgsVectorLayerServerProperties: public QgsMapLayerServerProperties
{
    Q_GADGET
};
 
#endif // QGSMAPLAYERSERVERPROPERTIES_H