Qt 网络模块提供一些类来实现 OSI 七层网络模型中高层的网络协议,如 HTTP、FTP、SNMP 等,这些类主要是 QNetworkRequest、QNetworkAccessManager 和 QNetworkReply。QNetworkRequest 类
通过 URL 发起网络协议请求,其也保存网络请求的信息,目前支持 HTTP、 FTP 和本地文件 URL 的下载或上传。
QNetworkAccessManager 类
用于协调网络操作,在 QNetworkRequest 发起网络请求后, QNetworkAccessManager 负责发送网络请求,以及创建网络响应。
QNetworkReply 类
表示网络请求的响应,由 QNetworkAccessManager 在发送网络请求后创建网 络响应。QNetworkReply 提供的信号 finished()、readyRead()、downloadProgress()可用于监测网络响应的执行情况,从而进行相应的操作。
QNetworkReply 继承了QIODevice,因此也支持流数据读写功能。
HTTP网络文件下载示例
URL 里的 HTTP 地址可以表示 为任何类型的文件,如 html 文件、pdf 文件、doc 文件、exe 文件等。
主窗口头文件如下:
#ifndef MAINWINDOW_H
#define MAINWINDOW_H#include <QMainWindow>
#include <QNetworkAccessManager>
#include <QNetworkReply>
#include <QFile>
#include <QUrl>QT_BEGIN_NAMESPACE
namespace Ui { class MainWindow; }
QT_END_NAMESPACEclass MainWindow : public QMainWindow
{Q_OBJECT
private:QNetworkAccessManager networkManager; //网络管理QNetworkReply *reply; //网络响应QFile *downloadedFile; //下载保存的临时文件
public:MainWindow(QWidget *parent = nullptr);~MainWindow();private slots://自定义槽函数void do_finished();void do_readyRead();void do_downloadProgress(qint64 bytesRead, qint64 totalBytes);void on_btnDefaultPath_clicked();void on_btnDownload_clicked();void on_editURL_textChanged(const QString &arg1);
private:Ui::MainWindow *ui;
};#endif // MAINWINDOW_H
在构造函数中设置UI后无须其他初始化设置
MainWindow::MainWindow(QWidget *parent) :QMainWindow(parent),ui(new Ui::MainWindow)
{ui->setupUi(this);ui->editURL->setClearButtonEnabled(true);
}
设置默认下载保存路径
void MainWindow::on_btnDefaultPath_clicked()
{//"默认路径" 按钮QString curPath=QDir::currentPath();QDir dir(curPath);QString sub="temp";dir.mkdir(sub); //创建一个临时文件夹ui->editPath->setText(curPath+"/"+sub+"/");
}
在输入有效的URL后点击下载对应的槽函数如下:
void MainWindow::on_btnDownload_clicked()
{//"下载"按钮,开始下载QString urlSpec = ui->editURL->text().trimmed();if (urlSpec.isEmpty()){QMessageBox::information(this, "错误","请指定需要下载的URL");return;}QUrl newUrl = QUrl::fromUserInput(urlSpec); //转为URL地址if (!newUrl.isValid()) //检查有效性{QString info="无效URL:"+urlSpec+"\n错误信息:"+newUrl.errorString();QMessageBox::information(this, "错误",info);return;}QString tempDir =ui->editPath->text().trimmed(); //临时目录if (tempDir.isEmpty()) //检查路径{QMessageBox::information(this, "错误", "请指定保存下载文件的目录");return;}QString fullFileName =tempDir+newUrl.fileName(); //文件名if (QFile::exists(fullFileName))QFile::remove(fullFileName);downloadedFile =new QFile(fullFileName); //创建临时文件if (!downloadedFile->open(QIODevice::WriteOnly)){QMessageBox::information(this, "错误","临时文件打开错误");return;}ui->btnDownload->setEnabled(false);//发送网络请求,创建网络响应reply = networkManager.get(QNetworkRequest(newUrl));//读取下载数据:在缓冲区有新下载的数据等待读取时,QNetworkReply 会发射 readyRead()信号connect(reply, SIGNAL(readyRead()), this, SLOT(do_readyRead()));//获取下载进度:传递 bytesRead 和 totalBytes 两个参数,表示已读取字节数和总的字节数connect(reply, SIGNAL(downloadProgress(qint64,qint64)),this, SLOT(do_downloadProgress(qint64,qint64)));//网络响应结束:信号 finished()在下载结束后被发射connect(reply, SIGNAL(finished()), this, SLOT(do_finished()));
}
1、首先读取URL文本框中的字符串,并判断是否为空,不为空再将该字符串使用QUrl::fromUserInput转为QUrl 类型变量,并检查URL的有效性。
2、检查下载保存的目录是否有效,trimmed()函数用于移除字符串两端的空白字符,如空格、制表符、换行符等
3、使用QUrl::fileName()获取下载连接中的文件名,并创建QFile临时文件用于暂存下载数据。
4、完成以上步骤后使用QNetworkAccessManager 对象发布网络请求,请求下载 URL 表示的文件, 并创建网络响应。
在缓冲区有新下载的数据等待读取时,QNetworkReply 会发射 readyRead()信号;信号 downloadProgress()表示网络操作进度,传递 bytesRead 和 totalBytes 两个参数,表示已读取字节数和总的字节数;信号 finished()在下载结束后被发射,通常再这个函数中关闭并删除临时文件指针对象,删除网络响应对象。
最后用静态函数 QDesktopServices::openUrl()调用默认的应用软件打开下载的文件,例如下载的是一个 PDF 文件,会自动用系统的默认软件打开此文件。
void MainWindow::do_readyRead()
{//读取下载的数据downloadedFile->write(reply->readAll());
}void MainWindow::do_downloadProgress(qint64 bytesRead, qint64 totalBytes)
{//下载进度ui->progressBar->setMaximum(totalBytes);ui->progressBar->setValue(bytesRead);
}void MainWindow::do_finished()
{//网络响应结束QFileInfo fileInfo(downloadedFile->fileName()); //为了获取下载后的文件名downloadedFile->close();delete downloadedFile; //删除临时文件对象reply->deleteLater(); //由主事件循环删除此对象if (ui->chkBoxOpen->isChecked()) //打开下载的文件QDesktopServices::openUrl(QUrl::fromLocalFile(fileInfo.absoluteFilePath()));ui->btnDownload->setEnabled(true);
}
参考
QT6 C++开发指南