QHttpMultiPart Class

QHttpMultiPart 클래스는 HTTP를 통해 전송되는 MIME 멀티파트 메시지와 유사합니다. 더 보기...

헤더:	`#include <QHttpMultiPart>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS Network)` `target_link_libraries(mytarget PRIVATE Qt6::Network)`
qmake:	`QT += network`
상속:	QObject

상속된 멤버를 포함한 모든 멤버 목록
QHttpMultiPart는 네트워크 프로그래밍 API의 일부입니다.

공개 유형

enum	ContentType { MixedType, RelatedType, FormDataType, AlternativeType }

공개 함수

	QHttpMultiPart(QObject *parent = nullptr)
	QHttpMultiPart(QHttpMultiPart::ContentType contentType, QObject *parent = nullptr)
virtual	~QHttpMultiPart()
void	append(const QHttpPart &httpPart)
QByteArray	boundary() const
void	setBoundary(const QByteArray &boundary)
void	setContentType(QHttpMultiPart::ContentType contentType)

상세 설명

QHttpMultiPart는 RFC 2046에 설명된 대로 HTTP를 통해 전송되는 MIME 멀티파트 메시지와 유사합니다. 멀티파트 메시지는 고유한 경계로 구분된 임의의 수의 본문 부분( 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()도 참조하십시오 .

멤버 유형 문서

enum QHttpMultiPart::ContentType

RFC 2046 및 기타 문서에 설명된 멀티파트 하위 유형에 대해 알려진 콘텐츠 유형 목록.

상수	값	설명
`QHttpMultiPart::MixedType`	`0`	RFC 2046에 설명된 대로 “multipart/mixed” 하위 유형에 해당하며, 본문 부분들이 서로 독립적임을 의미합니다.
`QHttpMultiPart::RelatedType`	`1`	"multipart/related" 하위 유형에 해당하며, RFC 2387에 설명된 대로 본문 부분들이 서로 관련되어 있음을 의미합니다.
`QHttpMultiPart::FormDataType`	`2`	"multipart/form-data" 하위 유형에 해당하며, RFC 2388에 설명된 대로 본문 부분이 양식 요소를 포함함을 의미합니다.
`QHttpMultiPart::AlternativeType`	`3`	"multipart/alternative" 하위 유형에 해당하며, RFC 2046에 설명된 바와 같이 본문 부분들이 동일한 정보의 대체 표현임을 의미합니다.

setContentType()도 참조하십시오 .

멤버 함수 문서

`[explicit]` QHttpMultiPart::QHttpMultiPart(QObject **parent* = nullptr)

콘텐츠 유형이 ` MixedType `인 `QHttpMultiPart`를 생성하고, ` parent `를 상위 객체로 설정합니다.

QHttpMultiPart::ContentType도 참조하십시오 .

`[explicit]` QHttpMultiPart::QHttpMultiPart(QHttpMultiPart::ContentType contentType, QObject **parent* = nullptr)

콘텐츠 유형이 contentType 인 QHttpMultiPart 객체를 생성하고, parent를 상위 객체로 설정합니다.

QHttpMultiPart::ContentType도 참조하십시오 .

`[virtual noexcept]` QHttpMultiPart::~QHttpMultiPart()

multipart를 삭제합니다.

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`로 설정합니다. 이 콘텐츠 유형은 ` QNetworkAccessManager::post()`를 통해 멀티파트 메시지를 전송할 때 HTTP 헤더 섹션에서 사용됩니다. ` QHttpMultiPart::ContentType`에 포함되지 않은 멀티파트 하위 유형을 사용하려는 경우, ` QNetworkRequest `에 “Content-Type” 헤더 필드를 수동으로 추가한 다음, 이 요청을 멀티파트 메시지와 함께 사용하여 게시할 수 있습니다.

QHttpMultiPart::ContentType 및 QNetworkAccessManager::post()도 참조하십시오 .

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.