Class: QgsServerRequest¶
Defines requests passed to QgsService classes.
Class Hierarchy¶
Subclasses¶
Defines a request with data. |
|
Defines fcgi requests. |
- class qgis.server.QgsServerRequest[source]¶
Bases:
object- __init__()
- __init__(url: str | None, method: QgsServerRequest.Method = QgsServerRequest.GetMethod, headers: Dict[str | None, str | None] = {})
Constructor
- Parameters:
url (Optional[str]) – the url string
method (QgsServerRequest.Method = QgsServerRequest.GetMethod) – the request method
headers (Dict[Optional[str], Optional[str]] = {})
- __init__(url: QUrl, method: QgsServerRequest.Method = QgsServerRequest.GetMethod, headers: Dict[str | None, str | None] = {})
Constructor
- Parameters:
url (QUrl) – QUrl
method (QgsServerRequest.Method = QgsServerRequest.GetMethod) – the request method
headers (Dict[Optional[str], Optional[str]] = {})
- __init__(other: QgsServerRequest)
- Parameters:
other (QgsServerRequest)
- ACCEPT = 10¶
- AUTHORIZATION = 12¶
- DeleteMethod = 4¶
- FORWARDED = 1¶
- GetMethod = 2¶
- HOST = 0¶
- HeadMethod = 0¶
- class Method¶
Bases:
int
- PatchMethod = 5¶
- PostMethod = 3¶
- PutMethod = 1¶
- class RequestHeader¶
Bases:
int
- USER_AGENT = 11¶
- X_FORWARDED_FOR = 2¶
- X_FORWARDED_HOST = 3¶
- X_FORWARDED_PROTO = 4¶
- X_QGIS_SERVICE_URL = 5¶
- X_QGIS_WCS_SERVICE_URL = 8¶
- X_QGIS_WFS_SERVICE_URL = 7¶
- X_QGIS_WMS_SERVICE_URL = 6¶
- X_QGIS_WMTS_SERVICE_URL = 9¶
- baseUrl(self) QUrl[source]¶
Returns the base URL of QGIS server
E.g. if we call QGIS server with
http://example.com/folder?REQUEST=WMS&...the base URL will behttp://example.com/folderAdded in version 3.20.
- Return type:
QUrl
- virtual data(self) QByteArray[source]¶
Returns post/put data Check for QByteArray.isNull() to check if data is available.
- Return type:
QByteArray
- virtual header(self, name: str | None) str[source]¶
Returns the header value
- Parameters:
name (Optional[str]) – of the header
- Returns:
the header value or an empty string
header(self, headerEnum: QgsServerRequest.RequestHeader) -> str Returns the header value
- Parameters:
headerEnum – of the header
- Return type:
str
- Returns:
the header value or an empty string
- headers(self) Dict[str, str]¶
Returns the header map
- Return type:
Dict[str, str]
- Returns:
the headers map
- method(self) QgsServerRequest.Method[source]¶
Returns the request method.
- Return type:
- static methodToString(method: QgsServerRequest.Method) str[source]¶
Returns a string representation of an HTTP request
method.Added in version 3.12.
- Parameters:
method (QgsServerRequest.Method)
- Return type:
str
- originalUrl(self) QUrl[source]¶
Returns the request url as seen by the web server, by default this is equal to the url seen by QGIS server
See also
url()for the rewritten urlAdded in version 3.6.
- Return type:
QUrl
- parameter(self, key: str | None, defaultValue: str | None = '') str[source]¶
Gets a parameter value
- Parameters:
key (Optional[str])
defaultValue (Optional[str] = '')
- Return type:
str
- parameters(self) Dict[str, str][source]¶
Returns a map of query parameters with keys converted to uppercase
- Return type:
Dict[str, str]
- queryParameter(self, name: str | None, defaultValue: str | None = '') str[source]¶
Returns the query string parameter with the given
namefrom the request URL, adefaultValuecan be specified.Added in version 3.10.
- Parameters:
name (Optional[str])
defaultValue (Optional[str] = '')
- Return type:
str
- removeHeader(self, name: str | None)[source]¶
Remove an header
- Parameters:
name (Optional[str])
Added in version 3.20.
- virtual removeParameter(self, key: str | None)[source]¶
Remove a parameter
- Parameters:
key (Optional[str])
- serverParameters(self) QgsServerParameters[source]¶
Returns parameters
- Return type:
- setBaseUrl(self, url: QUrl)[source]¶
Set the base URL of QGIS server
Added in version 3.20.
- Parameters:
url (QUrl)
- setHeader(self, name: str | None, value: str | None)[source]¶
Set an header
- Parameters:
name (Optional[str])
value (Optional[str])
- setMethod(self, method: QgsServerRequest.Method)[source]¶
Set the request method
- Parameters:
method (QgsServerRequest.Method)
- setOriginalUrl(self, url: QUrl)[source]¶
Set the request original
url(the request url as seen by the web server)See also
setUrl()for the rewritten urlAdded in version 3.6.
- Parameters:
url (QUrl)
- virtual setParameter(self, key: str | None, value: str | None)[source]¶
Set a parameter
- Parameters:
key (Optional[str])
value (Optional[str])
- url(self) QUrl[source]¶
Returns the request URL as seen by QGIS server.
See also
originalUrl()for the unrewritten URL as seen by the web server, by default the two are equal- Return type:
QUrl