QgsServiceRegistry Class Reference

QgsServiceRegistry Class defining the registry manager for QGIS server services. More...

#include <qgsserviceregistry.h>

Public Member Functions
	QgsServiceRegistry ()=default
	Constructor. More...
	~QgsServiceRegistry ()
	Destructor. More...
QgsServerApi *	apiForRequest (const QgsServerRequest &request) const
	Searches the API register for an API matching the request and returns a (possibly NULL) pointer to it. More...
void	cleanUp ()
	Clean up registered service and unregister modules. More...
QgsServerApi *	getApi (const QString &name, const QString &version=QString())
	Retrieves an API from its name. More...
QgsService *	getService (const QString &name, const QString &version=QString())
	Retrieve a service from its name. More...
void	init (const QString &nativeModulepath, QgsServerInterface *serverIface=nullptr)
	Initialize registry, load modules and auto register services. More...
bool	registerApi (QgsServerApi *api)
	Registers the QgsServerApi api. More...
void	registerService (QgsService *service)
	Register a service by its name and version. More...
int	unregisterApi (const QString &name, const QString &version=QString())
	Unregisters API from its name and version. More...
int	unregisterService (const QString &name, const QString &version=QString())
	Unregister service from its name and version. More...

Detailed Description

QgsServiceRegistry Class defining the registry manager for QGIS server services.

This class provides methods for registering and retrieving services.

IMPORTANT: The registry hold ownership of registered services and will call 'delete' on cleanup

Since

QGIS 3.0

Definition at line 49 of file qgsserviceregistry.h.

Constructor & Destructor Documentation

QgsServiceRegistry()

QgsServiceRegistry::QgsServiceRegistry ( )

default

Constructor.

~QgsServiceRegistry()

QgsServiceRegistry::~QgsServiceRegistry

(

)

Destructor.

Definition at line 84 of file qgsserviceregistry.cpp.

Member Function Documentation

apiForRequest()

QgsServerApi * QgsServiceRegistry::apiForRequest

(

const QgsServerRequest &

request

)

const

Searches the API register for an API matching the request and returns a (possibly NULL) pointer to it.

Since

QGIS 3.10

Definition at line 227 of file qgsserviceregistry.cpp.

cleanUp()

void QgsServiceRegistry::cleanUp

(

)

Clean up registered service and unregister modules.

Definition at line 340 of file qgsserviceregistry.cpp.

getApi()

QgsServerApi * QgsServiceRegistry::getApi	(	const QString &	name,
		const QString &	version = QString()
	)

Retrieves an API from its name.

If the version is not provided the higher version of the service is returned

Parameters

name	the name of the API
version	the version string (optional)

Returns

QgsServerApi

Since

QGIS 3.10

Definition at line 242 of file qgsserviceregistry.cpp.

getService()

QgsService * QgsServiceRegistry::getService	(	const QString &	name,
		const QString &	version = QString()
	)

Retrieve a service from its name.

Parameters

name	the name of the service
version	the version string (optional)

Returns

QgsService

If the version is not provided the higher version of the service is returned

Definition at line 89 of file qgsserviceregistry.cpp.

init()

void QgsServiceRegistry::init	(	const QString &	nativeModulepath,
		QgsServerInterface *	serverIface = nullptr
	)

Initialize registry, load modules and auto register services.

Parameters

serverIface	the server interface
nativeModulepath	the native module path

Definition at line 335 of file qgsserviceregistry.cpp.

registerApi()

bool QgsServiceRegistry::registerApi

(

QgsServerApi *

api

)

Registers the QgsServerApi api.

The registry takes ownership of services and will call 'delete' on cleanup

Since

QGIS 3.10

Definition at line 349 of file qgsserviceregistry.cpp.

registerService()

void QgsServiceRegistry::registerService

(

QgsService *

service

)

Register a service by its name and version.

This method is intended to be called by modules for registering services. A module may register multiple services.

The registry takes ownership of services and will call 'delete' on cleanup

Parameters

service

a QgsService to be registered

Definition at line 118 of file qgsserviceregistry.cpp.

unregisterApi()

int QgsServiceRegistry::unregisterApi	(	const QString &	name,
		const QString &	version = QString()
	)

Unregisters API from its name and version.

Parameters

name	the name of the service
version	(optional) the specific version to unload

Returns

the number of APIs unregistered

If the version is not specified then all versions from the specified API are unloaded

Since

QGIS 3.10

Definition at line 162 of file qgsserviceregistry.cpp.

unregisterService()

int QgsServiceRegistry::unregisterService	(	const QString &	name,
		const QString &	version = QString()
	)

Unregister service from its name and version.

Parameters

name	the name of the service
version	(optional) the specific version to unload

Returns

the number of services unregistered

If the version is not specified then all versions from the specified service are unloaded

Definition at line 271 of file qgsserviceregistry.cpp.

---

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

• /build/qgis-3.16.0+99unstable/src/server/qgsserviceregistry.h
• /build/qgis-3.16.0+99unstable/src/server/qgsserviceregistry.cpp