QFormDataBuilder Class
La clase `QFormDataBuilder` es una clase auxiliar diseñada para simplificar la creación de objetos ` QHttpMultiPart `. Más información...
| Encabezado: | #include <QFormDataBuilder> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Network) target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake: | QT += network |
| Desde: | Qt 6.8 |
- Lista de todos los miembros, incluidos los heredados
- QFormDataBuilder forma parte de la API de programación de red y de las clases compartidas implícitamente.
Tipos públicos
| enum class | Option { Default, OmitRfc8187EncodedFilename, UseRfc7578PercentEncodedFilename, PreferLatin1EncodedFilename, StrictRfc7578 } |
| flags | Options |
Funciones públicas
| QFormDataBuilder() | |
| QFormDataBuilder(QFormDataBuilder &&other) | |
| ~QFormDataBuilder() | |
| std::unique_ptr<QHttpMultiPart> | buildMultiPart(QFormDataBuilder::Options options = {}) |
| QFormDataPartBuilder | part(QAnyStringView name) |
| QFormDataBuilder & | operator=(QFormDataBuilder &&other) |
Descripción detallada
La clase QFormDataBuilder se puede utilizar para crear un objeto ` QHttpMultiPart ` con el tipo de contenido establecido de forma predeterminada en `FormDataType`.
El fragmento de código siguiente muestra cómo crear un mensaje multiparte con QFormDataBuilder:
QFormDataBuilder builder;
QFile image(u"../../pic.png"_s); image.open(QFile::ReadOnly);
QFile mask(u"../../mask.png"_s); mask.open(QFile::ReadOnly);
builder.part("image"_L1).setBodyDevice(&image, "the actual image");
builder.part("mask"_L1).setBodyDevice(&mask, "the mask image");
builder.part("prompt"_L1).setBody("Lobster wearing a beret");
builder.part("n"_L1).setBody("2");
builder.part("size"_L1).setBody("512x512");
std::unique_ptr<QHttpMultiPart> mp = builder.buildMultiPart();Véase también QHttpPart, QHttpMultiPart y QFormDataPartBuilder.
Documentación sobre los tipos de miembro
enum class QFormDataBuilder::Option
flags QFormDataBuilder::Options
Opciones que controlan buildMultiPart().
Varios RFC actuales discrepan sobre cómo, exactamente, debe formatearse ` multipart/form-data`. En lugar de codificar de forma rígida un RFC concreto, estas opciones te permiten controlar qué RFC seguir.
| Constante | Valor | Descripción |
|---|---|---|
QFormDataBuilder::Option::Default | 0x00 | Los valores por defecto, diseñados para maximizar la interoperabilidad en general. Todas las opciones que se indican a continuación están desactivadas. |
QFormDataBuilder::Option::OmitRfc8187EncodedFilename | 0x01 | Cuando el nombre de archivo de una parte del cuerpo contiene caracteres no US-ASCII, la sección 4.3 del RFC 6266 sugiere utilizar la codificación al estilo del RFC 8187(filename*=utf-8''...). Sin embargo, la sección 4.2 del RFC 7578, más reciente, prohíbe el uso de ese mecanismo. Ambos RFC están vigentes en el momento de redactar este documento, por lo que esta opción le permite elegir cuál seguir. Por defecto, se incluye el archivo codificado según el RFC 8187 ( filename* ) junto con el no codificado ( filename), tal y como sugiere el RFC 6266. |
QFormDataBuilder::Option::UseRfc7578PercentEncodedFilename | 0x02 | Cuando el nombre de archivo de una parte del cuerpo contiene caracteres no US-ASCII, la sección 4.2 del RFC 7578 sugiere utilizar la codificación en porcentaje de los octetos del nombre de archivo codificado en UTF-8. A continuación, señala que, sin embargo, muchas implementaciones no codifican con el símbolo de porcentaje el nombre de archivo codificado en UTF-8, sino que simplemente emiten UTF-8 «sin procesar» (con " y \ escapados mediante \). Este es también el comportamiento predeterminado de QFormDataBuilder. |
QFormDataBuilder::Option::PreferLatin1EncodedFilename | 0x04 | La sección 3.2 del RFC 5987 exigía que los destinatarios admitieran la codificación ISO-8859-1 («Latin-1»). Cuando el nombre de archivo de una parte del cuerpo del mensaje contiene caracteres no US-ASCII que, sin embargo, se ajustan a Latin-1, esta opción da preferencia a la codificación ISO-8859-1 frente a UTF-8. El más reciente {https://datatracker.ietf.org/doc/html/rfc8187#apéndice-A}{RFC 8187} ya no exige la compatibilidad con ISO-8859-1, por lo que el valor predeterminado es enviar todos los nombres de archivo no ASCII de EE. UU. en codificación UTF-8. |
QFormDataBuilder::Option::StrictRfc7578 | OmitRfc8187EncodedFilename | UseRfc7578PercentEncodedFilename | Esta opción combina otras opciones para garantizar el cumplimiento estricto de la RFC 7578. |
El tipo Options es una definición de tipo (typedef) para QFlags<Option>. Almacena una combinación OR de valores de Option.
Documentación de las funciones miembro
QFormDataBuilder::QFormDataBuilder()
Crea un objeto QFormDataBuilder vacío.
[noexcept] QFormDataBuilder::QFormDataBuilder(QFormDataBuilder &&other)
Crea una instancia de `QFormDataBuilder` mediante la construcción por movimiento, de modo que apunte al mismo objeto al que apuntaba ` other `.
[noexcept] QFormDataBuilder::~QFormDataBuilder()
Elimina el objeto ` QFormDataBuilder `.
std::unique_ptr<QHttpMultiPart> QFormDataBuilder::buildMultiPart(QFormDataBuilder::Options options = {})
Crea y devuelve un puntero a un objeto QHttpMultipart creado según options.
Véase también QHttpMultiPart.
QFormDataPartBuilder QFormDataBuilder::part(QAnyStringView name)
Devuelve un objeto ` QFormDataPartBuilder ` de nueva creación utilizando ` name ` como parámetro ` name ` de los datos del formulario. El objeto es válido mientras el objeto ` QFormDataBuilder ` asociado no haya sido destruido.
Se recomienda encarecidamente limitar los caracteres de « name » al US-ASCII por motivos de interoperabilidad.
Véanse también QFormDataPartBuilder y QHttpPart.
[noexcept] QFormDataBuilder &QFormDataBuilder::operator=(QFormDataBuilder &&other)
Asigna « other » a esta instancia de « QFormDataBuilder ». .
© 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.