Qt网络编程之QNetworkAccessManager

       注意：这个类的所有函数都是可重入的。
       这个类是从Qt4.4引入的。

详细描述
      QNetworkAccessManager类允许应用程序发送网络请求和接收网络应答。
      Network Access API都是围绕着一个QNetworkAccessManager对象构造的，这个对象包含着发送请求的一些通用配置和设置。它包含着代理和缓存的配置，以及和这些事物相关的一些信号，并且应答信号可以作为我们检测一个网络操作的进度。
       一个QNetworkAccessManager对于一整个Qt应用程序来说已经足够了！
       一旦一个QNetworkAccessManager对象被创建了，那么应用程序就可以使用它在网络上发送请求。它提供了一组标准的函数，可以承载网络请求和一些可选的数据，并且每一个请求返回一个QNetworkReply对象。该返回的对象包含着返回的请求应带的所有数据。

    一个简单的从网络下载的例子可如下完成：
QNetworkAccessManager *manager = new QNetworkAccessManager(this);
 connect(manager, SIGNAL(finished(QNetworkReply*)),
         this, SLOT(replyFinished(QNetworkReply*)));

 manager->get(QNetworkRequest(QUrl("http://qt.nokia.com")));
 
    QNetworkAccessManager有一个异步的API。当上面的replyFinished槽被调用的时候，它带的参数就是包含有下载的数据
的QNetworkReply对象。

注意：当请求完成的时候，程序员需要在适当的时候删除QNetworkReply对象。不要在连接到信号finished()的槽函数中直接
删除掉。你可以使用deleteLater()函数。

注意：QNetworkAccessManager将会把它受到的请求排队。并行执行的请求数量是依赖于协议的。目前，对于桌面平台的HTTP协议，对于一个主机/端口的组合，可6个请求并行执行。

 

一个更加复杂的例子，假设manager已经存在，代码如下：
QNetworkRequest request;
 request.setUrl(QUrl("http://qt.nokia.com"));
 request.setRawHeader("User-Agent", "MyOwnBrowser 1.0");

 QNetworkReply *reply = manager->get(request);
 connect(reply, SIGNAL(readyRead()), this, SLOT(slotReadyRead()));
 connect(reply, SIGNAL(error(QNetworkReply::NetworkError)),
         this, SLOT(slotError(QNetworkReply::NetworkError)));
 connect(reply, SIGNAL(sslErrors(QList<QSslError>)),
         this, SLOT(slotSslErrors(QList<QSslError>)));
   
网络和漫游支持
       在Qt4.7版本中，QNetworkAccessManager有了额外的Bearer ManagementAPI支持，使得QNetworkAccessManager具有了管理管理网络连接的能力。
      QNetworkAccessManager可以在设备离线的时候启用网络接口，并且如果当前进程是最后一个使用网络的时候，QNetworkAccessManager可以停止网络接口。漫游在传输上是同样透明的。每一个入队/挂起的网络请求可以自动的传输到一个新的接入点。
      客户希望不作出任何改变就可以利用这个特性。实际上他就像把与特定平台相关的网络连接的代码从应用程序中
删除。

成员类型文档
enum QNetworkAccessManager::NetworkAccessibility
表明是否可以通过网络管理接入网络
Constant                                                                      Value                            Description
QNetworkAccessManager::UnknownAccessibility         -1              The network accessibility cannot be determined.
QNetworkAccessManager::NotAccessible                      0              The network is not currently accessible, either because there is currently no network coverage or network access has been explicitly disabled by a call to setNetworkAccessible().
QNetworkAccessManager::Accessible                           1               The network is accessible.

 

enum QNetworkAccessManager::Operation
表明这个对于一个应答的处理过程
Constant                             Value Description
QNetworkAccessManager::HeadOperation   1     retrieve headers operation (created with head())
QNetworkAccessManager::GetOperation       2     retrieve headers and download contents (created with get())
QNetworkAccessManager::PutOperation       3     upload contents operation (created with put())
QNetworkAccessManager::PostOperation   4     send the contents of an HTML form for processing via HTTP POST (created with post())
QNetworkAccessManager::DeleteOperation   5     delete contents operation (created with deleteResource())
QNetworkAccessManager::CustomOperation   6     custom operation (created with sendCustomRequest())

 

属性文档
networkAccessible : NetworkAccessibility
这个属性表明当前是否可以通过网络管理接入网络。
    如果网络不可接入，那么network access manager将不会处理任何新的网络请求，所有这些请求都会发生错误而失败。
那些以file:// scheme作为URLs的请求仍然会被处理。
    这个属性的默认值反应了设备的物理状态。应用程序可以通过如下操作来覆盖它的值以禁止任何网络请求。
networkAccessManager->setNetworkAccessible(QNetworkAccessManager::NotAccessible);
    我们可以通过如下调用来再次使能网络：
networkAccessManager->setNetworkAccessible(QNetworkAccessManager::Accessible);

注意：调用setNetworkAccessible()并不会改变网络状态。

 

 

Access functions:
NetworkAccessibility networkAccessible () const
void setNetworkAccessible ( NetworkAccessibility accessible )

Notifier signal:
void networkAccessibleChanged ( QNetworkAccessManager::NetworkAccessibility accessible )