class QFormDataPartBuilder

The QFormDataPartBuilder class is a convenience class to simplify the construction of QHttpPart objects. More

Added in version 6.8.

Synopsis

Methods

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description

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

__init__()
setBody(data[, fileName={}[, mimeType={}]])
Parameters:
  • dataQByteArrayView

  • fileName – str

  • mimeType – str

Return type:

QFormDataPartBuilder

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

If mimeType is not given (is empty), then QFormDataPartBuilder tries to auto-detect the mime-type of data using 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.

See also

setBodyDevice()

setBodyDevice(body[, fileName={}[, mimeType={}]])
Parameters:
  • bodyQIODevice

  • fileName – str

  • mimeType – str

Return type:

QFormDataPartBuilder

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

If mimeType is not given (is empty), then QFormDataPartBuilder tries to auto-detect the mime-type of body using 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 does not take ownership of body, i.e. the device must be closed and destroyed if necessary.

Note

If body is sequential (e.g. sockets, but not files), post() should be called after body has emitted finished().

setHeaders(headers)
Parameters:

headersQHttpHeaders

Return type:

QFormDataPartBuilder

Sets the headers specified in headers.

Note

The “content-type” and “content-disposition” headers, if any are specified in headers, will be overwritten by the class.

swap(other)
Parameters:

otherQFormDataPartBuilder