QGIS/python/server/auto_generated/qgsserverapicontext.sip.in
Nyall Dawson 3f6b490218 Sipify
2025-04-02 11:11:10 +10:00

110 lines
3.3 KiB
Plaintext

/************************************************************************
* This file has been generated automatically from *
* *
* src/server/qgsserverapicontext.h *
* *
* Do not edit manually ! Edit header and run scripts/sipify.py again *
************************************************************************/
class QgsServerApiContext
{
%Docstring(signature="appended")
Encapsulates the resources for a particular client request.
This includes the request and response objects, the project (might be
``None``) and the server interface, the API root path that matched the
request is also added.
:py:class:`QgsServerApiContext` is lightweight copyable object meant to
be passed along the request handlers chain.
.. versionadded:: 3.10
%End
%TypeHeaderCode
#include "qgsserverapicontext.h"
%End
public:
QgsServerApiContext( const QString &apiRootPath, const QgsServerRequest *request, QgsServerResponse *response, const QgsProject *project, QgsServerInterface *serverInterface );
%Docstring
QgsServerApiContext constructor
:param apiRootPath: is the API root path, this information is used by
the handlers to build the href links to the
resources and to the HTML templates.
:param request: the incoming request
:param response: the response
:param project: the project (might be NULL)
:param serverInterface: the server interface
%End
const QgsServerRequest *request() const;
%Docstring
Returns the server request object
%End
QgsServerResponse *response() const;
%Docstring
Returns the server response object
%End
const QgsProject *project() const;
%Docstring
Returns the (possibly NULL) project
.. seealso:: :py:func:`setProject`
%End
void setProject( const QgsProject *project );
%Docstring
Sets the project to ``project``
.. seealso:: :py:func:`project`
%End
QgsServerInterface *serverInterface() const;
%Docstring
Returns the server interface
%End
const QString matchedPath() const;
%Docstring
Returns the initial part of the incoming request URL path that matches
the API root path. If there is no match returns an empty string (it
should never happen).
I.e. for an API with root path "/wfs3" and an incoming request
"https://www.qgis.org/services/wfs3/collections" this method will return
"/resources/wfs3"
%End
QString apiRootPath() const;
%Docstring
Returns the API root path
%End
void setRequest( const QgsServerRequest *request );
%Docstring
Sets context request to ``request``
%End
QString handlerPath() const;
%Docstring
Returns the handler component of the URL path, i.e. the part of the path
that comes after the API path.
.. versionadded:: 3.22
%End
};
/************************************************************************
* This file has been generated automatically from *
* *
* src/server/qgsserverapicontext.h *
* *
* Do not edit manually ! Edit header and run scripts/sipify.py again *
************************************************************************/