QT网络编程（四）——HTTP协议编程与示例

J^T

于 2024-08-05 11:01:26 发布

阅读量783

点赞数 17

分类专栏： Qt网络及多线程 Qt 文章标签：网络 qt http http协议

本文链接：https://blog.csdn.net/weixin_62621696/article/details/140917373

版权

Qt 同时被 2 个专栏收录

21 篇文章 2 订阅

订阅专栏

Qt网络及多线程

4 篇文章 0 订阅

订阅专栏

1. 创建QNetworkAccessManager实例

2. 创建并配置QNetworkRequest

1. 创建QNetworkAccessManager实例

2. 创建并配置QNetworkRequest

引言

在Qt框架中，进行HTTP协议编程是一项常见且重要的任务。Qt通过其强大的网络模块支持，提供了丰富的类来简化HTTP通信过程。本文将详细介绍如何在Qt中利用HTTP协议进行GET和POST请求，并展示如何使用相关类来实现这些功能。

一、HTTP协议基础

HTTP（超文本传输协议）是互联网上应用最为广泛的协议之一，它定义了客户端和服务器之间进行通信的规则。HTTP是一种无状态的协议，通过请求-响应模型来实现数据传输。主要的HTTP请求方法包括GET、POST、PUT、DELETE等，每种方法都有其特定的用途。

GET：GET 从指定的资源请求数据。必要时，可以将查询字符串参数追加到URL的末尾，以便将信息发送给服务器。GET因为参数会放在url中，所以隐私性，安全性较差，请求的数据长度是有限制的，不同的浏览器和服务器不同，一般限制在 2~8K 之间，更加常见的是 1k 以内。
POST：POST向指定的资源提交要被处理的数据。POST请求应该把数据作为请求的主体提交，请求主体(body)可以包括非常多的数据，且数据格式不限。POST请求是没有的长度限制，请求数据是放在body中。

二、Qt中的HTTP通信

在Qt中，确保你的Qt项目在.pro文件中添加了QT += network，以便能够使用网络模块。进行HTTP通信主要依赖于QNetworkAccessManager类，该类提供了一个用于发送网络请求和接收网络响应的高层API。以下是与HTTP通信相关的几个关键类及其功能：

#include <QNetworkAccessManager>  
#include <QNetworkRequest>  
#include <QNetworkReply>  
#include <QUrl>  
#include <QDebug>

QNetworkAccessManager：用于发送HTTP请求和接收HTTP响应，支持GET、POST等多种请求类型。
QNetworkRequest：表示一个HTTP请求，可以设置请求的URL、请求头、请求方法等属性。
QNetworkReply：表示一个HTTP响应，提供了获取响应状态码、响应头、响应正文等信息的方法。QNetworkReply 是 QIODevice的子类，这意味着一旦从对象中读取数据，它就不再由设备保留。因此，如果需要，应用程序有责任保留这些数据。

三、GET请求

在Qt中发送HTTP GET请求的详细步骤主要包括以下几个方面：

1. 创建`QNetworkAccessManager`实例

QNetworkAccessManager是负责发送网络请求并接收响应的类。你需要创建一个QNetworkAccessManager的实例来管理你的网络请求。

QNetworkAccessManager *manager = new QNetworkAccessManager(this);

2. 创建并配置`QNetworkRequest`

QNetworkRequest对象封装了网络请求的各种参数，如URL、请求头等。对于GET请求，你主要需要设置请求的URL。

QUrl url("http://example.com/api/data"); // 替换为你的目标URL  
QNetworkRequest request(url);  
  
// 如果需要，你还可以设置其他请求头，但GET请求通常不需要  
// request.setHeader(QNetworkRequest::ContentTypeHeader, "application/json"); // 这对于GET请求通常不是必需的

3. 发送GET请求

使用QNetworkAccessManager的get方法发送GET请求。你需要将配置好的QNetworkRequest作为参数传递给这个方法。该方法会返回一个QNetworkReply对象，用于接收响应。

QNetworkReply *reply = manager->get(request);

4. 处理响应

QNetworkReply对象表示对请求的响应。你需要连接QNetworkReply的finished信号到一个槽，以便在响应到达时进行处理。

QObject::connect(reply, &QNetworkReply::finished, [=]() {  
    if (reply->error() == QNetworkReply::NoError) {  
        // 处理成功的响应  
        QVariant statusCode = reply->attribute(QNetworkRequest::HttpStatusCodeAttribute);  
        QByteArray responseData = reply->readAll();  
        qDebug() << "状态码:" << statusCode.toInt();  
        qDebug() << "响应数据:" << responseData;  
        // 你可能还需要解析responseData，比如将其转换为JSON对象  
    } else {  
        // 处理错误  
        qDebug() << "GET请求失败:" << reply->errorString();  
    }  
    reply->deleteLater(); // 清理资源  
});

5. 代码示例

UI界面：

代码：

mianwindow.h头文件：

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>

#include <QtNetwork>    // 提供编程TCP/IP客户端和服务器的类
#include <QUrl>     // 提供接口使用URLs

//class QNetworkAccessManager;
//class QNetworkReply;

QT_BEGIN_NAMESPACE
namespace Ui { class MainWindow; }
QT_END_NAMESPACE

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

private:
    Ui::MainWindow *ui;

    QNetworkAccessManager *mgr;

public slots:
    void replyFinishedFunc(QNetworkReply *reply);    // 处理响应


private slots:
    void on_pushButton_clicked();
};
#endif // MAINWINDOW_H

mianwindow.cpp文件：

#include "mainwindow.h"
#include "ui_mainwindow.h"

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    mgr = new QNetworkAccessManager(this);

    connect(mgr, SIGNAL(finished(QNetworkReply*)),
            this, SLOT(replyFinishedFunc(QNetworkReply*)));


}

MainWindow::~MainWindow()
{
    delete ui;
}

void MainWindow::replyFinishedFunc(QNetworkReply *reply)    // 处理响应
{
    if (reply->error() == QNetworkReply::NoError) {
        // 处理成功的响应
        QString responseData = reply->readAll();    // 读取数据
        ui->textBrowser->setText(responseData);     // 显示数据
    } else {
        // 处理错误
        qDebug() << "GET请求失败:" << reply->errorString();
    }
    reply->deleteLater(); // 清理资源
}
void MainWindow::on_pushButton_clicked()
{
    ui->label->setText("数据正在下载中，请耐心等待......");
    mgr->get(QNetworkRequest(QUrl("http://www.baidu.com")));
}

main.cpp文件：

#include "mainwindow.h"

#include <QApplication>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    MainWindow w;
    w.show();
    return a.exec();
}

运行结果：

四、POST请求

在Qt中进行HTTP POST请求时，我们主要依赖于QNetworkAccessManager类来发送请求，并使用QNetworkReply类来接收和处理响应。下面我将详细解析这些关键函数和步骤，以便更好地理解如何发送POST请求。

1. 创建`QNetworkAccessManager`实例

QNetworkAccessManager是Qt网络模块中用于管理网络请求的一个类。它负责发送请求并处理响应。首先，你需要创建一个QNetworkAccessManager的实例。

QNetworkAccessManager *manager = new QNetworkAccessManager(this);

或者，如果你是在局部作用域中，并且不需要跨多个事件循环保持QNetworkAccessManager的生命周期，可以直接在栈上创建它：

QNetworkAccessManager manager;

2. 创建并配置`QNetworkRequest`

QNetworkRequest对象封装了网络请求的各种参数，如URL、请求头等。对于POST请求，你通常需要设置请求头来指定内容类型（Content-Type），例如application/json或application/x-www-form-urlencoded。

QUrl url("http://example.com/api/data");  
QNetworkRequest request(url);  
request.setHeader(QNetworkRequest::ContentTypeHeader, "application/json");