A registry / canonical manager of data providers. More...

#include <qgsproviderregistry.h>

Collaboration diagram for QgsProviderRegistry:

Public Types
typedef std::map< QString, QgsProviderMetadata * >	Providers
	open the given vector data source
Public Member Functions
virtual	~QgsProviderRegistry ()
	Virtual dectructor.
virtual QString	databaseDrivers () const
	return a string containing the available database drivers
virtual QString	directoryDrivers () const
	return a string containing the available directory drivers
virtual QString	fileVectorFilters () const
	return vector file filter string
void *	function (const QString &providerKey, const QString &functionName)
	Get pointer to provider function.
QString	library (const QString &providerKey) const
	Return path for the library of the provider.
const QDir &	libraryDirectory () const
	return library directory where plugins are found
QString	pluginList (bool asHtml=false) const
	Return list of provider plugins found.
virtual QString	protocolDrivers () const
	return a string containing the available protocol drivers
QgsDataProvider *	provider (const QString &providerKey, const QString &dataSource)
	Create an instance of the provider.
QLibrary *	providerLibrary (const QString &providerKey) const
QStringList	providerList () const
	Return list of available providers by their keys.
const QgsProviderMetadata *	providerMetadata (const QString &providerKey) const
	Return metadata of the provider or NULL if not found.
void	registerGuis (QWidget *widget)
QWidget *	selectWidget (const QString &providerKey, QWidget *parent=0, Qt::WFlags fl=0)
void	setLibraryDirectory (const QDir &path)
	Set library directory where to search for plugins.
Static Public Member Functions
static QgsProviderRegistry *	instance (QString pluginPath=QString::null)
	means of accessing canonical single instance
Private Member Functions
	QgsProviderRegistry (QString pluginPath)
	ctor private since instance() creates it
Private Attributes
QString	mDatabaseDrivers
	Available database drivers string for vector databases.
QString	mDirectoryDrivers
	Available directory drivers string for vector databases.
QDir	mLibraryDirectory
	directory in which provider plugins are installed
QString	mProtocolDrivers
	Available protocol drivers string for vector databases.
Providers	mProviders
	associative container of provider metadata handles
QString	mVectorFileFilters
	file filter string for vector files
Static Private Attributes
static QgsProviderRegistry *	_instance = 0
	pointer to canonical Singleton object

Detailed Description

A registry / canonical manager of data providers.

This is a Singleton class that manages data provider access.

Definition at line 40 of file qgsproviderregistry.h.

Member Typedef Documentation

typedef std::map<QString, QgsProviderMetadata*> QgsProviderRegistry::Providers

open the given vector data source

Similar to open(QString const &), except that the user specifies a data provider with which to open the data source instead of using the default data provider that QgsDataManager would figure out to use. This should be useful when (and if) there will exist more than one data provider that can handle a given data source. (E.g., use GDAL to open an SDTS file, or a different data provider that uses sdts++.)

Called by QgsDataManager::open().

Parameters:

name	could be a file, URI
provider	is the key for the dataprovider used to open name

Returns:: NULL if unable to open vector data source

Temporarily always returns false until finished implementing.

Eventually would be nice if could make QgsDataManager smart enough to figure out whether the given name mapped to a vector, raster, or database source. type for data provider metadata associative container

Definition at line 143 of file qgsproviderregistry.h.

Constructor & Destructor Documentation

QgsProviderRegistry::~QgsProviderRegistry ( ) [virtual]

Virtual dectructor.

Definition at line 228 of file qgsproviderregistry.cpp.

QgsProviderRegistry::QgsProviderRegistry ( QString pluginPath ) [private]

ctor private since instance() creates it

Definition at line 61 of file qgsproviderregistry.cpp.

References cast_to_fptr, QgsMessageOutput::createMessageOutput(), fileVectorFilters(), mDatabaseDrivers, mDirectoryDrivers, QgsMessageOutput::MessageText, mLibraryDirectory, mProtocolDrivers, mProviders, mVectorFileFilters, QgsDebugMsg, QgsMessageOutput::setMessage(), QgsMessageOutput::setTitle(), QgsMessageOutput::showMessage(), and tr.

Referenced by instance().

Member Function Documentation

QString QgsProviderRegistry::databaseDrivers ( ) const [virtual]

return a string containing the available database drivers

Note:: this method was added in QGIS 1.1

Definition at line 496 of file qgsproviderregistry.cpp.

References mDatabaseDrivers.

QString QgsProviderRegistry::directoryDrivers ( ) const [virtual]

return a string containing the available directory drivers

Note:: this method was added in QGIS 1.1

Definition at line 501 of file qgsproviderregistry.cpp.

References mDirectoryDrivers.

QString QgsProviderRegistry::fileVectorFilters ( ) const [virtual]

return vector file filter string

Returns a string suitable for a QFileDialog of vector file formats supported by all data providers.

This walks through all data providers appending calls to their fileVectorFilters to a string, which is then returned.

Note:

It'd be nice to eventually be raster/vector neutral.

Definition at line 491 of file qgsproviderregistry.cpp.

References mVectorFileFilters.

Referenced by QgsProjectBadLayerGuiHandler::handleBadLayers(), and QgsProviderRegistry().

void * QgsProviderRegistry::function	(	const QString &	providerKey,
		const QString &	functionName
	)

Get pointer to provider function.

Parameters:

providerKey	identificator of the provider
functionName	name of function

Returns:: pointer to function or NULL on error

Definition at line 435 of file qgsproviderregistry.cpp.

References library(), and QgsDebugMsg.

Referenced by QgsRasterLayer::buildSupportedRasterFileFilter(), QgsRasterDataProvider::create(), QgsRasterLayer::isValidRasterFileName(), and QgsRasterDataProvider::pyramidResamplingMethods().

QgsProviderRegistry * QgsProviderRegistry::instance ( QString pluginPath = QString::null ) [static]

means of accessing canonical single instance

Definition at line 48 of file qgsproviderregistry.cpp.

References _instance, and QgsProviderRegistry().

Referenced by QgsBrowserModel::addRootItems(), QgsRasterFileWriter::buildPyramids(), QgsRasterLayer::buildSupportedRasterFileFilter(), QgsRasterDataProvider::create(), QgsApplication::exitQgis(), QgsVectorLayer::getStyleFromDatabase(), QgsProjectBadLayerGuiHandler::handleBadLayers(), QgsRasterFormatSaveOptionsWidget::helpOptions(), QgsApplication::initQgis(), QgsRasterLayer::isValidRasterFileName(), QgsVectorLayer::listStylesInDatabase(), QgsVectorLayer::loadNamedStyle(), QgsRasterDataProvider::pyramidResamplingMethods(), QgsDirectoryItem::QgsDirectoryItem(), QgsVectorLayerImport::QgsVectorLayerImport(), QgsZipItem::QgsZipItem(), QgsNewVectorLayerDialog::runAndCreateLayer(), QgsRasterChecker::runTest(), QgsVectorLayer::saveStyleToDatabase(), QgsRasterLayer::setDataProvider(), QgsVectorLayer::setDataProvider(), and QgsRasterFormatSaveOptionsWidget::validateOptions().

QString QgsProviderRegistry::library ( const QString & providerKey ) const

Return path for the library of the provider.

Definition at line 257 of file qgsproviderregistry.cpp.

References findMetadata_(), QgsProviderMetadata::library(), and mProviders.

Referenced by function(), provider(), providerLibrary(), and QgsNewVectorLayerDialog::runAndCreateLayer().

QDir const & QgsProviderRegistry::libraryDirectory ( ) const

return library directory where plugins are found

Definition at line 316 of file qgsproviderregistry.cpp.

References mLibraryDirectory.

QString QgsProviderRegistry::pluginList ( bool asHtml = false ) const

Return list of provider plugins found.

Definition at line 270 of file qgsproviderregistry.cpp.

References QgsProviderMetadata::description(), mProviders, and tr.

QString QgsProviderRegistry::protocolDrivers ( ) const [virtual]

return a string containing the available protocol drivers

Note:: this method was added in QGIS 1.1

Definition at line 506 of file qgsproviderregistry.cpp.

References mProtocolDrivers.

QgsDataProvider * QgsProviderRegistry::provider	(	const QString &	providerKey,
		const QString &	dataSource
	)

Create an instance of the provider.

Copied from QgsVectorLayer::setDataProvider TODO: Make it work in the generic environment.

Parameters:

providerKey	identificator of the provider
dataSource	string containing data source for the provider

Returns:: instance of provider or NULL on error

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.

Definition at line 335 of file qgsproviderregistry.cpp.

References cast_to_fptr, library(), QgsMessageLog::logMessage(), QgsDataProvider::name(), QgsDebugMsg, tr, and QgsLogger::warning().

Referenced by QgsRasterFileWriter::buildPyramids(), QgsVectorLayerImport::QgsVectorLayerImport(), registerGuis(), QgsRasterChecker::runTest(), QgsRasterLayer::setDataProvider(), and QgsVectorLayer::setDataProvider().

QLibrary * QgsProviderRegistry::providerLibrary ( const QString & providerKey ) const

Definition at line 457 of file qgsproviderregistry.cpp.

References library(), and QgsDebugMsg.

Referenced by QgsBrowserModel::addRootItems(), QgsVectorLayer::getStyleFromDatabase(), QgsRasterFormatSaveOptionsWidget::helpOptions(), QgsVectorLayer::listStylesInDatabase(), QgsVectorLayer::loadNamedStyle(), QgsDirectoryItem::QgsDirectoryItem(), QgsVectorLayerImport::QgsVectorLayerImport(), QgsZipItem::QgsZipItem(), QgsVectorLayer::saveStyleToDatabase(), and QgsRasterFormatSaveOptionsWidget::validateOptions().

QStringList QgsProviderRegistry::providerList ( ) const

Return list of available providers by their keys.

Definition at line 512 of file qgsproviderregistry.cpp.

References mProviders.

Referenced by QgsBrowserModel::addRootItems(), QgsDirectoryItem::QgsDirectoryItem(), and registerGuis().

const QgsProviderMetadata * QgsProviderRegistry::providerMetadata ( const QString & providerKey ) const

Return metadata of the provider or NULL if not found.

Definition at line 523 of file qgsproviderregistry.cpp.

References findMetadata_(), and mProviders.

void QgsProviderRegistry::registerGuis ( QWidget * widget )

Definition at line 476 of file qgsproviderregistry.cpp.

References cast_to_fptr, provider(), and providerList().

QWidget * QgsProviderRegistry::selectWidget	(	const QString &	providerKey,
		QWidget *	parent = `0`,
		Qt::WFlags	fl = `0`
	)

Definition at line 423 of file qgsproviderregistry.cpp.

References cast_to_fptr.

void QgsProviderRegistry::setLibraryDirectory ( const QDir & path )

Set library directory where to search for plugins.

Definition at line 310 of file qgsproviderregistry.cpp.

References mLibraryDirectory.

Member Data Documentation

QgsProviderRegistry * QgsProviderRegistry::_instance = 0 [static, private]

pointer to canonical Singleton object

Definition at line 151 of file qgsproviderregistry.h.

Referenced by instance().

QString QgsProviderRegistry::mDatabaseDrivers [private]

Available database drivers string for vector databases.

This is a string of form: DriverNameToShow,DriverName;DriverNameToShow,DriverName;...

Definition at line 173 of file qgsproviderregistry.h.

Referenced by databaseDrivers(), and QgsProviderRegistry().

QString QgsProviderRegistry::mDirectoryDrivers [private]

Available directory drivers string for vector databases.

This is a string of form: DriverNameToShow,DriverName;DriverNameToShow,DriverName;...

Definition at line 179 of file qgsproviderregistry.h.

Referenced by directoryDrivers(), and QgsProviderRegistry().

QDir QgsProviderRegistry::mLibraryDirectory [private]

directory in which provider plugins are installed

Definition at line 157 of file qgsproviderregistry.h.

Referenced by libraryDirectory(), QgsProviderRegistry(), and setLibraryDirectory().

QString QgsProviderRegistry::mProtocolDrivers [private]

Available protocol drivers string for vector databases.

This is a string of form: DriverNameToShow,DriverName;DriverNameToShow,DriverName;...

Definition at line 185 of file qgsproviderregistry.h.

Referenced by protocolDrivers(), and QgsProviderRegistry().

Providers QgsProviderRegistry::mProviders [private]

associative container of provider metadata handles

Definition at line 154 of file qgsproviderregistry.h.

Referenced by library(), pluginList(), providerList(), providerMetadata(), and QgsProviderRegistry().

QString QgsProviderRegistry::mVectorFileFilters [private]

file filter string for vector files

Built once when registry is constructed by appending strings returned from iteratively calling vectorFileFilter() for each visited data provider. The alternative would have been to do this each time fileVectorFilters was invoked; instead we only have to build it the one time.

Definition at line 167 of file qgsproviderregistry.h.

Referenced by fileVectorFilters(), and QgsProviderRegistry().

The documentation for this class was generated from the following files:

src/core/qgsproviderregistry.h
src/core/qgsproviderregistry.cpp

Public Types

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation