Contents

• Public Types
• Public Functions
• Detailed Description

Detailed Description

TheQHttpMultiPart class resembles a MIME multipart message to be sent over HTTP.

TheQHttpMultiPart resembles a MIME multipart message, as described in RFC 2046, which is to be sent over HTTP. A multipart message consists of an arbitrary number of body parts (seeQHttpPart), which are separated by a unique boundary. The boundary of theQHttpMultiPart is constructed with the string "boundary_.oOo._" followed by random characters, and provides enough uniqueness to make sure it does not occur inside the parts itself. If desired, the boundary can still be set viasetBoundary().

As an example, consider the following code snippet, which constructs a multipart message containing a text part followed by an image part:

QHttpMultiPart*multiPart=newQHttpMultiPart(QHttpMultiPart::FormDataType);QHttpPart textPart;textPart.setHeader(QNetworkRequest::ContentDispositionHeader,QVariant("form-data; name=\"text\""));textPart.setBody("my text");QHttpPart imagePart;imagePart.setHeader(QNetworkRequest::ContentTypeHeader,QVariant("image/jpeg"));imagePart.setHeader(QNetworkRequest::ContentDispositionHeader,QVariant("form-data; name=\"image\""));QFile*file=newQFile("image.jpg");file->open(QIODevice::ReadOnly);imagePart.setBodyDevice(file);file->setParent(multiPart);// we cannot delete the file now, so delete it with the multiPartmultiPart->append(textPart);multiPart->append(imagePart);QUrl url("http://my.server.tld");QNetworkRequest request(url);QNetworkAccessManager manager;QNetworkReply*reply= manager.post(request, multiPart);multiPart->setParent(reply);// delete the multiPart with the reply// here connect signals etc.

Member Type Documentation

enum QHttpMultiPart::ContentType

List of known content types for a multipart subtype as described in RFC 2046 and others.

See alsosetContentType().

Member Function Documentation

QHttpMultiPart::QHttpMultiPart(QObject * parent = 0)

Constructs aQHttpMultiPart with content typeMixedType and setsparent as the parent object.

See alsoQHttpMultiPart::ContentType.

QHttpMultiPart::QHttpMultiPart(ContentType contentType,QObject * parent = 0)

Constructs aQHttpMultiPart with content typecontentType and sets parent as the parent object.

See alsoQHttpMultiPart::ContentType.

QHttpMultiPart::~QHttpMultiPart()

Destroys the multipart.

void QHttpMultiPart::append(constQHttpPart & httpPart)

AppendshttpPart to this multipart.

QByteArray QHttpMultiPart::boundary() const

returns the boundary.

See alsosetBoundary().

void QHttpMultiPart::setBoundary(constQByteArray & boundary)

Sets the boundary toboundary.

Usually, you do not need to generate a boundary yourself; upon construction the boundary is initiated with the string "boundary_.oOo._" followed by random characters, and provides enough uniqueness to make sure it does not occur inside the parts itself.

See alsoboundary().

void QHttpMultiPart::setContentType(ContentType contentType)

Sets the content type tocontentType. The content type will be used in the HTTP header section when sending the multipart message viaQNetworkAccessManager::post(). In case you want to use a multipart subtype not contained inQHttpMultiPart::ContentType, you can add the "Content-Type" header field to theQNetworkRequest by hand, and then use this request together with the multipart message for posting.

See alsoQHttpMultiPart::ContentType andQNetworkAccessManager::post().