Класс QHttpMultiPart

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

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

Типы публичного доступа

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

• 31 публичных функций, унаследованных от QObject

Дополнительные наследуемые члены

• 1 свойство, унаследованное от QObject
• 1 публичный слот, унаследованный от QObject
• 2 сигнала, унаследованные от QObject
• 11 статических публичных членов, унаследованных от QObject
• 9 защищённых функций, унаследованных от QObject

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

Класс QHttpMultiPart представляет собой MIME-сообщение типа multipart, предназначенное для отправки по протоколу HTTP.

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

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

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

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

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

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

QHttpMultiPart::QHttpMultiPart(QObject *parent = Q_NULLPTR)

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

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

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

Конструктор QHttpMultiPart с типом содержимого contentType и устанавливает родительский объект.

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

QHttpMultiPart::~QHttpMultiPart()

Уничтожает multipart.

void QHttpMultiPart::append(const QHttpPart &httpPart)

Добавляет httpPart к этому multipart.

QByteArray QHttpMultiPart::boundary() const

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

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

void QHttpMultiPart::setBoundary(const QByteArray &boundary)

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

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

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

void QHttpMultiPart::setContentType(ContentType contentType)

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

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