C++ Qt开发：QNetworkAccessManager网络接口组件

Qt 是一个跨平台C++图形界面开发库，利用Qt可以快速开发跨平台窗体应用程序，在Qt中我们可以通过拖拽的方式将不同组件放到指定的位置，实现图形化开发极大的方便了开发效率，本章将重点介绍如何运用QNetworkAccessManager组件实现Web网页访问。

QNetworkAccessManager是Qt网络模块中的关键类，用于管理网络访问和请求。作为一个网络请求的调度中心，它为Qt应用程序提供了发送和接收各种类型的网络请求的能力，包括常见的GET、POST、PUT、DELETE等。这个模块的核心功能在于通过处理QNetworkReply和QNetworkRequest来实现与网络资源的交互。

通过QNetworkAccessManager，Qt应用程序能够轻松地与远程服务器通信，获取数据或将数据上传到服务器。这种网络请求的管理不仅是异步的，以确保不会阻塞主线程，还提供了丰富的信号和槽机制，使得开发者可以灵活地处理不同阶段的网络操作。

通常，QNetworkAccessManager会与QNetworkReply和QNetworkRequest一起使用。QNetworkRequest用于封装和配置网络请求的各种属性，例如URL、请求头等。而QNetworkReply则代表了对网络请求的响应，包含了请求返回的数据和相关信息。这三者共同协作，为Qt应用程序提供了便捷、灵活且强大的网络通信能力。

1.1 通用API函数

1.1.1 QNetworkAccessManager

要想实现网络通信首先需要新建一个网络访问管理器，以下是QNetworkAccessManager类中的一些常用函数及其描述：

这些函数提供了QNetworkAccessManager的核心功能，使得开发者能够方便地进行各种类型的网络请求，配置网络参数，并进行相关的网络管理操作。

1.1.2 QNetworkReply

以下是QNetworkReply类中的一些常用函数及其描述：

这些函数提供了对QNetworkReply实例进行各种操作和查询的方法，包括读取回复数据、处理SSL错误、获取请求信息、检查错误状态等。开发者可以根据具体需求使用这些函数来有效地与网络回复进行交互。

1.1.3 QNetworkRequest

以下是QNetworkRequest类中的一些常用函数及其描述：

这些函数提供了对QNetworkRequest实例进行各种操作和查询的方法，包括设置和获取头信息、设置SSL配置、设置和获取网络请求属性等。开发者可以根据具体需求使用这些函数来有效地构建和管理网络请求。

1.2 实现Web页面访问

要使用该模块读者应该在*.pro文件内包含network网络模块，并在头文件中引入QNetworkAccessManager、QNetworkReply、QNetworkRequest三个类，在建立访问时首先使用QNetworkAccessManager新增一个manager管理类，并通过QNetworkRequest类创建一个GET请求地址，通过使用manager.get方法实现对特定页面的访问。

当访问完成时需要通过一个信号来实现对数据的处理，在QNetworkReply类中包含有如下表所示的信号以供读者使用，例如当访问被完成时则自动触发&QNetworkReply::finished完成信号，此时只需要对该信号进行相应的处理即可，通常会使用一个槽函数来处理它。

这些信号提供了丰富的信息，使开发者能够在不同阶段处理网络请求。同理，在下载和上传过程中可以使用downloadProgress和uploadProgress信号来获取进度信息，readyRead信号表示有可读取的数据，error信号表示请求发生错误，sslErrors信号表示SSL相关的错误。

当信号被触发时则会通过QObject::connect连接到对应的槽函数上，如下案例中所示，在槽函数内通过reply->attribute方法我们获取到此次响应码中的QNetworkRequest::HttpStatusCodeAttribute属性，该属性用来指明本次访问的状态值。此类属性也有许多可供参考，如下所示；

这些属性提供了额外的信息，使得开发者能够更全面地了解和处理网络响应。根据具体的应用需求，开发者可以选择使用这些属性中的一个或多个来获取所需的信息。

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

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

    // 创建网络访问管理器
    QNetworkAccessManager manager;

    // 创建GET请求
    QNetworkRequest request(QUrl("http://www.baidu.com"));

    // 发送GET请求
    QNetworkReply *reply = manager.get(request);

    // 连接信号槽，处理响应
    QObject::connect(reply, &QNetworkReply::finished, [&]()
    {
        if (reply->error() == QNetworkReply::NoError)
        {
            // 获取请求的 URL
            qDebug() << "Request URL:" << reply->request().url();

            // 输出请求头信息
            qDebug() << "Request Headers:";
            QList<QByteArray> requestHeaders = reply->request().rawHeaderList();
            foreach (const QByteArray &header, requestHeaders) {
                qDebug() << header << ":" << reply->request().rawHeader(header);
            }

            // 获取响应码
            int statusCode = reply->attribute(QNetworkRequest::HttpStatusCodeAttribute).toInt();
            qDebug() << "HttpStatusCodeAttribute:" << statusCode;

            // 连接是否加密的标志
            bool connectionEncryptedAttribute = reply->attribute(QNetworkRequest::ConnectionEncryptedAttribute).toBool();
            qDebug() << "ConnectionEncryptedAttribute:" << connectionEncryptedAttribute;

            // 请求是否来自缓存的标志
            bool sourceIsFromCacheAttribute = reply->attribute(QNetworkRequest::SourceIsFromCacheAttribute).toBool();
            qDebug() << "SourceIsFromCacheAttribute:" << sourceIsFromCacheAttribute;

            // HTTP请求是否被允许进行流水线处理的标志
            bool httpPipeliningAllowedAttribute = reply->attribute(QNetworkRequest::HttpPipeliningAllowedAttribute).toBool();
            qDebug() << "HttpPipeliningAllowedAttribute:" << httpPipeliningAllowedAttribute;

            // 输出响应头信息
            qDebug() << "Response Headers:";
            QList<QByteArray> responseHeaders = reply->rawHeaderList();
            foreach (const QByteArray &header, responseHeaders) {
                qDebug() << header << ":" << reply->rawHeader(header);
            }

            // 处理响应内容，这里可以使用 readAll() 方法获取响应内容
            // qDebug() << "Response Content:" << reply->readAll();
        } else
        {
            qDebug() << "Error:" << reply->errorString();
        }

        // 释放资源
        reply->deleteLater();
        QCoreApplication::quit();
    });

    return a.exec();
}

读者可自行编译并运行这段代码，观察请求与相应数据如下图所示；

至于如何在图形界面中使用则就更简单了，首先我们在mainwindow.h头文件中定义好所需要的两个槽函数，函数on_finished()用于在完成请求后被调用，函数on_readyRead()则用于在回调被执行后调用，并并以两个网络管理类的指针变量，如下所示；

class MainWindow : public QMainWindow
{
    Q_OBJECT

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

private slots:
    //自定义槽函数
    void on_finished();
    void on_readyRead();

    void on_pushButton_clicked();

private:
    Ui::MainWindow *ui;
    QNetworkAccessManager networkManager;   // 网络管理
    QNetworkReply *reply;                   // 网络响应
};

当获取按钮被点击后则开始执行读入指定URL地址，并对该地址进行网页访问，同时绑定这两个信号，一旦被触发则自动路由到对应的槽函数上面去，如下所示；

void MainWindow::on_pushButton_clicked()
{
    // 读入URL地址
    QString urlSpec = ui->lineEdit->text().trimmed();
    if (urlSpec.isEmpty())
    {
        QMessageBox::information(this, "错误", "请指定URL");
        return;
    }

    // 格式化URL
    QUrl newUrl = QUrl::fromUserInput(urlSpec);
    if (!newUrl.isValid())
    {
        QMessageBox::information(this, "错误", QString("无效URL: %1").arg(urlSpec));
        return;
    }

    // 访问页面
    reply = networkManager.get(QNetworkRequest(newUrl));

    // 完成时的槽函数绑定
    connect(reply, SIGNAL(finished()), this, SLOT(on_finished()));

    // 读入数据的槽函数绑定
    connect(reply, SIGNAL(readyRead()), this, SLOT(on_readyRead()));

}

相对应的，在on_finished()槽函数中我们将响应头读出并输出到文本框中，在on_readyRead()槽函数中则是对整个网站页面源代码的输出功能，完整代码如下所示；

void MainWindow::on_finished()
{
    // 获取响应码
    int statusCode = reply->attribute(QNetworkRequest::HttpStatusCodeAttribute).toInt();

    if(statusCode == 200)
    {
        ui->plainTextEdit_2->appendPlainText("响应头数据:");
        // 输出响应头信息
        QList<QByteArray> responseHeaders = reply->rawHeaderList();
        foreach (const QByteArray &header, responseHeaders)
        {
            ui->plainTextEdit_2->appendPlainText(header + " : " + reply->rawHeader(header));
        }
    }
}

// 读入页面源代码
void MainWindow::on_readyRead()
{
    ui->plainTextEdit->setPlainText(reply->readAll());
}

运行代码，读者可自行输入特定的网站进行读取测试，如下所示（完整代码请参考课件部分）；