QFormDataPartBuilder Class

The QFormDataPartBuilder class is a convenience class to simplify the construction of QHttpPart 对象。更多...

头：	`#include <QFormDataPartBuilder>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Network)` `target_link_libraries(mytarget PRIVATE Qt6::Network)`
qmake:	`QT += network`
Since:	Qt 6.8

所有成员列表，包括继承成员
QFormDataPartBuilder is part of 网络编程 API and 隐式共享类 .

公共函数

	QFormDataPartBuilder (const QFormDataPartBuilder & other )
	QFormDataPartBuilder (QFormDataPartBuilder && other )
	~QFormDataPartBuilder ()
QFormDataPartBuilder	setBody (QByteArrayView data , QAnyStringView fileName = {}, QAnyStringView mimeType = {})
QFormDataPartBuilder	setBodyDevice (QIODevice * body , QAnyStringView fileName = {}, QAnyStringView mimeType = {})
QFormDataPartBuilder	setHeaders (const QHttpHeaders & headers )
QFormDataPartBuilder &	operator= (QFormDataPartBuilder && other )
QFormDataPartBuilder &	operator= (const QFormDataPartBuilder & other )

详细描述

The QFormDataPartBuilder class can be used to build a QHttpPart object with the content disposition header set to be form-data by default. Then the generated object can be used as part of a multipart message (which is represented by the QHttpMultiPart class).

另请参阅 QHttpPart , QHttpMultiPart ，和 QFormDataBuilder .

成员函数文档编制

`[noexcept default]` QFormDataPartBuilder:: QFormDataPartBuilder (const QFormDataPartBuilder & other )

构造副本为 other . The object is valid for as long as the associated QFormDataBuilder has not been destroyed.

The data of the copy is shared (shallow copy): modifying one part will also change the other.

QFormDataPartBuilder foo()
{
    QFormDataBuilder builder;
    auto qfdpb1 = builder.part("First"_L1);
    auto qfdpb2 = qfdpb1; // this creates a shallow copy
    qfdpb2.setBodyDevice(&image, "cutecat.jpg"); // qfdpb1 is also modified
    return qfdbp2;  // invalid, builder is destroyed at the end of the scope
}

`[noexcept default]` QFormDataPartBuilder:: QFormDataPartBuilder ( QFormDataPartBuilder && other )

Move-constructs a QFormDataPartBuilder instance, making it point at the same object that other 所指向的。

`[noexcept default]` QFormDataPartBuilder:: ~QFormDataPartBuilder ()

销毁 QFormDataPartBuilder 对象。

QFormDataPartBuilder QFormDataPartBuilder:: setBody ( QByteArrayView data , QAnyStringView fileName = {}, QAnyStringView mimeType = {})

设置 data as the body of this MIME part and, if given, fileName as the file name parameter in the content disposition header.

若 mimeType is not given (is empty), then QFormDataPartBuilder tries to auto-detect the mime-type of data 使用 QMimeDatabase .

A subsequent call to setBodyDevice () discards the body and the device will be used instead.

For a large amount of data (e.g. an image), setBodyDevice () is preferred, which will not copy the data internally.

另请参阅 setBodyDevice ().

QFormDataPartBuilder QFormDataPartBuilder:: setBodyDevice ( QIODevice * body , QAnyStringView fileName = {}, QAnyStringView mimeType = {})

设置 body as the body device of this part and fileName as the file name parameter in the content disposition header.

若 mimeType is not given (is empty), then QFormDataPartBuilder tries to auto-detect the mime-type of body 使用 QMimeDatabase .

A subsequent call to setBody () discards the body device and the data set by setBody () will be used instead.

For large amounts of data this method should be preferred over setBody (), because the content is not copied when using this method, but read directly from the device.

body must be open and readable. QFormDataPartBuilder 未拥有所有权对于 body , i.e. the device must be closed and destroyed if necessary.

注意： 若 body is sequential (e.g. sockets, but not files), QNetworkAccessManager::post () should be called after body has emitted finished().

另请参阅 setBody () 和 QHttpPart::setBodyDevice ().

QFormDataPartBuilder QFormDataPartBuilder:: setHeaders (const QHttpHeaders & headers )

Sets the headers specified in headers .

注意： The "content-type" and "content-disposition" headers, if any are specified in headers , will be overwritten by the class.

`[noexcept default]` QFormDataPartBuilder &QFormDataPartBuilder:: operator= ( QFormDataPartBuilder && other )

移动赋值 other 到此 QFormDataPartBuilder 实例。

`[noexcept default]` QFormDataPartBuilder &QFormDataPartBuilder:: operator= (const QFormDataPartBuilder & other )

赋值 other to QFormDataPartBuilder and returns a reference to this QFormDataPartBuilder . The object is valid for as long as the associated QFormDataBuilder has not been destroyed.