Class: QgsServerRequest

Defines requests passed to QgsService classes.

Class Hierarchy

Inheritance diagram of qgis.server.QgsServerRequest

Subclasses

QgsBufferServerRequest

Defines a request with data.

QgsFcgiServerRequest

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 be http://example.com/folder

Added 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:

QgsServerRequest.Method

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 url

Added 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 name from the request URL, a defaultValue can 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:

QgsServerParameters

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 url

Added 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])

virtual setUrl(self, url: QUrl)[source]

Set the request url

Parameters:

url (QUrl)

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