qgsdataprovider.h

Go to the documentation of this file.

/***************************************************************************
                qgsdataprovider.h - DataProvider Interface class
                     --------------------------------------
    Date                 : 09-Sep-2003
    Copyright            : (C) 2003 by Gary E.Sherman
    email                : sherman at mrcc.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 QQGSDATAPROVIDER_H
#define QQGSDATAPROVIDER_H
 
#include "qgis_core.h"
#include <QDateTime>
#include <QObject>
#include <QString>
#include <QStringList>
#include <QMutex>
 
#include "qgsdatasourceuri.h"
#include "qgscoordinatetransformcontext.h"
#include "qgslayermetadata.h"
#include "qgserror.h"
 
class QgsRectangle;
class QgsCoordinateReferenceSystem;
class QgsDataProviderTemporalCapabilities;
class QgsDataProviderElevationProperties;
 
 
class CORE_EXPORT QgsDataProvider : public QObject
{
 
#ifdef SIP_RUN
    SIP_CONVERT_TO_SUBCLASS_CODE
    if ( qobject_cast<QgsVectorDataProvider *>( sipCpp ) )
    {
      sipType = sipType_QgsVectorDataProvider;
    }
    else if ( qobject_cast<QgsRasterDataProvider *>( sipCpp ) )
    {
      sipType = sipType_QgsRasterDataProvider;
    }
    else if ( qobject_cast<QgsMeshDataProvider *>( sipCpp ) )
    {
      sipType = sipType_QgsMeshDataProvider;
    }
    else if ( qobject_cast<QgsPointCloudDataProvider *>( sipCpp ) )
    {
      sipType = sipType_QgsPointCloudDataProvider;
    }
    else
    {
      sipType = 0;
    }
    SIP_END
#endif
    Q_OBJECT
 
  public:
 
    // TODO QGIS 4: (re)move DataCapability as this enum is really meant for data items rather than data providers
 
    enum DataCapability
    {
      NoDataCapabilities  = 0,
      File                = 1,
      Dir                 = 1 << 1,
      Database            = 1 << 2,
      Net                 = 1 << 3  // Internet source
    };
    Q_DECLARE_FLAGS( DataCapabilities, DataCapability )
 
    
    enum ProviderProperty
    {
      EvaluateDefaultValues,       
      CustomData   = 3000          
    };
 
 
    struct ProviderOptions
    {
 
      QgsCoordinateTransformContext transformContext;
 
    };
 
    enum ReadFlag
    {
      FlagTrustDataSource = 1 << 0, 
      SkipFeatureCount = 1 << 1, 
      FlagLoadDefaultStyle = 1 << 2, 
      SkipGetExtent = 1 << 3, 
      SkipFullScan = 1 << 4, 
      ForceReadOnly = 1 << 5, 
      SkipCredentialsRequest =  1 << 6, 
    };
    Q_DECLARE_FLAGS( ReadFlags, ReadFlag )
 
    
    QgsDataProvider( const QString &uri = QString(),
                     const QgsDataProvider::ProviderOptions &providerOptions = QgsDataProvider::ProviderOptions(),
                     QgsDataProvider::ReadFlags flags = QgsDataProvider::ReadFlags() );
 
    virtual QgsCoordinateReferenceSystem crs() const = 0;
 
    virtual void setDataSourceUri( const QString &uri )
    {
      mDataSourceURI = uri;
    }
 
    virtual QString dataSourceUri( bool expandAuthConfig = false ) const
    {
      if ( expandAuthConfig && mDataSourceURI.contains( QLatin1String( "authcfg" ) ) )
      {
        const QgsDataSourceUri uri( mDataSourceURI );
        return uri.uri( expandAuthConfig );
      }
      else
      {
        return mDataSourceURI;
      }
    }
 
    virtual QString dataComment() const { return QString(); };
 
 
    void setUri( const QgsDataSourceUri &uri )
    {
      mDataSourceURI = uri.uri( true );
    }
 
    QgsDataSourceUri uri() const
    {
      return QgsDataSourceUri( mDataSourceURI );
    }
 
    virtual Qgis::DataProviderFlags flags() const;
 
    virtual QgsDataProviderTemporalCapabilities *temporalCapabilities();
 
    virtual const QgsDataProviderTemporalCapabilities *temporalCapabilities() const SIP_SKIP;
 
    virtual QgsDataProviderElevationProperties *elevationProperties();
 
    virtual const QgsDataProviderElevationProperties *elevationProperties() const SIP_SKIP;
 
    virtual QgsRectangle extent() const = 0;
 
 
    virtual bool isValid() const = 0;
 
    virtual void updateExtents()
    {
      // NOP by default
    }
 
 
    virtual bool setSubsetString( const QString &subset, bool updateFeatureCount = true )
    {
      // NOP by default
      Q_UNUSED( subset )
      Q_UNUSED( updateFeatureCount )
      return false;
    }
 
 
    virtual bool supportsSubsetString() const { return false; }
 
    virtual QString subsetString() const
    {
      return QString();
    }
 
 
    virtual QStringList subLayers() const
    {
      return QStringList();  // Empty
    }
 
    virtual QStringList subLayerStyles() const
    {
      return QStringList();  // Empty
    }
 
 
    virtual uint subLayerCount() const
    {
      return 0;
    }
 
 
    virtual void setLayerOrder( const QStringList &layers )
    {
      //prevent unused var warnings
      if ( layers.count() < 1 )
      {
        return;
      }
      // NOOP
    }
 
 
    virtual void setSubLayerVisibility( const QString &name, bool vis )
    {
      //prevent unused var warnings
      if ( name.isEmpty() || !vis )
      {
        return;
      }
      // NOOP
    }
 
 
    virtual QString name() const = 0;
 
 
    virtual QString description() const = 0;
 
 
    virtual QString fileVectorFilters() const
    {
      return QString();
    }
 
 
    virtual QString fileRasterFilters() const
    {
      return QString();
    }
 
    // TODO QGIS 4 -> Make `reloadData()` non virtual. This should be implemented in `reloadProviderData()`.
 
    virtual void reloadData();
 
    virtual QDateTime timestamp() const { return mTimestamp; }
 
    virtual QDateTime dataTimestamp() const { return QDateTime(); }
 
    virtual QgsError error() const { return mError; }
 
    virtual void invalidateConnections( const QString &connection ) { Q_UNUSED( connection ) }
 
    virtual bool enterUpdateMode() { return true; }
 
    virtual bool leaveUpdateMode() { return true; }
 
    void setProviderProperty( ProviderProperty property, const QVariant &value );
 
    void setProviderProperty( int property, const QVariant &value ); // SIP_SKIP
 
    QVariant providerProperty( ProviderProperty property, const QVariant &defaultValue = QVariant() ) const;
 
    QVariant providerProperty( int property, const QVariant &defaultValue ) const; // SIP_SKIP
 
    virtual void setListening( bool isListening );
 
#ifndef SIP_RUN
 
    struct PreviewContext
    {
      double lastRenderingTimeMs = -1;
 
      double maxRenderingTimeMs = MAXIMUM_LAYER_PREVIEW_TIME_MS;
    };
#endif
 
    virtual bool renderInPreview( const QgsDataProvider::PreviewContext &context ); // SIP_SKIP
 
    virtual QgsLayerMetadata layerMetadata() const { return QgsLayerMetadata(); }
 
    virtual bool writeLayerMetadata( const QgsLayerMetadata &metadata ) { Q_UNUSED( metadata ) return false; }
 
    QgsCoordinateTransformContext transformContext() const SIP_SKIP;
 
    virtual void setTransformContext( const QgsCoordinateTransformContext &transformContext ) SIP_SKIP;
 
    static QString sublayerSeparator();
 
  signals:
 
    void fullExtentCalculated();
 
    void dataChanged();
 
    void notify( const QString &msg );
 
 
  protected:
 
    QDateTime mTimestamp;
 
    QgsError mError;
 
    void appendError( const QgsErrorMessage &message ) { mError.append( message ); }
 
    void setError( const QgsError &error ) { mError = error;}
 
    QgsDataProvider::ReadFlags mReadFlags = QgsDataProvider::ReadFlags();
 
  private:
 
    QString mDataSourceURI;
 
    QgsDataProvider::ProviderOptions mOptions;
 
    QMap< int, QVariant > mProviderProperties;
 
    mutable QMutex mOptionsMutex;
 
    virtual void reloadProviderData() {}
 
    friend class TestQgsProject;
};
 
Q_DECLARE_OPERATORS_FOR_FLAGS( QgsDataProvider::ReadFlags )
 
#endif