第32篇 网络（二）HTTP
HTTP版权声明
该文章原创于Qter开源社区（www.qter.org），作者yafeilinux，转载请注明出处！
导语
HTTP（HyperText Transfer Protocol，超文本传输协议）是一个客户端和服务器端请求和应答的标准。在Qt的网络模块中提供了网络访问接口来实现HTTP编程。网络访问接口是执行一般的网络操作的类的集合，该接口在特定的操作和使用的协议（例如，通过HTTP进行获取和发送数据）上提供了一个抽象层，只为外部暴露出了类、函数和信号。上一节中我们已经提到过了，现在Qt中使用QNetworkAccessManager类和QNetworkReply类来进行HTTP的编程。网络请求由QNetworkRequest类来表示，它也作为与请求有关的信息（例如，任何头信息和使用加密）的容器。在创建请求对象时指定的URL决定了请求使用的协议，目前支持HTTP、FTP和本地文件URLs的上传和下载。QNetworkAccessManager类用来协调网络操作，每当一个请求创建后，该类用来调度它，并发射信号来报告进度。该类还协调cookies的使用，身份验证请求，及其代理的使用等。对于网络请求的应答使用QNetworkReply类表示，它会在请求被完成调度时由QNetworkAccessManager来创建。QNetworkReply提供的信号可以用来单独的监视每一个应答。 下面我们先讲解一个简单下载网页的例子，然后将其扩展为可以下载任何文件。
环境：Windows Xp + Qt 4.8.5+Qt Creator 2.8.0
目录
一、简单的网页浏览功能二、实现下载文件功能
正文
一、简单的网页浏览功能
1.新建Qt Gui应用，项目名称为http，基类使用默认的QMainWindow即可，类名为MainWindow。
2.完成后打开http.pro文件，然后添加下面一行代码来使用网络模块：QT+= network 然后保存该文件。
3.下面打开mainwindow.ui文件进入设计模式，向界面上添加一个Text Browser部件。效果如下图所示。
4.打开mainwindow.h文件，先包含头文件：#include <QtNetwork>然后添加一个private私有对象定义：QNetworkAccessManager *manager; 最后添加一个私有槽声明：private slots: void replyFinished(QNetworkReply *);
5.下面到mainwindow.cpp文件中，先在构造函数中添加如下代码：
manager = new QNetworkAccessManager(this);connect(manager, SIGNAL(finished(QNetworkReply*)),this,SLOT(replyFinished(QNetworkReply*)));manager->get(QNetworkRequest(QUrl("http://www.qter.org")));
这里先创建了一个QNetworkAccessManager类的实例，它用来发送网络请求和接收应答。然后关联了管理器的finished()信号和我们自定义的槽，每当网络应答结束时都会发射这个信号。最后使用了get()函数来发送一个网络请求，网络请求使用QNetworkRequest类表示，get()函数返回一个QNetworkReply对象。除了get()函数，管理器还提供了发送HTTP POST请求的post()函数。
6.下面添加槽的定义：void MainWindow::replyFinished(QNetworkReply *reply){ QTextCodec *codec = QTextCodec::codecForName("utf8"); QString all = codec->toUnicode(reply->readAll()); ui->textBrowser->setText(all); reply->deleteLater();}
因为QNetworkReply继承自QIODevice类，所以可以操作一般的I/O设备一样来操作该类。这里使用了readAll()函数来读取所有的应答数据，为了正常显示中文，使用了QTextCodec类来转换编码。在完成数据的读取后，需要使用deleteLater()来删除replay对象。
7.因为这里使用了QtextCodec类，所以还需要在mainwindow.cpp文件中包含头文件#include <QTextCodec> 下面运行程序，效果如下图所示。
这里再将整个过程简答叙述一遍：上面实现了最简单的应用HTTP协议下载网页的功能。QNetworkAccessManager类用于发送网络请求和接受回复，具体来说，它是用QNetworkRequest 类来管理请求，QNetworkReply类进行接收回复，并对数据进行处理。在上面的代码中，我们使用了下面的代码来发送请求：
manager->get(QNetworkRequest(QUrl("http://www.qter.org")));
它返回一个QNetworkReply对象，这个后面再讲。我们只需知道只要发送请求成功，它就会下载数据。而当数据下载完成后，manager会发出finished()信号，我们关联了该信号：
connect(manager, SIGNAL(finished(QNetworkReply*)),this,SLOT(replyFinished(QNetworkReply*)));
也就是说，当下载数据结束时，就会执行replyFinished()函数。在这个函数中我们对接收的数据进行处理：
QTextCodec *codec = QTextCodec::codecForName("utf8");QString all = codec->toUnicode(reply->readAll());ui->textBrowser->setText(all);
这里，为了能显示下载的网页中的中文，我们使用了QTextCodec 类对象，应用utf8编码。使用reply->readAll()函数就可以将下载的所有数据读出。然后，我们在textBrowser中将数据显示出来。当reply对象已经完成了它的功能时，我们需要将它释放，就是最后一条代码：reply->deleteLater();
二、实现下载文件功能
通过上面的例子可以看到，Qt中编写基于HTTP协议的程序是十分简单的，只有十几行代码。不过，一般我们下载文件都想要看到下载进度。下面我们就更改上面的程序，让它可以下载任意的文件，并且显示下载进度。
1.进入设计模式，删除以前的Text Browser部件，然后拖入一个Line Edit，一个Label，一个Progress Bar和一个Push Button，设计界面如下图所示。
2. 在写代码之前，我们先介绍一下整个程序执行的流程：开始我们先让进度条隐藏。当我们在Line Edit中输入下载地址，点击下载按钮后，我们应用输入的下载地址，获得文件名，在磁盘上新建一个文件，用于保存下载的数据，然后进行链接，并显示进度条。在下载过程中，我们将每次获得的数据都写入文件中，并更新进度条，在接收完文件后，我们重新隐藏进度条，并做一些清理工作。根据这个思路，我们开始代码的编写。
3.到mainwindow.h中，首先添加public函数声明：void startRequest(QUrl url); //请求链接
然后添加几个private变量和对象定义：QNetworkReply *reply;QUrl url; //存储网络地址QFile *file;//文件指针
最后到private slots中，删除前面的replyFinished(QNetworkReply *)槽声明，并添加如下代码：private slots: void on_pushButton_clicked();//下载按钮的单击事件槽函数 void httpFinished();//完成下载后的处理 void httpReadyRead();//接收到数据时的处理 void updateDataReadProgress(qint64, qint64); //更新进度条
4. 下面到mainwindow.cpp文件中，将前面在构造函数中添加的内容删除，然后添加如下代码：manager = new QNetworkAccessManager(this);ui->progressBar->hide();我们在构造函数中先隐藏进度条。等开始下载时再显示它。
5. 下面将前面程序中添加的replyFinished()函数的定义删除，然后添加新的函数的定义。先添加网络请求函数的实现：void MainWindow::startRequest(QUrl url){ reply = manager->get(QNetworkRequest(url)); connect(reply, SIGNAL(readyRead()), this, SLOT(httpReadyRead()));
connect(reply, SIGNAL(downloadProgress(qint64, qint64)), this, SLOT(updateDataReadProgress(qint64, qint64)));
connect(reply, SIGNAL(finished()), this, SLOT(httpFinished()));}
这里使用了get()函数来发送网络请求，然后进行了QNetworkReply对象的几个信号和自定义槽的关联。其中readyRead()信号继承自QIODevice类，每当有新的数据可以读取时，都会发射该信号；每当网络请求的下载进度更新时都会发射downloadProgress()信号，它用来更新进度条；每当应答处理结束时，都会发射finished()信号，该信号与前面程序中QNetworkAccessManager类的finished()信号作用相同，只不过是发送者不同，参数也不同而已。下面添加几个槽的定义。void MainWindow::httpReadyRead(){ if (file) file->write(reply->readAll());}
这里先判断是否创建了文件，如果是，则读取返回的所有数据，然后写入到文件。该文件是在后面的“下载”按钮单击信号槽中创建并打开的。
void MainWindow::updateDataReadProgress(qint64 bytesRead, qint64 totalBytes){ ui->progressBar->setMaximum(totalBytes); ui->progressBar->setValue(bytesRead);}
这里设置了一下进度条的最大值和当前值。void MainWindow::httpFinished(){ ui->progressBar->hide(); file->flush(); file->close(); reply->deleteLater(); reply = 0; delete file; file = 0;}
当完成下载后，重新隐藏进度条，然后删除reply和file对象。下面是“下载”按钮的单击信号的槽：void MainWindow::on_pushButton_clicked(){ url = ui->lineEdit->text(); QFileInfo info(url.path()); QString fileName(info.fileName()); if (fileName.isEmpty()) fileName = "index.html"; file = new QFile(fileName); if(!file->open(QIODevice::WriteOnly)) { qDebug() << "file open error"; delete file; file = 0; return; } startRequest(url); ui->progressBar->setValue(0); ui->progressBar->show();}
这里使用要下载的文件名创建了本地文件，然后使用输入的url进行了网络请求，并显示进度条。
6.下面运行程序，我们先输入www.yafeilinux.com的网址，下面一个网页。效果如下图所示。
完成后，可以尝试输入一个文件的下载地址，比如这里输入了《Qt Creator快速入门》一书在百度网盘上的地址，效果如下图所示。
7.最后，可以去项目编译生成的文件目录中查看下载的文件（我这里是E:\http-build-桌面-Debug），可以看到下载的文件，如下图所示。
结语
HTTP应用的内容就讲到这里，可以看到它是很容易的，也不需要大家了解太多的HTTP的原理知识。关于相关的类的其他使用，也可以查看其帮助文档。在上面的例子中，我们只是为了讲解知识，所以程序不是很完善，对于一个真正的工程，还是需要注意更多其他细节的，大家可以查看一下Qt演示程序HTTP Client的源代码。
涉及到的源码：
上一篇： 第31篇 网络（一）Qt网络编程简介
下一篇：
返回：系列教程目录
:(为什么我的压缩文件下载过来格式不对。。 MLTRwhy 发表于 2013-8-30 10:51 static/image/common/back.gif
为什么我的压缩文件下载过来格式不对。。
什么格式不对，源码吗？ yafeilinux 发表于 2013-9-2 13:59 static/image/common/back.gif
什么格式不对，源码吗？
是程序下载的文件。下载文件功能的时候按照那个URL地址下来的东西 MLTRwhy 发表于 2013-9-2 14:25 static/image/common/back.gif
是程序下载的文件。下载文件功能的时候按照那个URL地址下来的东西
哦。我这里下载压缩文件你看截图应该是没有问题的。
你可以下载其他文件试试，或者下载文件后试试是否可以打开。 xflcx1991 发表于 2013-10-14 14:43 static/image/common/back.gif
我这里和楼主一样的情况。我试了一下，也是下载例子中的百度网盘的《Qt Creator快速入门》。下回来后，是 ...
嗯。手动添加一个.rar或者.zip后缀，看看是否可以。 QTextCodec *codec = QTextCodec::codecForName("utf8");应该是： QTextCodec *codec = QTextCodec::codecForName("GB2312");或者 GB18030. koolar 发表于 2013-11-12 02:38 static/image/common/back.gif
QTextCodec *codec = QTextCodec::codecForName("utf8");应该是： QTextCodec *codec = QTextCodec::code ...
可以根据版本和环境的不同进行选择。 void MainWindow::startRequest(QUrl url){
reply = manager->get(QNetworkRequest(url));
connect(reply , SIGNAL(readyRead()) , this , SLOT(httpReadyRead()));
connect(reply , SIGNAL(downloadProgress(qint64 , qint64)) , this , SLOT(updateDataReadProgress(qint64 , qint64)));
connect(reply , SIGNAL(finished()) , this , SLOT(httpFinished()));
}
当reply这一句放在connect语句后面的时候程序会异常退出，请问connect语句的放置位置有什么规定吗？ 将明 发表于 2014-5-23 21:14 static/image/common/back.gif
void MainWindow::startRequest(QUrl url){
reply = manager->get(QNetworkRequest(url));
connect ...
这里在connect里面用到了reply，如果reply没有定义就使用，当然是会出现问题的。 安装过程，可以运行，可为什么会有下面的输出信息呢？？？
6576: on_startup
6576: on_startup
QFSFileEngine::open: No file name specified
QFSFileEngine::open: No file name specified BruceLi 发表于 2014-5-31 15:26 static/image/common/back.gif
安装过程，可以运行，可为什么会有下面的输出信息呢？？？
6576: on_startup
6576: on_startup
同问，简单的网页浏览功能可以浏览，不过却有很多QFSFileEngine:pen: No file name specified这个错误，这是什么原因 只能下载154字节大小，如何解决 BruceLi 发表于 2014-5-31 15:26 static/image/common/back.gif
安装过程，可以运行，可为什么会有下面的输出信息呢？？？
6576: on_startup
6576: on_startup
@Raincchina 这个不是错误，是警告吧，不影响程序运行的。 mustconfient 发表于 2014-6-23 16:07 static/image/common/back.gif
只能下载154字节大小，如何解决
下面网页，还是什么？ 看到这一节才发现因为自己权限不够才没看到楼主贴的图 求教一下Qt5.3是不是有一些区别了？好像无法使用QtNetwork这个头文件 tk1223108078 发表于 2014-8-10 19:00 static/image/common/back.gif
求教一下Qt5.3是不是有一些区别了？好像无法使用QtNetwork这个头文件
嗯。这个教程最好用Qt 4. tk1223108078 发表于 2014-8-10 19:00 static/image/common/back.gif
求教一下Qt5.3是不是有一些区别了？好像无法使用QtNetwork这个头文件
QT+= network ,需要加上这个 楼主，你好，我使用的是QT4，按照上述您说的，下载一个简单的文件时，为什么编译的时候还是会提示：无法打开包括文件“QtNetwork”，是我的QT安装的不正确么？