QHttp是Qt所提供有关网络的高阶API,可以协助我们进行HTTP协议的进行,QHttp发出请求时是非同步的,请求的过程中会发出相关的Signal,我们可以用Slot来接收这些Signal,并进行相关的处理。
以下先示范一个最基本的QHttp使用,程序将设计一个HttpGet类:
HttpGet.h
Cpp代码#ifndef HTTPGET_H
#define HTTPGET_H
#include <QObject>
class QUrl;
class QHttp;
class QFile;
class HttpGet : public QObject {
Q_OBJECT
public:
HttpGet(QObject *parent = 0);
void downloadFile(const QUrl &url);
signals:
void finished();
private slots:
void done(bool error);
private:
QHttp *http;
QFile *file;
};
#endif
这个HttpGet可以让我们指定文件的URL地址,以HTTP方式取得文件并存储在本地,URL在Qt中以QUrl代表,当文件下载完成时,会发出finished()的Signal,当QHttp所指定的全部请求完成时,会发出done()的Signal,HTTPGet类中自定义的Slot就是用来接收QHttp的done() Signal以进行相关处理的,这可以在HttpGet的实现中看到:
HttpGet.cpp:
Cpp代码#include <QtNetwork>
#include <QFile>
#include <iostream>
#include "HttpGet.h"
using namespace std;
HttpGet::HttpGet(QObject *parent) : QObject(parent)
{
http = new QHttp(this);
connect(http, SIGNAL(done(bool)), this, SLOT(done(bool)));
}
void HttpGet::downloadFile(const QUrl &url)
{
QFileInfo fileInfo(url.path());
QString fileName = fileInfo.fileName();
if(fileName.isEmpty())
{
fileName = "index.html";
}
file = new QFile(fileName);
if(!file->open(QIODevice::WriteOnly))
{
cerr<<"Unable to save the file"<<endl;
delete file;
file = 0;
return;
}
http->setHost(url.host(), url.port(80));
http->get(url.path(), file);
http->close();
}
void HttpGet::done(bool error)
{
if(error)
{
cerr<<"Error: "<<qPrintable(http->errorString())<<endl;
}
else
{
cerr<<"File downloaded as "<<qPrintable(file->fileName())<<endl;
}
file->close();
delete file;
file = 0;
emit finished();
}
要使用Qt的网络相关类必须引进QtNetwork,并且必须在pro文件中加入以下这行以在构建过程中使用Qt的网络组件: Cpp代码 QT += network QT += network当调用HttpGet类的downloadFile()方法时,程序中使用QUrl的path()来取得路径信息,如果路径信息中没有包括文件名,就使用预设的"index.html"作为请求的对象及下载后存档时的文件名,要使用QHttp来请求文件时,必须使用setHost()来设定主机及端口号信息,接着使用get()方法发出请求,并通知下载的文件要到哪个QFile来存储。
当QHttp所有请求处理完毕后,会发出done()的Signal,程序中将之连接到HttpGet的done()来处理,处理完成后再发出finished的Signal。
以下是个测试类:
Cpp代码#include <QCoreApplication>
#include <QUrl>
#include "HttpGet.h"
#include <iostream>
using namespace std;
int main(int argc, char *argv[])
{
QCoreApplication app(argc, argv);
HttpGet getter;
getter.downloadFile(QUrl("Http://www.iprai.com/index.html"));
QObject::connect(&getter, SIGNAL(finished()), &app, SLOT(quit()));
return app.exec();
}
程序中将HttpGet的finished()的Signal连接到QCoreApplication的quit(),如此当下载文件完成后,可以直接关闭程序。
Qt的QHttp与QFtp在使用上有许多类似的地方,可以在以上的实例中看到一些特性,以下整理出相关的特性:
1) 非阻塞行为,请求时非同步的。
2) 我们可以设定一连串的请求,每个请求都有一个Command ID,QHttp的requestStarted()与requestFinished()等Signal会带有请求的Command ID,我们可以用以追踪骑请求的执行。
3) 在数据传输过程中,有相关的Signal可以追踪进度,像是QHttp的dataReadProgress()、dataSendProgress()等Signal。
4) 支援QIODevice的写入和读取,还有以QByteArray为基础的API。