QGIS Server OGC API endpoint. More...

#include <qgsserverogcapi.h>

Inheritance diagram for QgsServerOgcApi:

Public Types
enum	ContentType { GEOJSON , OPENAPI3 , JSON , SCHEMA_JSON , HTML , XML , FLATGEOBUF }
	Media types used for content negotiation, insert more specific first. More...
enum class	Profile { Unset , Rfc7946 , RelAsLink , RelAsKey , RelAsUri }
	JSON profile. More...
enum	Rel { alternate , describedBy , collection , item , self , service_desc , service_doc , prev , next , license , items , conformance , data , schema , profile }
	Rel link types. More...

Public Member Functions
	QgsServerOgcApi (QgsServerInterface *serverIface, const QString &rootPath, const QString &name, const QString &description=QString(), const QString &version=QString())
	QgsServerOgcApi constructor.
	~QgsServerOgcApi () override
const QString	description () const override
	Returns the API description.
void	executeRequest (const QgsServerApiContext &context) const override
	Executes a request by passing the given context to the API handlers.
const std::vector< std::shared_ptr< QgsServerOgcApiHandler > >	handlers () const
	Returns registered handlers.
const QString	name () const override
	Returns the API name.
template<class T, typename... Args>
void	registerHandler (Args... args)
	Registers an OGC API handler passing Args to the constructor.
void	registerHandler (QgsServerOgcApiHandler *handler)
	Registers an OGC API handler, ownership of the handler is transferred to the API.
const QString	rootPath () const override
	Returns the root path for the API.
const QString	version () const override
	Returns the version of the service.
Public Member Functions inherited from QgsServerApi
	QgsServerApi (QgsServerInterface *serverIface)
	Creates a QgsServerApi object.
virtual	~QgsServerApi ()=default
virtual bool	accept (const QUrl &url) const
	Returns `true` if the given url is handled by the API, default implementation checks for the presence of rootPath inside the url path.
QgsServerInterface *	serverIface () const
	Returns the server interface.

Static Public Member Functions
static const QHash< QgsServerOgcApi::ContentType, QList< QgsServerOgcApi::ContentType > >	contentTypeAliases ()
	Returns contentType specializations (e.g.
static QgsServerOgcApi::ContentType	contentTypeFromExtension (const std::string &extension)
	Returns the Content-Type value corresponding to extension.
static const QMap< QgsServerOgcApi::ContentType, QStringList >	contentTypeMimes ()
	Returns a map of contentType => list of mime types.
static QString	contentTypeToExtension (const QgsServerOgcApi::ContentType &ct)
	Returns the file extension for a ct (Content-Type).
static std::string	contentTypeToStdString (const QgsServerOgcApi::ContentType &ct)
	Returns the string representation of a ct (Content-Type) attribute.
static QString	contentTypeToString (const QgsServerOgcApi::ContentType &ct)
	Returns the string representation of a ct (Content-Type) attribute.
static Q_DECL_DEPRECATED QgsServerOgcApi::ContentType	contenTypeFromExtension (const std::string &extension)
	Returns the Content-Type value corresponding to extension.
static std::string	mimeType (const QgsServerOgcApi::ContentType &contentType)
	Returns the mime-type for the contentType or an empty string if not found.
static QString	profileToString (const QgsServerOgcApi::Profile &profile)
	Returns a string representation of the profile.
static QString	profileToUri (const QgsServerOgcApi::Profile &profile)
	Returns a URI string representation of the profile.
static std::string	relToString (const QgsServerOgcApi::Rel &rel)
	Returns the string representation of rel attribute, to be used or "rel" link attribute in an OGC API response.
static QUrl	sanitizeUrl (const QUrl &url)
	Returns a sanitized url with extra slashes removed and the path URL component that always starts with a slash.

Detailed Description

QGIS Server OGC API endpoint.

QgsServerOgcApi provides the foundation for the new generation of REST-API based OGC services (e.g. WFS3).

This class can be used directly and configured by registering handlers as instances of QgsServerOgcApiHandler.

class Handler1(QgsServerOgcApiHandler):
  """A handler, see QgsServerOgcApiHandler for an example"""
  ...
 
h = Handler1()
api = QgsServerOgcApi(serverInterface(), "/api1", "apione", "A firs API", "1.0")
api.registerHandler(h)
server.serverInterface().serviceRegistry().registerApi(api)

Since: QGIS 3.10

Definition at line 47 of file qgsserverogcapi.h.

Member Enumeration Documentation

◆ ContentType

enum QgsServerOgcApi::ContentType

Media types used for content negotiation, insert more specific first.

Enumerator
GEOJSON
OPENAPI3	"application/openapi+json;version=3.0"
JSON
SCHEMA_JSON	"application/schema+json"
HTML
XML
FLATGEOBUF	"application/flatgeobuf"

Definition at line 81 of file qgsserverogcapi.h.

◆ Profile

enum class QgsServerOgcApi::Profile

strong

JSON profile.

Enumerator
Unset	No profile.
Rfc7946	GeoJSON profile according to RFC7946.
RelAsLink	JSON responses that include links for referenced resources http://www.opengis.net/def/profile/ogc/0/rel-as-link.
RelAsKey	JSON responses that include key for referenced resources http://www.opengis.net/def/profile/ogc/0/rel-as-key.
RelAsUri	JSON responses that include URI for referenced resources http://www.opengis.net/def/profile/ogc/0/rel-as-uri.

Definition at line 95 of file qgsserverogcapi.h.

◆ Rel

enum QgsServerOgcApi::Rel

Rel link types.

Enumerator
alternate	Refers to a substitute for this context.
describedBy	Refers to a resource providing information about the link’s context.
collection	The target IRI points to a resource that is a member of the collection represented by the context IRI.
item	The target IRI points to a resource that is a member of the collection represented by the context IRI.
self	Conveys an identifier for the link’s context.
service_desc	Identifies service description for the context that is primarily intended for consumption by machines.
service_doc	Identifies service documentation for the context that is primarily intended for human consumption.
prev	Indicates that the link’s context is a part of a series, and that the previous in the series is the link targe.
next	Indicates that the link’s context is a part of a series, and that the next in the series is the link target.
license	Refers to a license associated with this context.
items	Refers to a resource that is comprised of members of the collection represented by the link’s context.
conformance	The target IRI points to a resource which represents the collection resource for the context IRI.
data	The target IRI points to resource data.
schema	"http://www.opengis.net/def/rel/ogc/0.0/schema"
profile	"http://www.opengis.net/spec/ogcapi-features-5/0.0/conf/feature-references"

Definition at line 55 of file qgsserverogcapi.h.

Constructor & Destructor Documentation

◆ QgsServerOgcApi()

QgsServerOgcApi::QgsServerOgcApi	(	QgsServerInterface *	serverIface,
		const QString &	rootPath,
		const QString &	name,
		const QString &	description = QString(),
		const QString &	version = QString() )

QgsServerOgcApi constructor.

Parameters

serverIface	pointer to the server interface
rootPath	root path for this API (usually starts with a "/", e.g. "/wfs3")
name	API name
description	API description
version	API version

Definition at line 51 of file qgsserverogcapi.cpp.

◆ ~QgsServerOgcApi()

QgsServerOgcApi::~QgsServerOgcApi ( )

override

Definition at line 59 of file qgsserverogcapi.cpp.

Member Function Documentation

◆ contentTypeAliases()

const QHash< QgsServerOgcApi::ContentType, QList< QgsServerOgcApi::ContentType > > QgsServerOgcApi::contentTypeAliases ( )

static

Returns contentType specializations (e.g.

JSON => [GEOJSON, OPENAPI3], XML => [GML])

Note: not available in Python bindings

Definition at line 124 of file qgsserverogcapi.cpp.

◆ contentTypeFromExtension()

QgsServerOgcApi::ContentType QgsServerOgcApi::contentTypeFromExtension ( const std::string & extension )

static

Returns the Content-Type value corresponding to extension.

Since: QGIS 3.38

Definition at line 226 of file qgsserverogcapi.cpp.

◆ contentTypeMimes()

const QMap< QgsServerOgcApi::ContentType, QStringList > QgsServerOgcApi::contentTypeMimes ( )

static

Returns a map of contentType => list of mime types.

Note: not available in Python bindings

Definition at line 119 of file qgsserverogcapi.cpp.

◆ contentTypeToExtension()

QString QgsServerOgcApi::contentTypeToExtension ( const QgsServerOgcApi::ContentType & ct )

static

Returns the file extension for a ct (Content-Type).

Definition at line 208 of file qgsserverogcapi.cpp.

◆ contentTypeToStdString()

std::string QgsServerOgcApi::contentTypeToStdString ( const QgsServerOgcApi::ContentType & ct )

static

Returns the string representation of a ct (Content-Type) attribute.

Definition at line 202 of file qgsserverogcapi.cpp.

◆ contentTypeToString()

QString QgsServerOgcApi::contentTypeToString ( const QgsServerOgcApi::ContentType & ct )

static

Returns the string representation of a ct (Content-Type) attribute.

Definition at line 195 of file qgsserverogcapi.cpp.

◆ contenTypeFromExtension()

Q_DECL_DEPRECATED QgsServerOgcApi::ContentType QgsServerOgcApi::contenTypeFromExtension ( const std::string & extension )

inlinestatic

Returns the Content-Type value corresponding to extension.

Deprecated: QGIS 3.40. Use contentTypeFromExtension().

Definition at line 201 of file qgsserverogcapi.h.

◆ description()

const QString QgsServerOgcApi::description ( ) const

inlineoverridevirtual

Returns the API description.

Implements QgsServerApi.

Definition at line 121 of file qgsserverogcapi.h.

◆ executeRequest()

void QgsServerOgcApi::executeRequest ( const QgsServerApiContext & context ) const

overridevirtual

Executes a request by passing the given context to the API handlers.

Implements QgsServerApi.

Definition at line 86 of file qgsserverogcapi.cpp.

◆ handlers()

const std::vector< std::shared_ptr< QgsServerOgcApiHandler > > QgsServerOgcApi::handlers ( ) const

Returns registered handlers.

Definition at line 255 of file qgsserverogcapi.cpp.

◆ mimeType()

std::string QgsServerOgcApi::mimeType ( const QgsServerOgcApi::ContentType & contentType )

static

Returns the mime-type for the contentType or an empty string if not found.

Definition at line 246 of file qgsserverogcapi.cpp.

◆ name()

const QString QgsServerOgcApi::name ( ) const

inlineoverridevirtual

Returns the API name.

Implements QgsServerApi.

Definition at line 120 of file qgsserverogcapi.h.

◆ profileToString()

QString QgsServerOgcApi::profileToString ( const QgsServerOgcApi::Profile & profile )

static

Returns a string representation of the profile.

Note: not available in Python bindings

Definition at line 129 of file qgsserverogcapi.cpp.

◆ profileToUri()

QString QgsServerOgcApi::profileToUri ( const QgsServerOgcApi::Profile & profile )

static

Returns a URI string representation of the profile.

Note: not available in Python bindings

Definition at line 156 of file qgsserverogcapi.cpp.

◆ registerHandler() [1/2]

template<class T, typename... Args>

void QgsServerOgcApi::registerHandler ( Args... args )

inline

Registers an OGC API handler passing Args to the constructor.

Note: not available in Python bindings

Definition at line 163 of file qgsserverogcapi.h.

◆ registerHandler() [2/2]

void QgsServerOgcApi::registerHandler ( QgsServerOgcApiHandler * handler )

Registers an OGC API handler, ownership of the handler is transferred to the API.

Definition at line 64 of file qgsserverogcapi.cpp.

◆ relToString()

std::string QgsServerOgcApi::relToString ( const QgsServerOgcApi::Rel & rel )

static

Returns the string representation of rel attribute, to be used or "rel" link attribute in an OGC API response.

Definition at line 183 of file qgsserverogcapi.cpp.

◆ rootPath()

const QString QgsServerOgcApi::rootPath ( ) const

inlineoverridevirtual

Returns the root path for the API.

Implements QgsServerApi.

Definition at line 123 of file qgsserverogcapi.h.

◆ sanitizeUrl()

QUrl QgsServerOgcApi::sanitizeUrl ( const QUrl & url )

static

Returns a sanitized url with extra slashes removed and the path URL component that always starts with a slash.

Definition at line 70 of file qgsserverogcapi.cpp.

◆ version()

const QString QgsServerOgcApi::version ( ) const

inlineoverridevirtual

Returns the version of the service.

Note: the default implementation returns an empty string

Reimplemented from QgsServerApi.

Definition at line 122 of file qgsserverogcapi.h.

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

/build/qgis-4.3.0+git20260713+bf28115e945+99sid/src/server/qgsserverogcapi.h
/build/qgis-4.3.0+git20260713+bf28115e945+99sid/src/server/qgsserverogcapi.cpp

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ ContentType

◆ Profile

◆ Rel

Constructor & Destructor Documentation

◆ QgsServerOgcApi()

◆ ~QgsServerOgcApi()

Member Function Documentation

◆ contentTypeAliases()

◆ contentTypeFromExtension()

◆ contentTypeMimes()

◆ contentTypeToExtension()

◆ contentTypeToStdString()

◆ contentTypeToString()

◆ contenTypeFromExtension()

◆ description()

◆ executeRequest()

◆ handlers()

◆ mimeType()

◆ name()

◆ profileToString()

◆ profileToUri()

◆ registerHandler() [1/2]

◆ registerHandler() [2/2]

◆ relToString()

◆ rootPath()

◆ sanitizeUrl()

◆ version()