qgsproviderregistry.cpp

Go to the documentation of this file.

/***************************************************************************
                    qgsproviderregistry.cpp  -  Singleton class for
                    registering data providers.
                             -------------------
    begin                : Sat Jan 10 2004
    copyright            : (C) 2004 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.                                   *
 *                                                                         *
 ***************************************************************************/
 
#include "qgsproviderregistry.h"
 
#include "providers/gdal/qgsgdalprovider.h"
#include "providers/memory/qgsmemoryprovider.h"
#include "providers/meshmemory/qgsmeshmemorydataprovider.h"
#include "providers/ogr/qgsogrprovider.h"
#include "providers/ogr/qgsogrprovidermetadata.h"
#include "providers/sensorthings/qgssensorthingsprovider.h"
#include "qgis.h"
#include "qgsarcgisvectortileservicedataprovider.h"
#include "qgscesiumtilesdataprovider.h"
#include "qgsdataitemprovider.h"
#include "qgsdataprovider.h"
#include "qgsesrii3sdataprovider.h"
#include "qgslogger.h"
#include "qgsmbtilesvectortiledataprovider.h"
#include "qgsmessagelog.h"
#include "qgsproject.h"
#include "qgsprovidermetadata.h"
#include "qgsprovidersublayerdetails.h"
#include "qgsquantizedmeshdataprovider.h"
#include "qgstiledsceneprovidermetadata.h"
#include "qgsvectortileprovidermetadata.h"
#include "qgsvtpkvectortiledataprovider.h"
#include "qgsxyzvectortiledataprovider.h"
 
#include <QString>
 
using namespace Qt::StringLiterals;
 
#ifdef HAVE_EPT
#include "providers/ept/qgseptprovider.h"
#endif
 
#ifdef HAVE_COPC
#include "providers/copc/qgscopcprovider.h"
#include "providers/vpc/qgsvirtualpointcloudprovider.h"
#endif
 
#include "qgsruntimeprofiler.h"
#include "qgsfileutils.h"
 
#ifdef HAVE_STATIC_PROVIDERS
#include "qgswmsprovider.h"
#include "qgswcsprovider.h"
#include "qgsdelimitedtextprovider.h"
#include "qgsafsprovider.h"
#include "qgsamsprovider.h"
#ifdef HAVE_SPATIALITE
#include "qgsspatialiteprovider.h"
#include "qgswfsprovider.h"
#include "qgswfsprovidermetadata.h"
#include "qgsoapifprovider.h"
#include "qgsvirtuallayerprovider.h"
#endif
#ifdef HAVE_POSTGRESQL
#include "qgspostgresprovider.h"
#endif
#endif
 
#include <QString>
#include <QDir>
#include <QLibrary>
#include <QRegularExpression>
 
static QgsProviderRegistry *sInstance = nullptr;
 
QgsProviderRegistry *QgsProviderRegistry::instance( const QString &pluginPath )
{
  if ( !sInstance )
  {
    static QMutex sMutex;
    const QMutexLocker locker( &sMutex );
    if ( !sInstance )
    {
      sInstance = new QgsProviderRegistry( pluginPath );
    }
  }
  return sInstance;
} // QgsProviderRegistry::instance
 

static QgsProviderMetadata *findMetadata_( const QgsProviderRegistry::Providers &metaData, const QString &providerKey )
{
  // first do case-sensitive match
  const QgsProviderRegistry::Providers::const_iterator i = metaData.find( providerKey );
 
  if ( i != metaData.end() )
  {
    return i->second;
  }
 
  // fallback to case-insensitive match
  for ( auto it = metaData.begin(); it != metaData.end(); ++it )
  {
    if ( providerKey.compare( it->first, Qt::CaseInsensitive ) == 0 )
      return it->second;
  }
 
  return nullptr;
}
 
QgsProviderRegistry::QgsProviderRegistry( const QString &pluginPath )
{
  // At startup, examine the libs in the qgis/lib dir and store those that
  // are a provider shared lib
  // check all libs in the current plugin directory and get name and descriptions
  //TODO figure out how to register and identify data source plugin for a specific
  //TODO layer type
#if 0
  char **argv = qApp->argv();
  QString appDir = argv[0];
  int bin = appDir.findRev( "/bin", -1, false );
  QString baseDir = appDir.left( bin );
  QString mLibraryDirectory = baseDir + "/lib";
#endif
 
  const QgsScopedRuntimeProfile profile( QObject::tr( "Initialize data providers" ) );
  mLibraryDirectory.setPath( pluginPath );
  init();
}

class PdalUnusableUriHandlerInterface : public QgsProviderRegistry::UnusableUriHandlerInterface
{
  public:
    bool matchesUri( const QString &uri ) const override
    {
      const QFileInfo fi( uri );
      if ( fi.suffix().compare( "las"_L1, Qt::CaseInsensitive ) == 0 || fi.suffix().compare( "laz"_L1, Qt::CaseInsensitive ) == 0 )
        return true;
 
      return false;
    }
 
    QgsProviderRegistry::UnusableUriDetails details( const QString &uri ) const override
    {
      QgsProviderRegistry::UnusableUriDetails res
        = QgsProviderRegistry::UnusableUriDetails( uri, QObject::tr( "LAS and LAZ files cannot be opened by this QGIS install." ), QList<Qgis::LayerType>() << Qgis::LayerType::PointCloud );
 
#ifdef Q_OS_WIN
      res.detailedWarning = QObject::tr(
        "The installer used to install this version of QGIS does "
        "not include the PDAL library required for opening LAS and LAZ point clouds. Please "
        "obtain one of the alternative installers from https://qgis.org which has point "
        "cloud support enabled."
      );
#else
      res.detailedWarning = QObject::tr( "This QGIS build does not include the PDAL library dependency required for opening LAS or LAZ point clouds." );
#endif
      return res;
    }
};
 
void QgsProviderRegistry::init()
{
  // add static providers
  {
    const QgsScopedRuntimeProfile profile( QObject::tr( "Create memory layer provider" ) );
    mProviders[QgsMemoryProvider::providerKey()] = new QgsMemoryProviderMetadata();
  }
  {
    const QgsScopedRuntimeProfile profile( QObject::tr( "Create mesh memory layer provider" ) );
    mProviders[QgsMeshMemoryDataProvider::providerKey()] = new QgsMeshMemoryProviderMetadata();
  }
  {
    const QgsScopedRuntimeProfile profile( QObject::tr( "Create GDAL provider" ) );
    mProviders[QgsGdalProvider::providerKey()] = new QgsGdalProviderMetadata();
  }
  {
    const QgsScopedRuntimeProfile profile( QObject::tr( "Create OGR provider" ) );
    mProviders[QgsOgrProvider::providerKey()] = new QgsOgrProviderMetadata();
  }
  {
    const QgsScopedRuntimeProfile profile( QObject::tr( "Create OGC SensorThings API provider" ) );
    mProviders[QgsSensorThingsProvider::providerKey()] = new QgsSensorThingsProviderMetadata();
  }
  {
    const QgsScopedRuntimeProfile profile( QObject::tr( "Create vector tile providers" ) );
    QgsProviderMetadata *vt = new QgsVectorTileProviderMetadata();
    mProviders[vt->key()] = vt;
    vt = new QgsXyzVectorTileDataProviderMetadata();
    mProviders[vt->key()] = vt;
    vt = new QgsVtpkVectorTileDataProviderMetadata();
    mProviders[vt->key()] = vt;
    vt = new QgsArcGisVectorTileServiceDataProviderMetadata();
    mProviders[vt->key()] = vt;
    vt = new QgsMbTilesVectorTileDataProviderMetadata();
    mProviders[vt->key()] = vt;
  }
#ifdef HAVE_EPT
  {
    const QgsScopedRuntimeProfile profile( QObject::tr( "Create EPT point cloud provider" ) );
    QgsProviderMetadata *pc = new QgsEptProviderMetadata();
    mProviders[pc->key()] = pc;
  }
#endif
#ifdef HAVE_COPC
  {
    const QgsScopedRuntimeProfile profile( QObject::tr( "Create COPC point cloud provider" ) );
    QgsProviderMetadata *pc = new QgsCopcProviderMetadata();
    mProviders[pc->key()] = pc;
  }
  {
    const QgsScopedRuntimeProfile profile( QObject::tr( "Create Virtual point cloud provider" ) );
    QgsProviderMetadata *pc = new QgsVirtualPointCloudProviderMetadata();
    mProviders[pc->key()] = pc;
  }
#endif
  registerUnusableUriHandler( new PdalUnusableUriHandlerInterface() );
 
  {
    const QgsScopedRuntimeProfile profile( QObject::tr( "Create tiled scene providers" ) );
    QgsProviderMetadata *metadata = new QgsTiledSceneProviderMetadata();
    mProviders[metadata->key()] = metadata;
 
    metadata = new QgsCesiumTilesProviderMetadata();
    mProviders[metadata->key()] = metadata;
 
    metadata = new QgsQuantizedMeshProviderMetadata();
    mProviders[metadata->key()] = metadata;
 
    metadata = new QgsEsriI3SProviderMetadata();
    mProviders[metadata->key()] = metadata;
  }
 
#ifdef HAVE_STATIC_PROVIDERS
  mProviders[QgsWmsProvider::providerKey()] = new QgsWmsProviderMetadata();
  mProviders[QgsWcsProvider::providerKey()] = new QgsWcsProviderMetadata();
  mProviders[QgsDelimitedTextProvider::providerKey()] = new QgsDelimitedTextProviderMetadata();
  mProviders[QgsAfsProvider::providerKey()] = new QgsAfsProviderMetadata();
  mProviders[QgsAmsProvider::providerKey()] = new QgsAmsProviderMetadata();
#ifdef HAVE_SPATIALITE
  mProviders[QgsSpatiaLiteProvider::providerKey()] = new QgsSpatiaLiteProviderMetadata();
  mProviders[QgsWFSProvider::providerKey()] = new QgsWfsProviderMetadata();
  mProviders[QgsOapifProvider::providerKey()] = new QgsOapifProviderMetadata();
  mProviders[QgsVirtualLayerProvider::providerKey()] = new QgsVirtualLayerProviderMetadata();
#endif
#ifdef HAVE_POSTGRESQL
  mProviders[QgsPostgresProvider::providerKey()] = new QgsPostgresProviderMetadata();
#endif
#endif
 
  // add dynamic providers
#ifdef HAVE_STATIC_PROVIDERS
  QgsDebugMsgLevel( u"Forced only static providers"_s, 2 );
#else
  typedef QgsProviderMetadata *factory_function();
 
  mLibraryDirectory.setSorting( QDir::Name | QDir::IgnoreCase );
  mLibraryDirectory.setFilter( QDir::Files | QDir::NoSymLinks );
 
#if defined( Q_OS_WIN ) || defined( __CYGWIN__ )
  mLibraryDirectory.setNameFilters( QStringList( "*.dll" ) );
#elif defined( ANDROID )
  mLibraryDirectory.setNameFilters( QStringList( "*provider_*.so" ) );
#else
  mLibraryDirectory.setNameFilters( QStringList( u"*.so"_s ) );
#endif
 
  QgsDebugMsgLevel( u"Checking %1 for provider plugins"_s.arg( mLibraryDirectory.path() ), 2 );
 
  if ( mLibraryDirectory.count() == 0 )
  {
    QgsDebugError( u"No dynamic QGIS data provider plugins found in:\n%1\n"_s.arg( mLibraryDirectory.path() ) );
  }
 
  // provider file regex pattern, only files matching the pattern are loaded if the variable is defined
  const QString filePattern = getenv( "QGIS_PROVIDER_FILE" );
  QRegularExpression fileRegexp;
  if ( !filePattern.isEmpty() )
  {
    fileRegexp.setPattern( filePattern );
  }
 
  typedef std::vector<QgsProviderMetadata *> *multiple_factory_function();
 
  const auto constEntryInfoList = mLibraryDirectory.entryInfoList();
  for ( const QFileInfo &fi : constEntryInfoList )
  {
    if ( !filePattern.isEmpty() )
    {
      if ( fi.fileName().indexOf( fileRegexp ) == -1 )
      {
        QgsDebugMsgLevel( "provider " + fi.fileName() + " skipped because doesn't match pattern " + filePattern, 2 );
        continue;
      }
    }
 
    // Always skip authentication methods
    if ( fi.fileName().contains( u"authmethod"_s, Qt::CaseSensitivity::CaseInsensitive ) )
    {
      continue;
    }
 
    const QgsScopedRuntimeProfile profile( QObject::tr( "Load %1" ).arg( fi.fileName() ) );
    QLibrary myLib( fi.filePath() );
    if ( !myLib.load() )
    {
      QgsDebugError( u"Checking %1: ...invalid (lib not loadable): %2"_s.arg( myLib.fileName(), myLib.errorString() ) );
      continue;
    }
 
    bool libraryLoaded { false };
    QFunctionPointer func = myLib.resolve( u"providerMetadataFactory"_s.toLatin1().data() );
    factory_function *function = reinterpret_cast< factory_function * >( cast_to_fptr( func ) );
    if ( function )
    {
      QgsProviderMetadata *meta = function();
      if ( meta )
      {
        if ( findMetadata_( mProviders, meta->key() ) )
        {
          QgsDebugError( u"Checking %1: ...invalid (key %2 already registered)"_s.arg( myLib.fileName() ).arg( meta->key() ) );
          delete meta;
          continue;
        }
        // add this provider to the provider map
        mProviders[meta->key()] = meta;
        libraryLoaded = true;
      }
    }
    else
    {
      QFunctionPointer multi_func = myLib.resolve( u"multipleProviderMetadataFactory"_s.toLatin1().data() );
      multiple_factory_function *multi_function = reinterpret_cast< multiple_factory_function * >( cast_to_fptr( multi_func ) );
      if ( multi_function )
      {
        std::vector<QgsProviderMetadata *> *metadatas = multi_function();
        for ( const auto meta : *metadatas )
        {
          if ( findMetadata_( mProviders, meta->key() ) )
          {
            QgsDebugError( u"Checking %1: ...invalid (key %2 already registered)"_s.arg( myLib.fileName() ).arg( meta->key() ) );
            delete meta;
            continue;
          }
          // add this provider to the provider map
          mProviders[meta->key()] = meta;
          libraryLoaded = true;
        }
        delete metadatas;
      }
    }
 
    if ( !libraryLoaded )
    {
      QgsDebugMsgLevel( u"Checking %1: ...invalid (no providerMetadataFactory method)"_s.arg( myLib.fileName() ), 2 );
    }
  }
 
#endif
  QgsDebugMsgLevel( u"Loaded %1 providers (%2) "_s.arg( mProviders.size() ).arg( providerList().join( ';' ) ), 1 );
 
  // now initialize all providers
  for ( Providers::const_iterator it = mProviders.begin(); it != mProviders.end(); ++it )
  {
    const QString &key = it->first;
 
    const QgsScopedRuntimeProfile profile( QObject::tr( "Initialize %1" ).arg( key ) );
 
    QgsProviderMetadata *meta = it->second;
 
    // call initProvider() - allows provider to register its services to QGIS
    meta->initProvider();
  }
 
  rebuildFilterStrings();
 
  // load database drivers (only OGR)
  mDatabaseDrivers = QgsOgrProviderUtils::databaseDrivers();
 
  // load directory drivers (only OGR)
  mDirectoryDrivers = QgsOgrProviderUtils::directoryDrivers();
 
  // load protocol drivers (only OGR)
  mProtocolDrivers = QgsOgrProviderUtils::protocolDrivers();
}
 
void QgsProviderRegistry::rebuildFilterStrings()
{
  mVectorFileFilters.clear();
  mRasterFileFilters.clear();
  mMeshFileFilters.clear();
  mMeshDatasetFileFilters.clear();
  mPointCloudFileFilters.clear();
  mVectorTileFileFilters.clear();
  mTiledSceneFileFilters.clear();
 
  QStringList pointCloudWildcards;
  QStringList pointCloudFilters;
 
  QStringList vectorTileWildcards;
  QStringList vectorTileFilters;
 
  QStringList tiledSceneWildcards;
  QStringList tiledSceneFilters;
 
  for ( Providers::const_iterator it = mProviders.begin(); it != mProviders.end(); ++it )
  {
    QgsProviderMetadata *meta = it->second;
 
    // now get vector file filters, if any
    const QString fileVectorFilters = meta->filters( Qgis::FileFilterType::Vector );
    if ( !fileVectorFilters.isEmpty() )
    {
      mVectorFileFilters += fileVectorFilters;
      QgsDebugMsgLevel( u"Checking %1: ...loaded OK (%2 file filters)"_s.arg( it->first ).arg( fileVectorFilters.split( ";;" ).count() ), 2 );
    }
 
    // now get raster file filters, if any
    const QString fileRasterFilters = meta->filters( Qgis::FileFilterType::Raster );
    if ( !fileRasterFilters.isEmpty() )
    {
      QgsDebugMsgLevel( "raster filters: " + fileRasterFilters, 2 );
      mRasterFileFilters += fileRasterFilters;
      QgsDebugMsgLevel( u"Checking %1: ...loaded OK (%2 file filters)"_s.arg( it->first ).arg( fileRasterFilters.split( ";;" ).count() ), 2 );
    }
 
    // now get mesh file filters, if any
    const QString fileMeshFilters = meta->filters( Qgis::FileFilterType::Mesh );
    if ( !fileMeshFilters.isEmpty() )
    {
      mMeshFileFilters += fileMeshFilters;
      QgsDebugMsgLevel( u"Checking %1: ...loaded OK (%2 file mesh filters)"_s.arg( it->first ).arg( mMeshFileFilters.split( ";;" ).count() ), 2 );
    }
 
    const QString fileMeshDatasetFilters = meta->filters( Qgis::FileFilterType::MeshDataset );
    if ( !fileMeshDatasetFilters.isEmpty() )
    {
      mMeshDatasetFileFilters += fileMeshDatasetFilters;
      QgsDebugMsgLevel( u"Checking %1: ...loaded OK (%2 file dataset filters)"_s.arg( it->first ).arg( mMeshDatasetFileFilters.split( ";;" ).count() ), 2 );
    }
 
    // now get point cloud file filters, if any
    const QString filePointCloudFilters = meta->filters( Qgis::FileFilterType::PointCloud );
    if ( !filePointCloudFilters.isEmpty() )
    {
      QgsDebugMsgLevel( "point cloud filters: " + filePointCloudFilters, 2 );
 
      const QStringList filters = filePointCloudFilters.split( u";;"_s, Qt::SkipEmptyParts );
      for ( const QString &filter : filters )
      {
        pointCloudFilters.append( filter );
        pointCloudWildcards.append( QgsFileUtils::wildcardsFromFilter( filter ).split( ' ' ) );
      }
    }
 
    // now get vector tile file filters, if any
    const QString fileVectorTileFilters = meta->filters( Qgis::FileFilterType::VectorTile );
    if ( !fileVectorTileFilters.isEmpty() )
    {
      QgsDebugMsgLevel( "vector tile filters: " + fileVectorTileFilters, 2 );
 
      const QStringList filters = fileVectorTileFilters.split( u";;"_s, Qt::SkipEmptyParts );
      for ( const QString &filter : filters )
      {
        vectorTileFilters.append( filter );
        vectorTileWildcards.append( QgsFileUtils::wildcardsFromFilter( filter ).split( ' ' ) );
      }
    }
 
    // now get tiled scene file filters, if any
    const QString fileTiledSceneFilters = meta->filters( Qgis::FileFilterType::TiledScene );
    if ( !fileTiledSceneFilters.isEmpty() )
    {
      QgsDebugMsgLevel( "tiled scene filters: " + fileTiledSceneFilters, 2 );
 
      const QStringList filters = fileTiledSceneFilters.split( u";;"_s, Qt::SkipEmptyParts );
      for ( const QString &filter : filters )
      {
        tiledSceneFilters.append( filter );
        tiledSceneWildcards.append( QgsFileUtils::wildcardsFromFilter( filter ).split( ' ' ) );
      }
    }
  }
 
  if ( !pointCloudFilters.empty() )
  {
    pointCloudFilters.insert( 0, QObject::tr( "All Supported Files" ) + u" (%1)"_s.arg( pointCloudWildcards.join( ' ' ) ) );
    pointCloudFilters.insert( 1, QObject::tr( "All Files" ) + u" (*.*)"_s );
    mPointCloudFileFilters = pointCloudFilters.join( ";;"_L1 );
  }
 
  if ( !vectorTileFilters.empty() )
  {
    vectorTileFilters.insert( 0, QObject::tr( "All Supported Files" ) + u" (%1)"_s.arg( vectorTileWildcards.join( ' ' ) ) );
    vectorTileFilters.insert( 1, QObject::tr( "All Files" ) + u" (*.*)"_s );
    mVectorTileFileFilters = vectorTileFilters.join( ";;"_L1 );
  }
 
  if ( !tiledSceneFilters.empty() )
  {
    tiledSceneFilters.insert( 0, QObject::tr( "All Supported Files" ) + u" (%1)"_s.arg( tiledSceneWildcards.join( ' ' ) ) );
    tiledSceneFilters.insert( 1, QObject::tr( "All Files" ) + u" (*.*)"_s );
    mTiledSceneFileFilters = tiledSceneFilters.join( ";;"_L1 );
  }
}
 
// typedef for the unload dataprovider function
typedef void cleanupProviderFunction_t();
 
void QgsProviderRegistry::clean()
{
  // avoid recreating a new project just to clean it
  if ( QgsProject::sProject )
    QgsProject::instance()->removeAllMapLayers(); // skip-keyword-check
 
  Providers::const_iterator it = mProviders.begin();
 
  while ( it != mProviders.end() )
  {
    QgsDebugMsgLevel( u"cleanup:%1"_s.arg( it->first ), 5 );
    it->second->cleanupProvider();
    delete it->second;
    ++it;
  }
  mProviders.clear();
}
 
bool QgsProviderRegistry::exists()
{
  return static_cast< bool >( sInstance );
}
 
QgsProviderRegistry::~QgsProviderRegistry()
{
  qDeleteAll( mUnusableUriHandlers );
 
  clean();
  if ( sInstance == this )
    sInstance = nullptr;
}
 
QString QgsProviderRegistry::library( QString const &providerKey ) const
{
  QgsProviderMetadata *md = findMetadata_( mProviders, providerKey );
 
  if ( md )
  {
    Q_NOWARN_DEPRECATED_PUSH
    return md->library();
    Q_NOWARN_DEPRECATED_POP
  }
 
  return QString();
}
 
QString QgsProviderRegistry::pluginList( bool asHTML ) const
{
  Providers::const_iterator it = mProviders.begin();
 
  if ( mProviders.empty() )
    return QObject::tr( "No data provider plugins are available. No vector layers can be loaded" );
 
  QString list;
 
  if ( asHTML )
    list += "<ol>"_L1;
 
  while ( it != mProviders.end() )
  {
    if ( asHTML )
      list += "<li>"_L1;
 
    list += it->second->description();
 
    if ( asHTML )
      list += "<br></li>"_L1;
    else
      list += '\n';
 
    ++it;
  }
 
  if ( asHTML )
    list += "</ol>"_L1;
 
  return list;
}
 
void QgsProviderRegistry::setLibraryDirectory( QDir const &path )
{
  mLibraryDirectory = path;
  clean();
  init();
}
 
QDir QgsProviderRegistry::libraryDirectory() const
{
  return mLibraryDirectory;
}
 
 
/* Copied from QgsVectorLayer::setDataProvider
 *  TODO: Make it work in the generic environment
 *
 *  TODO: Is this class really the best place to put a data provider loader?
 *        It seems more sensible to provide the code in one place rather than
 *        in qgsrasterlayer, qgsvectorlayer, serversourceselect, etc.
 */
QgsDataProvider *QgsProviderRegistry::createProvider( QString const &providerKey, QString const &dataSource, const QgsDataProvider::ProviderOptions &options, Qgis::DataProviderReadFlags flags )
{
  // XXX should I check for and possibly delete any pre-existing providers?
  // XXX How often will that scenario occur?
 
  QgsProviderMetadata *metadata = findMetadata_( mProviders, providerKey );
  if ( !metadata )
  {
    QgsMessageLog::logMessage( QObject::tr( "Invalid data provider %1" ).arg( providerKey ) );
    return nullptr;
  }
 
  return metadata->createProvider( dataSource, options, flags );
}
 
Qgis::DataItemProviderCapabilities QgsProviderRegistry::providerCapabilities( const QString &providerKey ) const
{
  const QList< QgsDataItemProvider * > itemProviders = dataItemProviders( providerKey );
  Qgis::DataItemProviderCapabilities ret;
  //concat flags
  for ( const QgsDataItemProvider *itemProvider : itemProviders )
  {
    ret |= itemProvider->capabilities();
  }
  return ret;
}
 
QVariantMap QgsProviderRegistry::decodeUri( const QString &providerKey, const QString &uri )
{
  QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey );
  if ( meta )
    return meta->decodeUri( uri );
  else
    return QVariantMap();
}
 
QString QgsProviderRegistry::encodeUri( const QString &providerKey, const QVariantMap &parts )
{
  QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey );
  if ( meta )
    return meta->encodeUri( parts );
  else
    return QString();
}
 
QString QgsProviderRegistry::absoluteToRelativeUri( const QString &providerKey, const QString &uri, const QgsReadWriteContext &context ) const
{
  QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey );
  if ( meta )
    return meta->absoluteToRelativeUri( uri, context );
  else
    return uri;
}
 
QString QgsProviderRegistry::relativeToAbsoluteUri( const QString &providerKey, const QString &uri, const QgsReadWriteContext &context ) const
{
  QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey );
  if ( meta )
    return meta->relativeToAbsoluteUri( uri, context );
  else
    return uri;
}
 
Qgis::VectorExportResult QgsProviderRegistry::createEmptyLayer(
  const QString &providerKey,
  const QString &uri,
  const QgsFields &fields,
  Qgis::WkbType wkbType,
  const QgsCoordinateReferenceSystem &srs,
  bool overwrite,
  QMap<int, int> &oldToNewAttrIdxMap,
  QString &errorMessage,
  const QMap<QString, QVariant> *options,
  QString &createdLayerName
)
{
  QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey );
  if ( meta )
    return meta->createEmptyLayer( uri, fields, wkbType, srs, overwrite, oldToNewAttrIdxMap, errorMessage, options, createdLayerName );
  else
  {
    errorMessage = QObject::tr( "Unable to load %1 provider" ).arg( providerKey );
    return Qgis::VectorExportResult::ErrorInvalidProvider;
  }
}
 
QgsRasterDataProvider *QgsProviderRegistry::createRasterDataProvider(
  const QString &providerKey,
  const QString &uri,
  const QString &format,
  int nBands,
  Qgis::DataType type,
  int width,
  int height,
  double *geoTransform,
  const QgsCoordinateReferenceSystem &crs,
  const QStringList &creationOptions
)
{
  QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey );
  if ( meta )
    return meta->createRasterDataProvider( uri, format, nBands, type, width, height, geoTransform, crs, creationOptions );
  else
    return nullptr;
}
 
QList<QPair<QString, QString> > QgsProviderRegistry::pyramidResamplingMethods( const QString &providerKey )
{
  QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey );
  if ( meta )
    return meta->pyramidResamplingMethods();
  else
    return QList<QPair<QString, QString> >();
}
 
QList<QgsDataItemProvider *> QgsProviderRegistry::dataItemProviders( const QString &providerKey ) const
{
  QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey );
  if ( meta )
    return meta->dataItemProviders();
  else
    return QList<QgsDataItemProvider *>();
}
 
int QgsProviderRegistry::listStyles( const QString &providerKey, const QString &uri, QStringList &ids, QStringList &names, QStringList &descriptions, QString &errCause )
{
  int res = -1;
  QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey );
  if ( meta )
  {
    res = meta->listStyles( uri, ids, names, descriptions, errCause );
  }
  else
  {
    errCause = QObject::tr( "Unable to load %1 provider" ).arg( providerKey );
  }
  return res;
}
 
bool QgsProviderRegistry::styleExists( const QString &providerKey, const QString &uri, const QString &styleId, QString &errorCause )
{
  errorCause.clear();
 
  if ( QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey ) )
  {
    return meta->styleExists( uri, styleId, errorCause );
  }
  else
  {
    errorCause = QObject::tr( "Unable to load %1 provider" ).arg( providerKey );
    return false;
  }
}
 
QString QgsProviderRegistry::getStyleById( const QString &providerKey, const QString &uri, const QString &styleId, QString &errCause )
{
  QString ret;
  QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey );
  if ( meta )
  {
    ret = meta->getStyleById( uri, styleId, errCause );
  }
  else
  {
    errCause = QObject::tr( "Unable to load %1 provider" ).arg( providerKey );
  }
  return ret;
}
 
bool QgsProviderRegistry::deleteStyleById( const QString &providerKey, const QString &uri, const QString &styleId, QString &errCause )
{
  const bool ret( false );
 
  QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey );
  if ( meta )
    return meta->deleteStyleById( uri, styleId, errCause );
  else
  {
    errCause = QObject::tr( "Unable to load %1 provider" ).arg( providerKey );
  }
  return ret;
}
 
bool QgsProviderRegistry::saveStyle(
  const QString &providerKey,
  const QString &uri,
  const QString &qmlStyle,
  const QString &sldStyle,
  const QString &styleName,
  const QString &styleDescription,
  const QString &uiFileContent,
  bool useAsDefault,
  QString &errCause
)
{
  bool ret( false );
  QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey );
  if ( meta )
    ret = meta->saveStyle( uri, qmlStyle, sldStyle, styleName, styleDescription, uiFileContent, useAsDefault, errCause );
  else
  {
    errCause = QObject::tr( "Unable to load %1 provider" ).arg( providerKey );
  }
  return ret;
}
 
QString QgsProviderRegistry::loadStyle( const QString &providerKey, const QString &uri, QString &errCause )
{
  QString ret;
  QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey );
  if ( meta )
    ret = meta->loadStyle( uri, errCause );
  else
  {
    errCause = QObject::tr( "Unable to load %1 provider" ).arg( providerKey );
  }
  return ret;
}
 
QString QgsProviderRegistry::loadStoredStyle( const QString &providerKey, const QString &uri, QString &styleName, QString &errCause )
{
  QString ret;
  QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey );
  if ( meta )
    ret = meta->loadStoredStyle( uri, styleName, errCause );
  else
  {
    errCause = QObject::tr( "Unable to load %1 provider" ).arg( providerKey );
  }
  return ret;
}
 
bool QgsProviderRegistry::saveLayerMetadata( const QString &providerKey, const QString &uri, const QgsLayerMetadata &metadata, QString &errorMessage )
{
  errorMessage.clear();
  if ( QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey ) )
    return meta->saveLayerMetadata( uri, metadata, errorMessage );
  else
  {
    throw QgsNotSupportedException( QObject::tr( "Unable to load %1 provider" ).arg( providerKey ) );
  }
}
 
bool QgsProviderRegistry::createDb( const QString &providerKey, const QString &dbPath, QString &errCause )
{
  QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey );
  if ( meta )
    return meta->createDb( dbPath, errCause );
  else
  {
    errCause = u"Resolving createDb(...) failed"_s;
    return false;
  }
}
 
QgsTransaction *QgsProviderRegistry::createTransaction( const QString &providerKey, const QString &connString )
{
  QgsProviderMetadata *meta = findMetadata_( mProviders, providerKey );
  if ( meta )
    return meta->createTransaction( connString );
  else
    return nullptr;
}
 
QWidget *QgsProviderRegistry::createSelectionWidget( const QString &providerKey, QWidget *parent, Qt::WindowFlags fl, QgsProviderRegistry::WidgetMode widgetMode )
{
  Q_UNUSED( providerKey );
  Q_UNUSED( parent );
  Q_UNUSED( fl );
  Q_UNUSED( widgetMode );
  QgsDebugError( "deprecated call - use QgsGui::sourceSelectProviderRegistry()->createDataSourceWidget() instead" );
  return nullptr;
}
 
QFunctionPointer QgsProviderRegistry::function( QString const &providerKey, QString const &functionName ) const
{
  Q_NOWARN_DEPRECATED_PUSH
  const QString lib = library( providerKey );
  Q_NOWARN_DEPRECATED_POP
  if ( lib.isEmpty() )
    return nullptr;
 
  QLibrary myLib( lib );
 
  QgsDebugMsgLevel( "Library name is " + myLib.fileName(), 2 );
 
  if ( myLib.load() )
  {
    return myLib.resolve( functionName.toLatin1().data() );
  }
  else
  {
    QgsDebugError( "Cannot load library: " + myLib.errorString() );
    return nullptr;
  }
}
 
QLibrary *QgsProviderRegistry::createProviderLibrary( QString const &providerKey ) const
{
  Q_NOWARN_DEPRECATED_PUSH
  const QString lib = library( providerKey );
  Q_NOWARN_DEPRECATED_POP
  if ( lib.isEmpty() )
    return nullptr;
 
  auto myLib = std::make_unique<QLibrary>( lib );
 
  QgsDebugMsgLevel( "Library name is " + myLib->fileName(), 2 );
 
  if ( myLib->load() )
    return myLib.release();
 
  QgsDebugError( "Cannot load library: " + myLib->errorString() );
 
  return nullptr;
}
 
void QgsProviderRegistry::registerGuis( QWidget * )
{
  QgsDebugError( "deprecated - use QgsGui::providerGuiRegistry() instead." );
}
 
bool QgsProviderRegistry::registerProvider( QgsProviderMetadata *providerMetadata )
{
  if ( providerMetadata )
  {
    if ( mProviders.find( providerMetadata->key() ) == mProviders.end() )
    {
      mProviders[providerMetadata->key()] = providerMetadata;
 
      rebuildFilterStrings();
      return true;
    }
    else
    {
      QgsDebugMsgLevel( u"Cannot register provider metadata: a provider with the same key (%1) was already registered!"_s.arg( providerMetadata->key() ), 2 );
    }
  }
  else
  {
    QgsDebugMsgLevel( u"Trying to register a null metadata provider!"_s, 2 );
  }
  return false;
}
 
QString QgsProviderRegistry::fileVectorFilters() const
{
  return mVectorFileFilters;
}
 
QString QgsProviderRegistry::fileRasterFilters() const
{
  return mRasterFileFilters;
}
 
QString QgsProviderRegistry::fileMeshFilters() const
{
  return mMeshFileFilters;
}
 
QString QgsProviderRegistry::fileMeshDatasetFilters() const
{
  return mMeshDatasetFileFilters;
}
 
QString QgsProviderRegistry::filePointCloudFilters() const
{
  return mPointCloudFileFilters;
}
 
QString QgsProviderRegistry::fileVectorTileFilters() const
{
  return mVectorTileFileFilters;
}
 
QString QgsProviderRegistry::fileTiledSceneFilters() const
{
  return mTiledSceneFileFilters;
}
 
QString QgsProviderRegistry::databaseDrivers() const
{
  return mDatabaseDrivers;
}
 
QString QgsProviderRegistry::directoryDrivers() const
{
  return mDirectoryDrivers;
}
 
QString QgsProviderRegistry::protocolDrivers() const
{
  return mProtocolDrivers;
}
 
QStringList QgsProviderRegistry::providerList() const
{
  QStringList lst;
  for ( Providers::const_iterator it = mProviders.begin(); it != mProviders.end(); ++it )
  {
    lst.append( it->first );
  }
  return lst;
}
 
QgsProviderMetadata *QgsProviderRegistry::providerMetadata( const QString &providerKey ) const
{
  return findMetadata_( mProviders, providerKey );
}
 
QSet<QString> QgsProviderRegistry::providersForLayerType( Qgis::LayerType type ) const
{
  QSet<QString> lst;
  for ( Providers::const_iterator it = mProviders.begin(); it != mProviders.end(); ++it )
  {
    if ( it->second->supportedLayerTypes().contains( type ) )
      lst.insert( it->first );
  }
  return lst;
}
 
QList<QgsProviderRegistry::ProviderCandidateDetails> QgsProviderRegistry::preferredProvidersForUri( const QString &uri ) const
{
  QList< QgsProviderRegistry::ProviderCandidateDetails > res;
  int maxPriority = 0;
  for ( auto it = mProviders.begin(); it != mProviders.end(); ++it )
  {
    if ( !( it->second->capabilities() & QgsProviderMetadata::PriorityForUri ) )
      continue;
 
    const int thisProviderPriority = it->second->priorityForUri( uri );
    if ( thisProviderPriority == 0 )
      continue;
 
    if ( thisProviderPriority > maxPriority )
    {
      res.clear();
      maxPriority = thisProviderPriority;
    }
    if ( thisProviderPriority == maxPriority )
    {
      res.append( ProviderCandidateDetails( it->second, it->second->validLayerTypesForUri( uri ) ) );
    }
  }
  return res;
}
 
bool QgsProviderRegistry::registerUnusableUriHandler( QgsProviderRegistry::UnusableUriHandlerInterface *handler )
{
  mUnusableUriHandlers << handler;
  return true;
}
 
bool QgsProviderRegistry::handleUnusableUri( const QString &uri, UnusableUriDetails &details ) const
{
  for ( const QgsProviderRegistry::UnusableUriHandlerInterface *handler : mUnusableUriHandlers )
  {
    if ( handler->matchesUri( uri ) )
    {
      details = handler->details( uri );
      return true;
    }
  }
  return false;
}
 
bool QgsProviderRegistry::shouldDeferUriForOtherProviders( const QString &uri, const QString &providerKey ) const
{
  const QList< ProviderCandidateDetails > providers = preferredProvidersForUri( uri );
  if ( providers.empty() )
    return false;
 
  for ( const ProviderCandidateDetails &provider : providers )
  {
    if ( provider.metadata()->key() == providerKey )
      return false;
  }
  return true;
}
 
bool QgsProviderRegistry::uriIsBlocklisted( const QString &uri ) const
{
  for ( auto it = mProviders.begin(); it != mProviders.end(); ++it )
  {
    if ( it->second->uriIsBlocklisted( uri ) )
      return true;
  }
  return false;
}
 
QList<QgsProviderSublayerDetails> QgsProviderRegistry::querySublayers( const QString &uri, Qgis::SublayerQueryFlags flags, QgsFeedback *feedback ) const
{
  // never query sublayers for blocklisted uris
  if ( uriIsBlocklisted( uri ) )
    return {};
 
  QList<QgsProviderSublayerDetails> res;
  for ( auto it = mProviders.begin(); it != mProviders.end(); ++it )
  {
    // if we should defer this uri for other providers, do so
    if ( shouldDeferUriForOtherProviders( uri, it->first ) )
      continue;
 
    res.append( it->second->querySublayers( uri, flags, feedback ) );
    if ( feedback && feedback->isCanceled() )
      break;
  }
  return res;
}