桌面应用 / 系统课时

提交 POST 请求和请求头

提交 POST 请求和请求头

调用登录、创建资源或提交表单接口时,除了 URL,还要同时发送请求体和请求头。本节使用 Qt 6 组装 JSON 请求体,设置 Content-Type 与 Authorization,再通过 QNetworkAccessManager::post() 异步提交并验证服务端收到的数据。

学习目标

  • 使用 QJsonObject 和 QJsonDocument 生成 JSON 请求体
  • 设置 Content-Type、认证等常见 HTTP 请求头
  • 通过 QNetworkReply 检查 POST 请求结果并释放回复对象

准备 Network 模块

POST 请求同样依赖 Qt Network。下面是 CMake 片段示例,应放入已有项目并把 my_app 替换为实际目标名:

cmake
find_package(Qt6 REQUIRED COMPONENTS Core Network)
target_link_libraries(my_app PRIVATE Qt6::Core Qt6::Network)

重新配置项目后能正常编译包含 Network 头文件的源代码,即可确认模块链接生效。

组装请求头和 JSON 请求体

QNetworkRequest 保存 URL 和请求元数据,请求体则作为 QByteArray 传给 post()。发送 JSON 时,Content-Type 应明确为 application/json;令牌等非标准字段可通过 setRawHeader() 设置。

请求头和请求体职责不同:请求头描述数据格式、认证和缓存等元信息,请求体承载本次提交的业务数据。认证令牌不应硬编码在源码中,生产项目通常从安全存储或登录结果中获取。

发送 POST 请求

下面示例向公开测试接口 https://httpbin.org/post 提交 JSON。<TOKEN> 是演示占位符,真实项目应替换为接口实际要求的令牌。程序只验证服务端回显的 JSON 内容,不依赖认证头是否被回显。

cpp
#include <QCoreApplication>
#include <QDebug>
#include <QJsonDocument>
#include <QJsonObject>
#include <QNetworkAccessManager>
#include <QNetworkReply>
#include <QNetworkRequest>
#include <QUrl>

int main(int argc, char *argv[])
{
    QCoreApplication app(argc, argv);
    QNetworkAccessManager manager;

    QJsonObject payload;
    payload.insert("name", "Qt Client");
    payload.insert("enabled", true);
    const QByteArray body = QJsonDocument(payload).toJson(QJsonDocument::Compact);

    QNetworkRequest request(QUrl("https://httpbin.org/post"));
    request.setHeader(QNetworkRequest::ContentTypeHeader,
                      QStringLiteral("application/json"));
    request.setRawHeader("Authorization", "Bearer <TOKEN>");

    QNetworkReply *reply = manager.post(request, body);

    QObject::connect(reply, &QNetworkReply::finished, &app, [&app, reply]() {
        const int statusCode =
            reply->attribute(QNetworkRequest::HttpStatusCodeAttribute).toInt();

        if (reply->error() != QNetworkReply::NoError) {
            qWarning().noquote() << "request failed:" << reply->errorString();
            reply->deleteLater();
            app.quit();
            return;
        }

        const QJsonDocument document = QJsonDocument::fromJson(reply->readAll());
        const QJsonObject echoed = document.object().value("json").toObject();

        qInfo().noquote() << "status:" << statusCode;
        qInfo().noquote() << "name:" << echoed.value("name").toString();
        qInfo().noquote() << "enabled:" << echoed.value("enabled").toBool();

        reply->deleteLater();
        app.quit();
    });

    return app.exec();
}

预期输出

text
status: 200
name: Qt Client
enabled: true

测试服务不可访问、TLS 失败或代理配置异常时,程序会进入错误分支,错误文本随环境变化。生产代码还应根据接口契约区分 2xx、4xx、5xx,并对响应 JSON 做格式校验。

选择请求头设置方式

setHeader() 适合 Qt 已定义的常见头,例如 Content-Type;setRawHeader() 适合 Authorization、自定义追踪 ID 等原始头字段。二者最终都会写入 HTTP 请求,但前者能让代码直接使用 Qt 的已知头枚举。

同一个 QNetworkAccessManager 可以连续发送多个请求。每次 post() 返回独立的 QNetworkReply,因此并发请求时应把业务上下文与对应 reply 绑定,不能只依靠“最后一次请求”的成员变量判断响应属于谁。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

提交 POST 请求和请求头

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通