qt QHttpMultiPart详解

news2025/10/31 4:52:14

1. 概述

QHttpMultiPart是Qt框架中用于处理HTTP多部分请求的类。它类似于RFC 2046中描述的MIME multipart消息，允许在单个HTTP请求中包含多个数据部分，如文件、文本等。这种多部分请求在上传文件或发送带有附件的邮件等场景中非常有用。QHttpMultiPart类提供了添加和管理QHttpPart对象的方法，其中QHttpPart表示HTTP请求中的一个部分，包含了部分的headers和数据。

2. 重要方法

QHttpMultiPart类的重要方法包括：

构造函数：QHttpMultiPart(QHttpMultiPart::ContentType type) - 创建一个QHttpMultiPart对象，并指定其类型（如QHttpMultiPart::MixedType、QHttpMultiPart::RelatedType或QHttpMultiPart::FormDataType）。
append()：void append(const QHttpPart &part) - 将一个QHttpPart对象添加到QHttpMultiPart中。
setBoundary()：void setBoundary(const QByteArray &boundary) - 设置用于分隔各个部分的边界字符串。如果不设置，QHttpMultiPart将自动生成一个唯一的边界字符串。
boundary()：QByteArray boundary() const - 返回当前设置的边界字符串。
contentType()：QString contentType() const - 返回构造好的Content-Type头，包含了边界信息。

3、常用枚举类型

以下是 QHttpMultiPart 类中一些常用的枚举类型及其简要介绍：

QHttpMultiPart::ContentType:多部分内容类型

QHttpMultiPart::MixedType:混合内容类型
QHttpMultiPart::RelatedType:相关内容类型
QHttpMultiPart::FormDataType:表单数据内容类型
QHttpMultiPart::AlternativeType:备用内容类型

#include <QCoreApplication>
#include <QNetworkAccessManager>
#include <QNetworkRequest>
#include <QNetworkReply>
#include <QHttpMultiPart>
#include <QHttpPart>
#include <QFile>
#include <QUrl>
#include <QDebug>

int main(int argc, char *argv[]) {
    QCoreApplication a(argc, argv);

    QNetworkAccessManager manager;
    QUrl url("http://example.com/upload"); // 替换为实际的服务器URL
    QNetworkRequest request(url);

    QHttpMultiPart *multiPart = new QHttpMultiPart(QHttpMultiPart::FormDataType);

    // 添加文本部分
    QHttpPart textPart;
    textPart.setHeader(QNetworkRequest::ContentDispositionHeader, QVariant("form-data; name=\"text\""));
    textPart.setBody("This is a text part.");
    multiPart->append(textPart);

    // 添加文件部分
    QHttpPart filePart;
    QFile *file = new QFile("example.txt"); // 替换为实际的文件路径
    file->open(QIODevice::ReadOnly);
    filePart.setHeader(QNetworkRequest::ContentTypeHeader, QVariant("text/plain"));
    filePart.setHeader(QNetworkRequest::ContentDispositionHeader, QVariant("form-data; name=\"file\"; filename=\"example.txt\""));
    filePart.setBodyDevice(file);
    file->setParent(multiPart); // 确保文件在multiPart被删除时也被删除
    multiPart->append(filePart);

    QNetworkReply *reply = manager.post(request, multiPart);
    multiPart->setParent(reply); // 确保multiPart在reply被删除时也被删除

    QObject::connect(reply, &QNetworkReply::finished, [&]() {
        if (reply->error() == QNetworkReply::NoError) {
            qDebug() << "Upload successful!";
        } else {
            qDebug() << "Upload failed:" << reply->errorString();
        }
        reply->deleteLater();
        QCoreApplication::quit();
    });

    return a.exec();
}