QGIS API Documentation  3.24.2-Tisler (13c1a02865)
Public Member Functions | List of all members
QgsRequestHandler Class Reference

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

#include <qgsrequesthandler.h>

Public Member Functions

 QgsRequestHandler (QgsServerRequest &request, QgsServerResponse &response)
 Constructor. More...
 
void appendBody (const QByteArray &body)
 Sets the info format string such as "text/xml". More...
 
QByteArray body () const
 Returns the response body data. More...
 
void clear ()
 Clears the response body and headers. More...
 
void clearBody ()
 Clear response buffer. More...
 
QByteArray data () const
 Returns the request POST data (can be null) More...
 
bool exceptionRaised () const
 Pointer to last raised exception. More...
 
QString format () const
 Returns the requested format string. More...
 
bool headersSent () const
 Returns true if the HTTP headers were already sent to the client. More...
 
QString parameter (const QString &key) const
 Returns a request parameter. More...
 
QMap< QString, QString > parameterMap () const
 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. More...
 
void parseInput ()
 Parses the input and creates a request neutral Parameter/Value map. More...
 
QString path () const
 Returns the path component of the request URL. More...
 
void removeParameter (const QString &key)
 Remove a request parameter. More...
 
void removeRequestHeader (const QString &name)
 Remove an HTTP request header. More...
 
void removeResponseHeader (const QString &name)
 Remove an HTTP response header. More...
 
QString requestHeader (const QString &name) const
 Retrieve request header value. More...
 
QMap< QString, QString > requestHeaders () const
 Returns the the Request headers. More...
 
QString responseHeader (const QString &name) const
 Retrieve response header value. More...
 
QMap< QString, QString > responseHeaders () const
 Returns the response headers. More...
 
void sendResponse ()
 Send out HTTP headers and flush output buffer. More...
 
void setParameter (const QString &key, const QString &value)
 Sets a request parameter. More...
 
void setRequestHeader (const QString &name, const QString &value)
 Sets an HTTP request header. More...
 
void setResponseHeader (const QString &name, const QString &value)
 Sets an HTTP response header. More...
 
void setServiceException (const QgsServerException &ex)
 Allow plugins to return a QgsMapServiceException. More...
 
void setStatusCode (int code)
 Sets response http status code. More...
 
int statusCode () const
 Returns the response http status code. More...
 
QString url () const
 Returns the request url. More...
 

Detailed Description

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

Definition at line 38 of file qgsrequesthandler.h.

Constructor & Destructor Documentation

◆ QgsRequestHandler()

QgsRequestHandler::QgsRequestHandler ( QgsServerRequest request,
QgsServerResponse response 
)
explicit

Constructor.

Note that QgsServerRequest and QgsServerResponse MUST live in the same scope

Definition at line 30 of file qgsrequesthandler.cpp.

Member Function Documentation

◆ appendBody()

void QgsRequestHandler::appendBody ( const QByteArray &  body)

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

Definition at line 99 of file qgsrequesthandler.cpp.

◆ body()

QByteArray QgsRequestHandler::body ( ) const

Returns the response body data.

Definition at line 109 of file qgsrequesthandler.cpp.

◆ clear()

void QgsRequestHandler::clear ( )

Clears the response body and headers.

Definition at line 52 of file qgsrequesthandler.cpp.

◆ clearBody()

void QgsRequestHandler::clearBody ( )

Clear response buffer.

Definition at line 104 of file qgsrequesthandler.cpp.

◆ data()

QByteArray QgsRequestHandler::data ( ) const

Returns the request POST data (can be null)

Definition at line 114 of file qgsrequesthandler.cpp.

◆ exceptionRaised()

bool QgsRequestHandler::exceptionRaised ( ) const

Pointer to last raised exception.

Definition at line 42 of file qgsrequesthandler.cpp.

◆ format()

QString QgsRequestHandler::format ( ) const
inline

Returns the requested format string.

Definition at line 140 of file qgsrequesthandler.h.

◆ headersSent()

bool QgsRequestHandler::headersSent ( ) const

Returns true if the HTTP headers were already sent to the client.

Definition at line 94 of file qgsrequesthandler.cpp.

◆ parameter()

QString QgsRequestHandler::parameter ( const QString &  key) const

Returns a request parameter.

Definition at line 281 of file qgsrequesthandler.cpp.

◆ parameterMap()

QMap< QString, QString > QgsRequestHandler::parameterMap ( ) const

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.

Definition at line 37 of file qgsrequesthandler.cpp.

◆ parseInput()

void QgsRequestHandler::parseInput ( )

Parses the input and creates a request neutral Parameter/Value map.

Note
not available in Python bindings

Definition at line 193 of file qgsrequesthandler.cpp.

◆ path()

QString QgsRequestHandler::path ( ) const

Returns the path component of the request URL.

Since
QGIS 3.16

Definition at line 124 of file qgsrequesthandler.cpp.

◆ removeParameter()

void QgsRequestHandler::removeParameter ( const QString &  key)

Remove a request parameter.

Definition at line 286 of file qgsrequesthandler.cpp.

◆ removeRequestHeader()

void QgsRequestHandler::removeRequestHeader ( const QString &  name)

Remove an HTTP request header.

Definition at line 77 of file qgsrequesthandler.cpp.

◆ removeResponseHeader()

void QgsRequestHandler::removeResponseHeader ( const QString &  name)

Remove an HTTP response header.

Definition at line 57 of file qgsrequesthandler.cpp.

◆ requestHeader()

QString QgsRequestHandler::requestHeader ( const QString &  name) const

Retrieve request header value.

Definition at line 82 of file qgsrequesthandler.cpp.

◆ requestHeaders()

QMap< QString, QString > QgsRequestHandler::requestHeaders ( ) const

Returns the the Request headers.

Definition at line 88 of file qgsrequesthandler.cpp.

◆ responseHeader()

QString QgsRequestHandler::responseHeader ( const QString &  name) const

Retrieve response header value.

Definition at line 62 of file qgsrequesthandler.cpp.

◆ responseHeaders()

QMap< QString, QString > QgsRequestHandler::responseHeaders ( ) const

Returns the response headers.

Definition at line 67 of file qgsrequesthandler.cpp.

◆ sendResponse()

void QgsRequestHandler::sendResponse ( )

Send out HTTP headers and flush output buffer.

This method is intended only for streaming partial content.

Definition at line 139 of file qgsrequesthandler.cpp.

◆ setParameter()

void QgsRequestHandler::setParameter ( const QString &  key,
const QString &  value 
)

Sets a request parameter.

Definition at line 265 of file qgsrequesthandler.cpp.

◆ setRequestHeader()

void QgsRequestHandler::setRequestHeader ( const QString &  name,
const QString &  value 
)

Sets an HTTP request header.

Definition at line 72 of file qgsrequesthandler.cpp.

◆ setResponseHeader()

void QgsRequestHandler::setResponseHeader ( const QString &  name,
const QString &  value 
)

Sets an HTTP response header.

Definition at line 47 of file qgsrequesthandler.cpp.

◆ setServiceException()

void QgsRequestHandler::setServiceException ( const QgsServerException ex)

Allow plugins to return a QgsMapServiceException.

Definition at line 145 of file qgsrequesthandler.cpp.

◆ setStatusCode()

void QgsRequestHandler::setStatusCode ( int  code)

Sets response http status code.

Definition at line 129 of file qgsrequesthandler.cpp.

◆ statusCode()

int QgsRequestHandler::statusCode ( ) const

Returns the response http status code.

Definition at line 134 of file qgsrequesthandler.cpp.

◆ url()

QString QgsRequestHandler::url ( ) const

Returns the request url.

Definition at line 119 of file qgsrequesthandler.cpp.


The documentation for this class was generated from the following files: