Class: QgsServerRequest

QgsServerRequest Class defining request interface passed to services QgsService.executeRequest() method

Class Hierarchy

Inheritance diagram of qgis.server.QgsServerRequest

Subclasses

QgsBufferServerRequest

Class defining request with data

QgsFcgiServerRequest

Class defining fcgi request

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

data(self) QByteArray[source]

Returns post/put data Check for QByteArray.isNull() to check if data is available.

Return type:

QByteArray

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]
Return type:

QgsServerRequest.Method

Returns:

the request 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.

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)

setParameter(self, key: str | None, value: str | None)[source]

Set a parameter

Parameters:
  • key (Optional[str])

  • value (Optional[str])

setUrl(self, url: QUrl)[source]

Set the request url

Parameters:

url (QUrl)

url(self) QUrl[source]
Return type:

QUrl

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