Nuria::HttpClient Class Reference

The HttpClient class represents a connection to a client. More...

#include <httpclient.hpp>

Inheritance diagram for Nuria::HttpClient:

Public Types
enum	ConnectionMode { ConnectionClose = 0, ConnectionKeepAlive }
typedef QMap< QByteArray, QNetworkCookie >	Cookies
typedef QMultiMap< QByteArray, QByteArray >	HeaderMap
enum	HttpHeader {   HeaderCacheControl = 0, HeaderContentLength, HeaderContentType, HeaderConnection,   HeaderDate, HeaderHost = 1000, HeaderUserAgent, HeaderAccept,   HeaderAcceptCharset, HeaderAcceptEncoding, HeaderAcceptLanguage, HeaderAuthorization,   HeaderCookie, HeaderRange, HeaderReferer, HeaderDoNotTrack,   HeaderExpect, HeaderContentEncoding = 2000, HeaderContentLanguage, HeaderContentDisposition,   HeaderContentRange, HeaderLastModified, HeaderRefresh, HeaderSetCookie,   HeaderTransferEncoding, HeaderLocation }
enum	HttpVerb {   InvalidVerb = 0, GET = 1, POST = 2, HEAD = 4,   PUT = 8, DELETE = 16, AllVerbs = GET | POST | HEAD | PUT | DELETE }
enum	HttpVersion { HttpUnknown, Http1_0, Http1_1 }
enum	RedirectMode { RedirectMode::Keep = 0, RedirectMode::ForceSecure, RedirectMode::ForceUnsecure }
enum	StandardFilter { DeflateFilter = 0, GzipFilter = 1 }
enum	TransferMode { Streaming = 0, Buffered, ChunkedStreaming }

Public Slots
void	close () override
void	forceClose ()
bool	killConnection (int error, const QString &cause=QString())
bool	sendResponseHeader ()

Signals
void	disconnected ()
void	headerReady ()
void	postBodyComplete ()

Public Member Functions
	HttpClient (HttpTransport *transport, HttpServer *server)
virtual	~HttpClient ()
void	addFilter (StandardFilter filter)
void	addFilter (HttpFilter *filter)
bool	atEnd () const override
qint64	bytesAvailable () const override
ConnectionMode	connectionMode () const
qint64	contentLength () const
QNetworkCookie	cookie (const QByteArray &name)
Cookies	cookies ()
bool	hasCookie (const QByteArray &name)
bool	hasReadablePostBody () const
bool	hasRequestHeader (const QByteArray &key) const
bool	hasRequestHeader (HttpHeader header) const
bool	hasResponseHeader (const QByteArray &key) const
bool	hasResponseHeader (HttpHeader header) const
HttpServer *	httpServer () const
bool	isConnectionSecure () const
bool	isHeaderReady () const
virtual bool	isSequential () const
bool	keepConnectionOpen () const
QHostAddress	localAddress () const
quint16	localPort () const
bool	manualInit (HttpVerb verb, HttpVersion version, const QByteArray &path, const HeaderMap &headers)
QUrl	path () const
QHostAddress	peerAddress () const
quint16	peerPort () const
bool	pipeFromPostBody (QIODevice *device, bool takeOwnership=false)
bool	pipeToClient (QIODevice *device, qint64 maxlen=-1)
qint64	pos () const override
qint64	postBodyLength () const
HttpPostBodyReader *	postBodyReader ()
qint64	postBodyTransferred ()
qint64	rangeEnd () const
qint64	rangeStart () const
bool	redirectClient (const QString &localPath, RedirectMode mode=RedirectMode::Keep, int statusCode=307)
bool	redirectClient (const QUrl &remoteUrl, int statusCode=307)
void	removeCookie (const QByteArray &name)
void	removeFilter (StandardFilter filter)
void	removeFilter (HttpFilter *filter)
bool	requestCompletelyReceived () const
bool	requestHasPostBody () const
QByteArray	requestHeader (const QByteArray &key) const
QByteArray	requestHeader (HttpHeader header) const
QList< QByteArray >	requestHeaders (const QByteArray &key) const
QList< QByteArray >	requestHeaders (HttpHeader header) const
const HeaderMap &	requestHeaders () const
bool	reset () override
int	responseCode () const
const HeaderMap &	responseHeaders () const
QList< QByteArray >	responseHeaders (const QByteArray &key) const
QList< QByteArray >	responseHeaders (HttpHeader header) const
bool	responseHeaderSent () const
bool	seek (qint64 pos) override
bool	setContentLength (qint64 length)
void	setCookie (const QByteArray &name, const QByteArray &value, const QDateTime &expires, bool secure=false)
void	setCookie (const QByteArray &name, const QByteArray &value, qint64 maxAge=0, bool secure=false)
void	setCookie (const QNetworkCookie &cookie)
void	setKeepConnectionOpen (bool keepOpen)
bool	setRangeEnd (qint64 pos)
bool	setRangeStart (qint64 pos)
void	setResponseCode (int code)
bool	setResponseHeader (const QByteArray &key, const QByteArray &value, bool append=false)
bool	setResponseHeader (HttpHeader header, const QByteArray &value, bool append=false)
bool	setResponseHeaders (const HeaderMap &headers)
void	setSlotInfo (const SlotInfo &info)
bool	setTransferMode (TransferMode mode)
qint64	size () const override
SlotInfo	slotInfo () const
TransferMode	transferMode () const
HttpTransport *	transport () const
HttpVerb	verb () const

Static Public Member Functions
static QByteArray	httpHeaderName (HttpHeader header)
static QByteArray	httpStatusCodeName (int code)

Protected Member Functions
bool	bufferPostBody (QByteArray &data)
virtual qint64	readData (char *data, qint64 maxlen)
bool	resolveUrl (const QUrl &url)
virtual qint64	writeData (const char *data, qint64 len)

Friends
class	HttpNode
class	HttpServer
class	HttpTransport

Detailed Description

The HttpClient class represents a connection to a client.

This class is used whenever interaction with the HTTP client is necessary. It provides a simple way to transfer data from and to the client.

Note

As of now, HttpClient doesn't support Connection: keep-alive. This means that a client has to open a connection for each request. This problem will be addressed in the future.

Sending and receiving data

HttpClient is a subclass of QIODevice. Slots that expect a POST body can read it by using readAll or similar QIODevice methods. To send data to the client simply use write or similar. There is really not much to say about this - You can do anything with it that you can do with any QIODevice subclass.

Note

HttpClient is a random-access device. Methods such as read(), pos() and seek() always refer to the POST body. Writing always refers to sending data back to the client.

Piping

Additionally to the generic read and write methods, you can also pipe other QIODevice*'s to the client. This means that the implementation will take care of data transfer and will close the connection automatically on completion. This is useful when you want to send a large chunk of data. Another use-case is to combine this with QProcess when you want or need to interact with other applications.

This is possible for both directions: You can either pipe a buffer to the client, or pipe the clients post body into a QIODevice.

An example would be to use this to process a file while the user is still uploading it.

Note

Don't forget to enable streaming mode in the SlotInfo of this slot.

See also

pipe pipeBody

Closing and errors

Use close() to close the connection to the client. If an error occurs you're free to use killConnection.

Warning

As of now HttpClient is self-contained. This means that it will use deleteLater() on itself when the connection is closed by any side. Do not do this on your own. Never delete or deleteLater a HttpClient instance! Use close instead!

Range request and responses

If you want to support requests with 'Range' headers use rangeStart() and rangeEnd() to get the range the client requested. Use setContentLength() to set the length of the complete response.

Compression and filtering

Transparent compression is provided by filters. Filters are small classes which can hook themselves into the outgoing stream and e.g. compress or otherwise modify streams and HTTP headers.

Filters are invoked in the order they were added, except for those two "standard" filters, which are always invoked last.

Support for "gzip" (RFC 1952) and "deflate" (RFCs 1951, 1950) compressions schemes are provided by the framework. Custom filters can be written by sub-classing HttpFilter.

Warning

You should be aware of the BREACH attack, which targets encrypted and compressed transmissions. Please see: http://en.wikipedia.org/wiki/BREACH_%28security_exploit%29

Also as general note, use TLS. Do not use SSL. SSL is completely broken as in: unsecure.

Note

It is recommended to use "gzip" over "deflate" as deflate has severe browser compatibility issues.

Warning

Filters are not owned by the HttpClient instance.

See also

HttpFilter addFilter removeFilter

Member Typedef Documentation

typedef QMap< QByteArray, QNetworkCookie > Nuria::HttpClient::Cookies

List of cookies.

typedef QMultiMap< QByteArray, QByteArray > Nuria::HttpClient::HeaderMap

Map used to store HTTP headers in a name -> value fashion.

Member Enumeration Documentation

enum Nuria::HttpClient::ConnectionMode

Connection modes.

Enumerator
ConnectionClose	The connection will be closed after this request.
ConnectionKeepAlive	The connection will be kept alive after this request.

enum Nuria::HttpClient::HttpHeader

The HttpHeader enum lists the most common HTTP headers for requests and responses. Read some online resource for further explanations.

Enumerator
HeaderHost	Host, must be present in a HTTP/1.1 session.
HeaderUserAgent	User-Agent, must be present in a HTTP/1.1 session.

enum Nuria::HttpClient::HttpVerb

The HttpVerb enum contains a list of possible HTTP request types.

See also

SlotInfo::allowedVerbs

Enumerator
InvalidVerb	The client sent an invalid verb. This is also the default value which is present if isHeaderReady returns false.
GET	The client issued a GET request.
POST	The client issued a POST request.
HEAD	The client issued a HEAD request.
PUT	The client issued a PUT request.
DELETE	The client issued a DELETE request.
AllVerbs	OR-combination of all HTTP verbs.

enum Nuria::HttpClient::HttpVersion

The HttpVersion enum lists the possible HTTP versions.

Enumerator
Http1_0	Http 1.0.
Http1_1	Http 1.1.

enum Nuria::HttpClient::RedirectMode

strong

Modes which decide to which specific URL the client is redirected to.

Enumerator
Keep	Don't change the protocol encryption. Keeps the secure or unsecure connection.
ForceSecure	Redirect the client to the SSL secured path.
ForceUnsecure	Redirect the client to the unsecured path.

enum Nuria::HttpClient::StandardFilter

Enumeration of standard filters.

Enumerator
DeflateFilter	Deflate filter.
GzipFilter	GZIP filter.

enum Nuria::HttpClient::TransferMode

Transfer modes for responses.

Enumerator
Streaming	Default for "Connection: close" requests. The response will be streamed to the remote peer. It is not possible to send additional response HTTP headers after the first write() call. This mode doesn't support reusing the same connection for other requests.
Buffered	Support for both "Connection" 'close' and 'keep-alive' connections. All calls to write() will be buffered until close() is called on the HttpClient instance, after which all buffered data will be sent. It is possible to change response headers until that at all times. The Content-Type and Content-Length response headers will be set automatically. Note Internally a TemporaryBufferDevice is used.
ChunkedStreaming	Default for "Connection: keep-alive" requests. The response will be streamed with a transfer-encoding of 'chunked'. This mode supports reusing the same connection for further requests.

Constructor & Destructor Documentation

Nuria::HttpClient::HttpClient ( HttpTransport *  transport, HttpServer *  server  )

explicit

Constructs a new HttpClient instance which uses transport as communication back-end.

Ownership of the HttpClient will be transferred to transport.

virtual Nuria::HttpClient::~HttpClient ( )

virtual

Destructor.

Member Function Documentation

void Nuria::HttpClient::addFilter

(

StandardFilter

filter

)

Adds filter to the filter chain. There can only be the DeflateFilter or the GzipFilter active at the same time. If one is already added before calling this method, it will be replaced.

void Nuria::HttpClient::addFilter

(

HttpFilter *

filter

)

Adds filter to the filter chain.

bool Nuria::HttpClient::atEnd ( ) const

override

Returns true if the POST body has been completely read by the user. Also returns true if the request has no POST body at all. Returns false otherwise.

bool Nuria::HttpClient::bufferPostBody ( QByteArray &  data )

protected

Takes care of buffering the POST body.

void Nuria::HttpClient::close ( )

overrideslot

Note

close() will make sure that all data that is in the write buffer will be sent to the client before the socket is closed.

If no data has been sent yet, but a request header has been received, a appropriate response header will be sent.

See also

forceClose

ConnectionMode Nuria::HttpClient::connectionMode

(

)

const

Returns the connection mode of this client.

qint64 Nuria::HttpClient::contentLength

(

)

const

Returns the Content-Length. Returns -1 if the content length is unknown.

QNetworkCookie Nuria::HttpClient::cookie

(

const QByteArray &

name

)

Returns the value of cookie name. Returns an empty value if there is no cookie with this name.

Note

This method refers to cookies received from the client.

See also

cookies hasCookie

Cookies Nuria::HttpClient::cookies

(

)

Returns all received cookies from the client.

Note

This method refers to cookies received from the client.

See also

cookie hasCookie

void Nuria::HttpClient::disconnected ( )

signal

Gets emitted when the user just closed the connection.

void Nuria::HttpClient::forceClose ( )

slot

Tells the transport to immediately close the connection, without trying to send data in the send buffers.

Warning

This may cause data-loss!

bool Nuria::HttpClient::hasCookie

(

const QByteArray &

name

)

Returns if there is a cookie name.

Note

This method refers to cookies received from the client.

See also

cookies cookie

bool Nuria::HttpClient::hasReadablePostBody

(

)

const

Returns true only if this request has a POST body and it's readable by one of the readers known to HttpClient, e.g. for HTTP multi-part.

See also

read()

bool Nuria::HttpClient::hasRequestHeader

(

const QByteArray &

key

)

const

Returns if the client has sent a value for key in the request header.

bool Nuria::HttpClient::hasRequestHeader

(

HttpHeader

header

)

const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

bool Nuria::HttpClient::hasResponseHeader

(

const QByteArray &

key

)

const

Returns true when key has a value in the response header

bool Nuria::HttpClient::hasResponseHeader

(

HttpHeader

header

)

const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

void Nuria::HttpClient::headerReady ( )

signal

Gets emitted when the client has sent the header.

static QByteArray Nuria::HttpClient::httpHeaderName ( HttpHeader  header )

static

Returns the name of a HTTP standard header.

HttpServer* Nuria::HttpClient::httpServer

(

)

const

Returns the HTTP server this client belongs to.

static QByteArray Nuria::HttpClient::httpStatusCodeName ( int  code )

static

Returns the HTTP name for a statuscode. If none is known for code, an empty string is returned.

bool Nuria::HttpClient::isConnectionSecure

(

)

const

Returns true if the connection is secured.

See also

HttpTransport::isSecure

bool Nuria::HttpClient::isHeaderReady

(

)

const

Returns true if the client has sent the complete header.

virtual bool Nuria::HttpClient::isSequential ( ) const

virtual

Returns false, meaning this is a random-access device.

Warning

If you've set a buffer device through pipeFromPostBody(), then true is returned.

bool Nuria::HttpClient::keepConnectionOpen

(

)

const

Returns if the connection should be kept open after the slot has been called.

bool Nuria::HttpClient::killConnection ( int  error, const QString &  cause = QString()  )

slot

Kills the connection to the client immediatly with error as HTTP error code. If cause is not empty, it will be sent to the client. Else a appropriate cause is chosen automatically based on error.

This is only possible until the response header has been sent. If the response header has already been sent, the connection to the client will simply be destroyed.

QHostAddress Nuria::HttpClient::localAddress

(

)

const

See QAbstractSocket::localAddress.

quint16 Nuria::HttpClient::localPort

(

)

const

See QAbstractSocket::localPort.

bool Nuria::HttpClient::manualInit	(	HttpVerb	verb,
		HttpVersion	version,
		const QByteArray &	path,
		const HeaderMap &	headers
	)

Initializes the HttpClient instance.

This function is only intended for use within HttpTransports which get the HTTP header in a already parsed fashion to initialize HttpClient instances without having to assemble new ones.

If you're not implementing a HttpTransport, then you'll probably never need this function.

Returns true on success. On failure, the client will be closed. The HttpTransport must be able to receive data through its sendToRemote() function already when this function is called, as the HttpClient will start to process the data right away.

QUrl Nuria::HttpClient::path

(

)

const

Returns the complete requested path.

QHostAddress Nuria::HttpClient::peerAddress

(

)

const

See QAbstractSocket::peerAddress.

quint16 Nuria::HttpClient::peerPort

(

)

const

See QAbstractSocket::peerPort.

bool Nuria::HttpClient::pipeFromPostBody	(	QIODevice *	device,
		bool	takeOwnership = false
	)

Uses device from now on as buffer device. You can use this for example when you write an application which takes the POST body data, processes it somehow and then pipeToClient() the data back. The data in the current buffer is written to device.

Upon calling, the openMode of the HttpClient will be changed to QIODevice::WriteOnly.

Note

device must be open and writable.

Warning

Make sure device is not nullptr.

bool Nuria::HttpClient::pipeToClient	(	QIODevice *	device,
		qint64	maxlen = -1
	)

Takes device and pipes its contents into the client socket. After this call, any other write call will fail. The ownership of device will be transferred to this instance and thus will be destroyed when the client quits or device has no more data to read.

Note

device must be readable and open.

void Nuria::HttpClient::postBodyComplete ( )

signal

Gets emitted when the transfer of the POST body has been completed.

qint64 Nuria::HttpClient::postBodyLength

(

)

const

Convenience function, returns the length of the POST body using the Content-Length header.

HttpPostBodyReader* Nuria::HttpClient::postBodyReader

(

)

If hasReadablePostBody() returns true, returns a suitable POST body reader instance. Else returns nullptr. The reader instance is owned by the HttpClient. Consecutive calls of this method will always return the same result. The first call will create the reader.

qint64 Nuria::HttpClient::postBodyTransferred

(

)

Returns how many bytes have been transferred of the POST body.

qint64 Nuria::HttpClient::rangeEnd

(

)

const

Returns the end position of a 'range' request. If the client sent a valid 'Range' header, this method will return the end of the requested range. Else -1 is returned.

qint64 Nuria::HttpClient::rangeStart

(

)

const

Returns the start position of a 'range' request. If the client sent a valid 'Range' header, this method will return the start of the requested range. Else -1 is returned.

virtual qint64 Nuria::HttpClient::readData ( char *  data, qint64  maxlen  )

protectedvirtual

Implementation of QIODevice::readData.

bool Nuria::HttpClient::redirectClient	(	const QString &	localPath,
		RedirectMode	mode = RedirectMode::Keep,
		int	statusCode = 307
	)

Sends a HTTP redirect response, telling the client to go to localPath. Returns true if no headers has been sent yet.

Use this version of this function when you're redirecting to a URL which is served by this server.

For redirections to work properly, the Nuria::Server instance must have been told the FQDN ("fully qualified domain name").

Note

HTTP/1.0 clients will receive a status code of 301 instead of 307.

bool Nuria::HttpClient::redirectClient	(	const QUrl &	remoteUrl,
		int	statusCode = 307
	)

Sends a HTTP redirect response, telling the client to go to remoteUrl. This should only be used for URLs not served by this server. Returns true if no headers has been sent yet.

Note

HTTP/1.0 clients will receive a status code of 301 instead of 307.

void Nuria::HttpClient::removeCookie

(

const QByteArray &

name

)

Removes a cookie. If the cookie is known by the client it will also removed client-side. If the cookie is only known on server-side it will only be removed from there. If no cookie name is known nothing happens.

Note

This is only possible as long the HTTP response hasn't been sent yet.

void Nuria::HttpClient::removeFilter

(

StandardFilter

filter

)

Removes filter from the filter chain.

void Nuria::HttpClient::removeFilter

(

HttpFilter *

filter

)

Removes filter from the filter chain.

bool Nuria::HttpClient::requestCompletelyReceived

(

)

const

Returns true if the request has been completely received. This includes the POST/PUT body if one exists.

bool Nuria::HttpClient::requestHasPostBody

(

)

const

Returns true if the request has a POST/PUT body.

QByteArray Nuria::HttpClient::requestHeader

(

const QByteArray &

key

)

const

Returns a value of a header from the request. If the client sent multiple values for the header, this method returns the last one. Returns an empty QByteArray if there was no header named key.

See also

hasRequestHeader

QByteArray Nuria::HttpClient::requestHeader

(

HttpHeader

header

)

const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

QList< QByteArray > Nuria::HttpClient::requestHeaders

(

const QByteArray &

key

)

const

Returns the values of a header from the request. This method is useful for headers which may appear multiple times. Returns an empty QByteArray if there was no header named key.

See also

hasRequestHeader

QList< QByteArray > Nuria::HttpClient::requestHeaders

(

HttpHeader

header

)

const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

const HeaderMap& Nuria::HttpClient::requestHeaders

(

)

const

Returns a map of received request headers.

bool Nuria::HttpClient::resolveUrl ( const QUrl &  url )

protected

Resolves the URL from the client. That means that the code tries to find the associated slot of url and calls it if possible. Returns true on success.

int Nuria::HttpClient::responseCode

(

)

const

Returns the HTTP response code. Default is 200 OK

const HeaderMap& Nuria::HttpClient::responseHeaders

(

)

const

Returns the current response headers.

QList< QByteArray > Nuria::HttpClient::responseHeaders

(

const QByteArray &

key

)

const

Returns the response headers with key key.

QList< QByteArray > Nuria::HttpClient::responseHeaders

(

HttpHeader

header

)

const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

bool Nuria::HttpClient::responseHeaderSent

(

)

const

Returns true if the response header has been sent. The response header will be sent on the first write call to the instance or if the sendResponseHeader method has been called explicitly.

bool Nuria::HttpClient::sendResponseHeader ( )

slot

Explicitly sends a response header to the client. Fails if the client hasn't send a request so far (isHeaderReady() returns false) or if the response header has already been sent (In this case responseHeaderSent() returns true).

bool Nuria::HttpClient::setContentLength

(

qint64

length

)

Sets the Content-Length. Used in conjunction with range responses.

Note

If the response header has already been sent the call will fail.

void Nuria::HttpClient::setCookie	(	const QByteArray &	name,
		const QByteArray &	value,
		const QDateTime &	expires,
		bool	secure = false
	)

Sets a cookie on the client using a HTTP header. If there is already a cookie with name, it will be overridden. If secure is true the client is avised to only send the cookie to the server if a secure connection is used.

Note

This is only possible as long the HTTP response hasn't been sent yet.

void Nuria::HttpClient::setCookie	(	const QByteArray &	name,
		const QByteArray &	value,
		qint64	maxAge = 0,
		bool	secure = false
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Sets a cookie on the client using a HTTP header. If there is already a cookie with name, it will be overridden. maxAge defines the maximum age of the cookie in seconds. If it's 0, the cookie will removed by the client at the end of the session. If secure is true the client is avised to only send the cookie to the server if a secure connection is used.

Note

This is only possible as long the HTTP response hasn't been sent yet.

If maxAge is 0 (the default), the cookie will be a session cookie.

void Nuria::HttpClient::setCookie

(

const QNetworkCookie &

cookie

)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Sets a cookie on the client using a HTTP header. Use this overload if the other overloads aren't specific enough.

Note

This is only possible as long the HTTP response hasn't been sent yet.

void Nuria::HttpClient::setKeepConnectionOpen

(

bool

keepOpen

)

Sets whether the HTTP connection should be kept open after a slot has been called. By default, this is not the case.

Warning

Ownership of the instance is transferred to the user.

Note

Call close() to delete the instance. It will initiate a graceful shutdown, making sure everything is written before the instance is deleted. If the connection is already closed, use deleteLater().

Do not combine this with pipe().

bool Nuria::HttpClient::setRangeEnd

(

qint64

pos

)

Sets the end position of a range response.

Note

If the response header has already been sent the call will fail.

bool Nuria::HttpClient::setRangeStart

(

qint64

pos

)

Sets the start position of a range response.

Note

If the response header has already been sent the call will fail.

void Nuria::HttpClient::setResponseCode

(

int

code

)

Sets the HTTP response code.

bool Nuria::HttpClient::setResponseHeader	(	const QByteArray &	key,
		const QByteArray &	value,
		bool	append = false
	)

Sets a response header. Returns true if the response header has not yet been sent. If it was already sent to the client, the function will fail as HTTP doesn't allow to send additional headers after the HTTP header. In this case the response header map won't be modified. If append is true and there is already a value for key, then the new value will be appended to the list.

Note

If you want to set the 'Content-Length' header please use setContentLength().

See also

contentLength setContentLength

rangeStart rangeEnd setRangeStart setRangeEnd

bool Nuria::HttpClient::setResponseHeader	(	HttpHeader	header,
		const QByteArray &	value,
		bool	append = false
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

bool Nuria::HttpClient::setResponseHeaders

(

const HeaderMap &

headers

)

Sets the response header map.

See also

setResponseHeader

void Nuria::HttpClient::setSlotInfo

(

const SlotInfo &

info

)

Sets a SlotInfo for this client. This is needed when you're sub-classing HttpNode with non-streaming clients.

bool Nuria::HttpClient::setTransferMode

(

TransferMode

mode

)

Sets the transfer mode. This is only possible to do before anything has been sent. On success, true is returned.

SlotInfo Nuria::HttpClient::slotInfo

(

)

const

Returns the associated slot info of the client.

TransferMode Nuria::HttpClient::transferMode

(

)

const

Returns the used transfer mode.

HttpTransport* Nuria::HttpClient::transport

(

)

const

Returns the internal HttpTransport instance.

HttpVerb Nuria::HttpClient::verb

(

)

const

Returns the HTTP verb used by the client.

virtual qint64 Nuria::HttpClient::writeData ( const char *  data, qint64  len  )

protectedvirtual

Implementation of QIODevice::writeData.

---

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

• httpclient.hpp