mirror of
				https://github.com/qgis/QGIS.git
				synced 2025-10-31 00:06:02 -04:00 
			
		
		
		
	Handle the messy initial / by making sure the paths matches are evaluated against a sanitized URL that always starts with a /
		
			
				
	
	
		
			109 lines
		
	
	
		
			3.3 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			109 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.pl again   *
 | |
|  ************************************************************************/
 | |
| 
 | |
| 
 | |
| 
 | |
| class QgsServerApiContext
 | |
| {
 | |
| %Docstring(signature="appended")
 | |
| The :py:class:`QgsServerApiContext` class encapsulates the resources for a particular client
 | |
| request: the request and response objects, the project (might be NULL) 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.pl again   *
 | |
|  ************************************************************************/
 |