首页 Qt 学习之路 2 Qt 学习之路 2(65):访问网络(1)

Qt 学习之路 2(65):访问网络(1)

18 2.6K

现在的应用程序很少有纯粹单机的。大部分为了各种目的都需要联网操作。为此,Qt 提供了自己的网络访问库,方便我们对网络资源进行访问。本章我们将介绍如何使用 Qt 进行最基本的网络访问。

Qt 进行网络访问的类是QNetworkAccessManager,这是一个名字相当长的类,不过使用起来并不像它的名字一样复杂。为了使用网络相关的类,你需要在 pro 文件中添加QT += network

QNetworkAccessManager类允许应用程序发送网络请求以及接受服务器的响应。事实上,Qt 的整个访问网络 API 都是围绕着这个类进行的。QNetworkAccessManager保存发送的请求的最基本的配置信息,包含了代理和缓存的设置。最好的是,这个 API 本身就是异步设计,这意味着我们不需要自己为其开启线程,以防止界面被锁死(这里我们可以简单了解下,Qt 的界面活动是在一个主线程中进行。网络访问是一个相当耗时的操作,如果整个网络访问的过程以同步的形式在主线程进行,则当网络访问没有返回时,主线程会被阻塞,界面就会被锁死,不能执行任何响应,甚至包括一个代表响应进度的滚动条都会被卡死在那里。这种设计显然是不友好的。)。异步的设计避免了这一系列的问题,但是却要求我们使用更多的代码来监听返回。这类似于我们前面提到的QDialog::exec()QDialog::show()之间的区别。QNetworkAccessManager是使用信号槽来达到这一目的的。

一个应用程序仅需要一个QNetworkAccessManager类的实例。所以,虽然QNetworkAccessManager本身没有被设计为单例,但是我们应该把它当做单例使用。一旦一个QNetworkAccessManager实例创建完毕,我们就可以使用它发送网络请求。这些请求都返回QNetworkReply对象作为响应。这个对象一般会包含有服务器响应的数据。

下面我们用一个例子来看如何使用QNetworkAccessManager进行网络访问。这个例子不仅会介绍QNetworkAccessManager的使用,还将设计到一些关于程序设计的细节。

我们的程序是一个简单的天气预报的程序,使用 OpenWeatherMap 的 API 获取数据。我们可以在这里找到其 API 的具体介绍。

我们前面说过,一般一个应用使用一个QNetworkAccessManager就可以满足需要,因此我们自己封装一个NetWorker类,并把这个类作为单例。注意,我们的代码使用了 Qt5 进行编译,因此如果你需要将代码使用 Qt4 编译,请自行修改相关部分。

// !!! Qt5
#ifndef NETWORKER_H
#define NETWORKER_H

#include <QObject>

class QNetworkReply;

class NetWorker : public QObject
{
    Q_OBJECT
public:
    static NetWorker * instance();
    ~NetWorker();

    void get(const QString &url);
signals:
    void finished(QNetworkReply *reply);
private:
    class Private;
    friend class Private;
    Private *d;

    explicit NetWorker(QObject *parent = 0);
    NetWorker(const NetWorker &) Q_DECL_EQ_DELETE;
    NetWorker& operator=(NetWorker rhs) Q_DECL_EQ_DELETE;
};

#endif // NETWORKER_H

NetWorker是一个单例类,因此它有一个instance()函数用来获得这唯一的实例。作为单例模式,要求构造函数、拷贝构造函数和赋值运算符都是私有的,因此我们将这三个函数都放在 private 块中。注意我们增加了一个Q_DECL_EQ_DELETE宏。这个宏是 Qt5 新增加的,意思是将它所修饰的函数声明为 deleted(这是 C++11 的新特性)。如果编译器支持= delete语法,则这个宏将会展开为= delete,否则则展开为空。我们的NetWorker只有一个get函数,顾名思义,这个函数会执行 HTTP GET 操作;一个信号finished(),会在获取到服务器响应后发出。private 块中还有三行关于Private的代码:

class Private;
friend class Private;
Private *d;

这里声明了一个NetWorker的内部类,然后声明了这个内部类的 d 指针。d 指针是 C++ 程序常用的一种设计模式。它的存在于 C++ 程序的编译有关。在 C++ 中,保持二进制兼容性非常重要。如果你能够保持二进制兼容,则当以后升级库代码时,用户不需要重新编译自己的程序即可直接运行(如果你使用 Qt5.0 编译了一个程序,这个程序不需要重新编译就可以运行在 Qt5.1 下,这就是二进制兼容;如果不需要修改源代码,但是必须重新编译才能运行,则是源代码兼容;如果必须修改源代码并且再经过编译,例如从 Qt4 升级到 Qt5,则称二者是不兼容的)。保持二进制兼容的很重要的一个原则是不要随意增加、删除成员变量。因为这会导致类成员的寻址偏移量错误,从而破坏二进制兼容。为了避免这个问题,我们将一个类的所有私有变量全部放进一个单独的辅助类中,而在需要使用这些数据的类值提供一个这个辅助类的指针。注意,由于我们的辅助类是私有的,用户不能使用它,所以针对这个辅助类的修改不会影响到外部类,从而保证了二进制兼容。关于二进制兼容的问题,我们会在以后的文章中更详细的说明,这里仅作此简单介绍。

下面来看NetWorker的实现。

class NetWorker::Private
{
public:
    Private(NetWorker *q) :
        manager(new QNetworkAccessManager(q))
    {}

    QNetworkAccessManager *manager;
};

PrivateNetWorker的内部类,扮演者前面我们所说的那个辅助类的角色。NetWorker::Private类主要有一个成员变量QNetworkAccessManager *,把QNetworkAccessManager封装起来。NetWorker::Private需要其被辅助的类NetWorker的指针,目的是作为QNetworkAccessManager的 parent,以便NetWorker析构时能够自动将QNetworkAccessManager析构。当然,我们也可以通过将NetWorker::Private声明为QObject的子类来达到这一目的。

NetWorker *NetWorker::instance()
{
    static NetWorker netWorker;
    return &netWorker;
}

instance()函数很简单,我们声明了一个 static 变量,将其指针返回。这是 C++ 单例模式的最简单写法,由于 C++ 标准要求类的构造函数不能被打断,因此这样做也是线程安全的。

NetWorker::NetWorker(QObject *parent) :
    QObject(parent),
    d(new NetWorker::Private(this))
{
    connect(d->manager, &QNetworkAccessManager::finished,
            this, &NetWorker::finished);
}

NetWorker::~NetWorker()
{
    delete d;
    d = 0;
}

构造函数参数列表我们将 d 指针进行赋值。构造函数内容很简单,我们将QNetworkAccessManagerfinished()信号进行转发。也就是说,当QNetworkAccessManager发出finished()信号时,NetWorker同样会发出自己的finished()信号。析构函数将 d 指针删除。由于NetWorker::Private是在堆上创建的,并且没有继承QObject,所以我们必须手动调用delete运算符。

void NetWorker::get(const QString &url)
{
    d->manager->get(QNetworkRequest(QUrl(url)));
}

get()函数也很简单,直接将用户提供的 URL 字符串提供给底层的QNetworkAccessManager,实际上是将操作委托给底层QNetworkAccessManager进行。

现在我们将 QNetworkAccessManager进行了简单的封装。下一章我们开始针对 OpenWeatherMap 的 API 进行编码。

18 评论

hehuim 2013年10月11日 - 16:40

不是Q_DECL_DEPRECATED这个宏吧,应该是Q_DECL_EQ_DELETE吧,笔误了!

回复
豆子 2013年10月11日 - 20:29

感谢指出,已经修改过来了!

回复
李毅伟 2013年12月11日 - 10:14

豆子,能发个完整代码链接吗 非常需要!

回复
豆子 2013年12月11日 - 20:07

把文中的代码汇合在一起,添加头文件就是完整代码了。这个应该很容易修改的。

回复
kosl90 2014年3月28日 - 23:14

请问那个finished是神马情况,在构造函数中的那个信号连接报错,不知道该怎么解决==

回复
kosl90 2014年3月28日 - 23:53

==我愚蠢的少写了一个头文件

回复
john 2014年6月18日 - 23:06

博主 少的那个头文件是什么

回复
rainc 2014年6月22日 - 00:22

弱弱的问一下,不知道QT是怎么找到系统头文件的,还有,QT += network,为什么加了这个才能找到头文件,是不是系统头文件是在QT变量指定的这些模块文件中查找的,如果是这样,那么#include 是不是相当于#include ,但是我用后者的话还是会有很多的错误。必须要加QT += network。不是很明白。

回复
豆子 2014年6月24日 - 21:48

QT += network 的含义是将 network 模块加入编译系统。默认 Qt 是不加入 network 模块的,因为头文件位于响应模块中,所以搜索不到。这类似于动态链接库,要指明在哪一模块中寻找。

回复
2014年11月18日 - 11:52

NetWorker不能用单例模式,否则有可能造成崩溃。
static对象的析构在QApplication的exce之后,
QApplication的exce结束以后有些qt对象或线程会先析构。
这样在QNetworkAccessManager析构时会引用已经析构了的QObject对象

回复
zhaoyong 2015年11月8日 - 10:59

如果存在这个问题的话, 可否通过如下方式解决:
class NetWorker::Private {
public:
Private(NetWorker *q) :
manager(new QNetworkAccessManager ) {}
~Private() {
delete manager;
}
QNetworkAccessManager *manager;
};

回复
wuming123057 2015年3月6日 - 08:54

http://openweathermap.org/api

OpenWeatherMap API链接失效,上面为正确的连接

回复
guoyinbo2012 2016年3月25日 - 10:34

class QNetworkReply;这个类的实现在哪?

回复
guoyinbo2012 2016年3月25日 - 10:57

搞错了,知道了

回复
LaoSkiy 2016年7月18日 - 17:05

豆哥 这些项目都是基于Linux平台的还是基于window下的

回复
豆子 2016年7月18日 - 21:01

我是在 Windows 下测试的,Linux 可能需要修改一些,但不会太多,一般都是可以编译通过的

回复
ccppaa 2016年10月25日 - 09:05

大神,用qt编译别人的程序时,一直出现qlist.h:559: error: 'isLarge' is not a member of 'QTypeInfo'这个错误,包括qt的示例时也这样,要怎么弄

回复
豆子 2016年10月26日 - 22:06

尝试重新安装一下 Qt 试试,这个类是一个私有类,可能是由于某些原因导致 Qt 找不到这个类了

回复

回复 john 取消回复

关于我

devbean

devbean

豆子,生于山东,定居南京。毕业于山东大学软件工程专业。软件工程师,主要关注于 Qt、Angular 等界面技术。

主题 Salodad 由 PenciDesign 提供 | 静态文件存储由又拍云存储提供 | 苏ICP备13027999号-2