QFormDataPartBuilder Class

成员函数文档

[constexpr noexcept default] QFormDataPartBuilder::QFormDataPartBuilder()

默认——构造一个QFormDataPartBuilder 的实例。

[implicit] QFormDataPartBuilder::QFormDataPartBuilder(const QFormDataPartBuilder &other)

创建other 的副本。只要关联的QFormDataBuilder 尚未被销毁，该对象就一直有效。

该副本的数据是共享的（浅拷贝）：修改其中一部分也会导致另一部分发生变化。

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 implicit] QFormDataPartBuilder::QFormDataPartBuilder(QFormDataPartBuilder &&other)

通过“move”操作构造一个 QFormDataPartBuilder 实例，使其指向与other 所指向的同一对象。

[noexcept implicit] QFormDataPartBuilder::~QFormDataPartBuilder()

销毁QFormDataPartBuilder 对象。

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

将data 设置为此 MIME 部分的正文，如果提供了fileName ，则将其作为 content-disposition 头中的文件名参数。

如果未提供mimeType （即为空），则QFormDataPartBuilder 将尝试使用QMimeDatabase 自动检测data 的 MIME 类型。

随后对setBodyDevice() 的调用将丢弃正文，转而使用设备。

对于大量数据（例如图像），建议使用setBodyDevice()，该方法不会在内部复制数据。

另请参阅 setBodyDevice()。

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

将body 设置为此部分的主体设备，并将fileName 设置为内容处置标头中的文件名参数。

如果未提供mimeType （即为空），则QFormDataPartBuilder 将尝试使用QMimeDatabase 自动检测body 的 MIME 类型。

随后对setBody() 的调用将丢弃正文设备，并改用setBody() 设置的数据。

对于大量数据，应优先使用此方法，而不是setBody()，因为使用此方法时不会复制内容，而是直接从设备读取。

body 必须已打开且可读。QFormDataPartBuilder 不会接管body 的所有权，也就是说，如有必要，必须关闭并销毁该设备。

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

QFormDataPartBuilder QFormDataPartBuilder::setHeaders(const QHttpHeaders &headers)

设置headers 中指定的头部字段。

[implicit] QFormDataPartBuilder &QFormDataPartBuilder::operator=(QFormDataPartBuilder &&other)

将other 通过Move操作赋值给此QFormDataPartBuilder 实例。

[implicit] QFormDataPartBuilder &QFormDataPartBuilder::operator=(const QFormDataPartBuilder &other)

将other 赋值给QFormDataPartBuilder ，并返回对该QFormDataPartBuilder 的引用。只要关联的QFormDataBuilder 尚未被销毁，该对象就一直有效。

复制的数据是共享的（浅拷贝）：修改其中一部分也会改变另一部分。

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
}