Class: QgsRequestHandler

class qgis.server.QgsRequestHandler

Bases: sip.wrapper

This class is an interface hiding the details of reading input and writing output from/to a wms request mechanism.

QgsRequestHandler(request: QgsServerRequest, response: QgsServerResponse) Constructor

Note that QgsServerRequest and QgsServerResponse MUST live in the same scope

QgsRequestHandler(QgsRequestHandler)

Methods

appendBody

Sets the info format string such as "text/xml"

body

Returns the response body data

clear

Clears the response body and headers

clearBody

Clear response buffer

data

Returns the request POST data (can be null)

exceptionRaised

Pointer to last raised exception

format

Returns the requested format string

headersSent

Returns True if the HTTP headers were already sent to the client

parameter

Returns a request parameter

parameterMap

Returns the parsed parameters as a key-value pair, to modify a parameter setParameter( const QString &key, const QString &value) and removeParameter(const QString &key) must be used

path

Returns the path component of the request URL

removeParameter

Remove a request parameter

removeRequestHeader

Remove an HTTP request header

removeResponseHeader

Remove an HTTP response header

requestHeader

Retrieve request header value

requestHeaders

Returns the the Request headers

responseHeader

Retrieve response header value

responseHeaders

Returns the response headers

sendResponse

Send out HTTP headers and flush output buffer

setParameter

Sets a request parameter

setRequestHeader

Sets an HTTP request header

setResponseHeader

Sets an HTTP response header

setServiceException

Allow plugins to return a QgsMapServiceException

setStatusCode

Sets response http status code

statusCode

Returns the response http status code

url

Returns the request url

appendBody(self, body: QByteArray | bytes | bytearray)

Sets the info format string such as “text/xml”

Parameters:

body (Union[QByteArray) –

body(self) QByteArray

Returns the response body data

Return type:

QByteArray

clear(self)

Clears the response body and headers

clearBody(self)

Clear response buffer

data(self) QByteArray

Returns the request POST data (can be null)

Return type:

QByteArray

exceptionRaised(self) bool

Pointer to last raised exception

Return type:

bool

format(self) str

Returns the requested format string

Return type:

str

headersSent(self) bool

Returns True if the HTTP headers were already sent to the client

Return type:

bool

parameter(self, key: str) str

Returns a request parameter

Parameters:

key (str) –

Return type:

str

parameterMap(self) Dict[str, str]

Returns the parsed parameters as a key-value pair, to modify a parameter setParameter( const QString &key, const QString &value) and removeParameter(const QString &key) must be used

Return type:

Dict[str, str]

path(self) str

Returns the path component of the request URL

New in version 3.16.

Return type:

str

removeParameter(self, key: str)

Remove a request parameter

Parameters:

key (str) –

removeRequestHeader(self, name: str)

Remove an HTTP request header

Parameters:

name (str) –

removeResponseHeader(self, name: str)

Remove an HTTP response header

Parameters:

name (str) –

requestHeader(self, name: str) str

Retrieve request header value

Parameters:

name (str) –

Return type:

str

requestHeaders(self) Dict[str, str]

Returns the the Request headers

Return type:

Dict[str, str]

responseHeader(self, name: str) str

Retrieve response header value

Parameters:

name (str) –

Return type:

str

responseHeaders(self) Dict[str, str]

Returns the response headers

Return type:

Dict[str, str]

sendResponse(self)

Send out HTTP headers and flush output buffer

This method is intended only for streaming partial content.

setParameter(self, key: str, value: str)

Sets a request parameter

Parameters:
  • key (str) –

  • value (str) –

setRequestHeader(self, name: str, value: str)

Sets an HTTP request header

Parameters:
  • name (str) –

  • value (str) –

setResponseHeader(self, name: str, value: str)

Sets an HTTP response header

Parameters:
  • name (str) –

  • value (str) –

setServiceException(self, ex: QgsServerException)

Allow plugins to return a QgsMapServiceException

Parameters:

ex (QgsServerException) –

setStatusCode(self, code: int)

Sets response http status code

Parameters:

code (int) –

statusCode(self) int

Returns the response http status code

Return type:

int

url(self) str

Returns the request url

Return type:

str