Класс QHttpMultiPart

Класс QHttpMultiPart представляет собой MIME-сообщение с разделами, которое должно быть отправлено по протоколу HTTP. Подробнее...

Этот класс был введен в Qt 4.8.

• Список всех членов, включая унаследованные

Публичные типы

Публичные функции

Подробное описание

QHttpMultiPart представляет собой MIME-сообщение с разделами, как описано в RFC 2046, которое должно быть отправлено по протоколу HTTP. Сообщение с разделами состоит из произвольного числа разделов тела (см. QHttpPart), которые разделены уникальной границей. Граница QHttpMultiPart создаётся с помощью строки «boundary_.oOo._», за которой следуют случайные символы, и обеспечивает достаточную уникальность, чтобы не возникать внутри самих разделов. При необходимости граница всё ещё может быть установлена с помощью setBoundary().

Например, рассмотрим фрагмент кода, который строит сообщение с разделами, содержащее текстовый раздел, за которым следует раздел изображения:

QHttpMultiPart *multiPart = new QHttpMultiPart(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 = new QFile("image.jpg");
file->open(QIODevice::ReadOnly);
imagePart.setBodyDevice(file);
file->setParent(multiPart); // we cannot delete the file now, so delete it with the multiPart

multiPart->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.

См. также QHttpPart и QNetworkAccessManager::post().

Документация по типам членов

Перечисление QHttpMultiPart::ContentType

Список известных типов контента для подтипа с разделами, как описано в RFC 2046 и других документах.

См. также setContentType().

Документация по функциям членов

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

Создаёт QHttpMultiPart с типом контента contentType и устанавливает parent в качестве родительского объекта.

См. также QHttpMultiPart::ContentType.

QHttpMultiPart::QHttpMultiPart(QObject *parent = nullptr)

Создаёт QHttpMultiPart с типом контента MixedType и устанавливает parent в качестве родительского объекта.

См. также QHttpMultiPart::ContentType.

[virtual] QHttpMultiPart::~QHttpMultiPart()

Уничтожает разделитель.

void QHttpMultiPart::append(const QHttpPart &httpPart)

Добавляет httpPart к этому разделителю.

QByteArray QHttpMultiPart::boundary() const

Возвращает границу.

См. также setBoundary().

void QHttpMultiPart::setBoundary(const QByteArray &boundary)

Устанавливает границу на boundary.

Обычно вам не нужно генерировать границу самостоятельно; при создании граница инициализируется строкой «boundary_.oOo._», за которой следуют случайные символы, и обеспечивает достаточную уникальность, чтобы не возникать внутри самих разделов.

См. также boundary().

void QHttpMultiPart::setContentType(QHttpMultiPart::ContentType contentType)

Устанавливает тип контента на contentType. Тип контента будет использоваться в разделе HTTP-заголовка при отправке сообщения с разделами через QNetworkAccessManager::post(). В случае, если вы хотите использовать подтип с разделами, не содержащийся в QHttpMultiPart::ContentType, вы можете добавить поле заголовка «Content-Type» в QNetworkRequest вручную, а затем использовать этот запрос вместе с сообщением с разделами для отправки.

См. также QHttpMultiPart::ContentType и QNetworkAccessManager::post().