Qt 之处理QNetworkAccessManager请求超时处理

老菜鸟的每一天

已于 2022-09-18 09:57:21 修改

阅读量1w

点赞数 10

分类专栏：《Qt 项目实战经历全记录》文章标签： qt http post get

于 2021-07-24 17:30:31 首次发布

本文链接：https://blog.csdn.net/u011942101/article/details/119061028

版权

《Qt 项目实战经历全记录》专栏收录该内容

98 篇文章 150 订阅

订阅专栏

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

文章目录

前言
一、QNetworkAccessManager相关信号
二、超时处理
总结

前言

项目中，需要用http，get post，去后端请求服务，而由于网络情况不定，在非常弱网的情况下，http长时间拿不到应答，所以项目需要自己手动做个计时，超过该时间主动放弃该请求。
qt中QNetworkAccessManager提供了非常方便的异步api，但是手动设置超时的相关接口，需要自己来实现。

提示：以下是本篇文章正文内容，下面案例可供参考

一、QNetworkAccessManager相关信号

QNetworkAccessManager * pManager = new QNetworkAccessManager(this);
QNetworkRequest request(url);
QNetworkReply *reply = pManager->get(request);
connect( reply , SIGNAL(uploadProgress(qint64,qint64)),this, SIGNAL(uploadProgress(qint64,qint64)) );
connect(reply , SIGNAL(downloadProgress(qint64,qint64)),SLOT(downloadProgress(qint64,qint64)));
connect(reply , SIGNAL(finished()),SLOT(downloadFinished()));
connect(reply , SIGNAL(readyRead()),SLOT(downloadReadyRead()));
connect(reply , SIGNAL(error(QNetworkReply::NetworkError)),SLOT(downloadError(QNetworkReply::NetworkError)));

downloadProgress,uploadProgress 用来监控当前下载或上传文件的进度
finished信号会在请求完成时发出
readyRead在下载过程中有数据到来时，可读出
error是当请求出错时发出

注意：本文中，超时处理会主动abort(); 调用abort()之后，会先发出error 然后发出 finished信号
导致error发出的原因有很多种，具体请看qt的帮助手册
在这里插入图片描述

二、超时处理

1.超时原因（参考过来的）

引起网络连接超时的原因很多，下面，列举一些常见的原因：

网络断开，经常显示无法连接
网络阻塞，导致你不能在程序默认等待时间内得到回复数据包
网络不稳定，网络无法完整传送服务器信息
系统问题，系统资源过低，无法为程序提供足够的资源处理服务器信息
设备不稳定，如网线松动、接口没插好等等网络注册时系统繁忙，无法回应
网速过慢，如使用 BT 多线程下载，在线收看视频等大量占用带宽的软件，若使用共享带宽还要防范他人恶意占用带宽
计算机感染了恶意软件，计算机病毒，计算机木马等 Qt 中的网络连接超时

在 Qt 中，关于 QNetworkAccessManager、QNetworkRequest 和 QNetworkReply 的文档中，找到了有关超时相关的错误 QNetworkReply::NetworkError。

常量 QNetworkReply::TimeoutError：

the connection to the remote server timed out

2.如何处理超时

解决思路：
使用 QTimer 启动一个单次定时器，并设置超时时间。
在事件循环退出之后，判断定时器的状态，如果是激活状态，证明请求已经完成；否则，说明超时。
来看一个简单的例子 - 获取 Qt 官网网页内容：

QTimer timer;
timer.setInterval(30000);  // 设置超时时间 30 秒
timer.setSingleShot(true);  // 单次触发
 
// 请求 Qt 官网
QNetworkAccessManager manager;
QNetworkRequest request;
request.setUrl(QUrl("http://qt-project.org"));
request.setRawHeader("User-Agent", "MyOwnBrowser 1.0");
 
QNetworkReply *pReply = manager.get(request);
 
QEventLoop loop;
connect(&timer, &QTimer::timeout, &loop, &QEventLoop::quit);
connect(pReply, &QNetworkReply::finished, &loop, &QEventLoop::quit);
timer.start();
loop.exec();  // 启动事件循环
 
if (timer.isActive()) {  // 处理响应
    timer.stop();
    if (pReply->error() != QNetworkReply::NoError) {
        // 错误处理
        qDebug() << "Error String : " << pReply->errorString();
    } else {
        QVariant variant = pReply->attribute(QNetworkRequest::HttpStatusCodeAttribute);
        int nStatusCode = variant.toInt();
        // 根据状态码做进一步数据处理
        //QByteArray bytes = pReply->readAll();
        qDebug() << "Status Code : " << nStatusCode;
    }
} else {  // 处理超时
    disconnect(pReply, &QNetworkReply::finished, &loop, &QEventLoop::quit);
    pReply->abort();
    pReply->deleteLater();
    qDebug() << "Timeout";
}

首先，定义一个 QTimer，设置超时时间为 30000 毫秒（30 秒）并设置为单次触发。然后，使用 QNetworkRequest 实现一个简单的网络请求，通过 QNetworkAccessManager::get() 开始获取 Qt 官网的 HTML 页面内容。因为请求过程是异步的，所以通过使用 QEventLoop 启动一个事件循环让其同步处理，并将 QTimer 的 timeout() 信号以及 QNetworkReply 的 finished() 信号连接至其 quit() 槽函数，保证在定时器过期之后或者网络响应完成后事件循环得到退出，不至于一直处于阻塞状态。

如上所述，事件循环退出的两种情况：

QTimer 30 秒到期，超时
网络连接响应完成
所以，当 QTimer::isActive() 激活的情况下，证明响应完成，还尚未超时。这时需要先调用 QTimer::stop() 来停止定时器，再对响做进一步处理。否则，进行超时处理 - QNetworkReply::abort() 立即中止操作并关闭网络连接。

3.封装类

既然以后会经常用到，那么还是提供一个封装类 QReplyTimeout 专门处理超时。

#include <QObject>
#include <QTimer>
#include <QNetworkReply>
 
class QReplyTimeout : public QObject {
 
    Q_OBJECT
 
public:
    QReplyTimeout(QNetworkReply *reply, const int timeout) : QObject(reply) {
        Q_ASSERT(reply);
        if (reply && reply->isRunning()) {  // 启动单次定时器
            QTimer::singleShot(timeout, this, SLOT(onTimeout()));
        }
    }
 
signals:
    void timeout();  // 超时信号 - 供进一步处理
 
private slots:
    void onTimeout() {  // 处理超时
        QNetworkReply *reply = static_cast<QNetworkReply*>(parent());
        if (reply->isRunning()) {
            reply->abort();
            reply->deleteLater();
            emit timeout();
        }
    }
};

由于 QNetworkReply 和 QReplyTimeout 是父子关系，所以 QReplyTimeout 将被自动销毁。

使用起来非常简单：

QNetworkAccessManager *pManger = new QNetworkAccessManager(this);
QNetworkReply *pReply = pManger->get(QNetworkRequest(QUrl("https://www.google.com")));
QReplyTimeout *pTimeout = new QReplyTimeout(pReply, 1000);
// 超时进一步处理
connect(pTimeout, &QReplyTimeout::timeout, [=]() {
    qDebug() << "Timeout";
});

如果对 Google 的获取未在 1000 毫秒（1 秒）内完成，则会中止，并发出 timeout() 信号，供进一步处理（例如：提示用户请求超时）

总结

提示：自己对该封装类结合项目做了些修改

#ifndef QREPLYTIMER_H
#define QREPLYTIMER_H

#include <QObject>
#include <QTimer>
#include <QNetworkReply>

class QReplyTimeout : public QObject {

    Q_OBJECT

public:
    QReplyTimeout(QNetworkReply *reply, const int timeout) : QObject(reply) {
        Q_ASSERT(reply);
        if (reply && reply->isRunning()) {  // 启动单次定时器
            timer.setInterval(timeout);
            timer.setSingleShot(true);
            connect(&timer,SIGNAL(timeout()),this,SLOT(onTimeout()));
            timer.start();
            //QTimer::singleShot(timeout, this, SLOT(onTimeout()));
        }
    }

    bool isTimerActive()
    {
        return  timer.isActive();
    }

    void stopTimer()
    {
        timer.stop();
    }
signals:
    void timeout();  // 超时信号 - 供进一步处理

private slots:
    void onTimeout() {  // 处理超时
        QNetworkReply *reply = static_cast<QNetworkReply*>(parent());
        if (reply->isRunning()) {
            reply->abort();
            reply->deleteLater();
            emit timeout();
        }
    }

private:
    QTimer timer;
};

#endif // QREPLYTIMER_H

用法：


```cpp
QPointer<QNetworkReply > pNetworkResponse = m_pmanager->post(request,multiPart);
QReplyTimeout *pTimeout = new QReplyTimeout(pNetworkResponse, 10000);
// 超时进一步处理
connect(pTimeout, &QReplyTimeout::timeout, [=]() {
        qDebug() << "QReplyTimeout ";
    });
connect(pNetworkResponse, SIGNAL(error(QNetworkReply::NetworkError)),
            this, SLOT(httpError(QNetworkReply::NetworkError)));
QObject::connect(pNetworkResponse, &QNetworkReply::finished, [=]()mutable{
        file->close();
        delete file;
        file = NULL;
		 //未超时
        if(pTimeout->isTimerActive())
        {
            pTimeout->stopTimer();
        }     
}

方式2：

connect(&m_networkManager, SIGNAL(finished(QNetworkReply *)), this, SLOT(replyFinished(QNetworkReply *)));
void MainWindow::replyFinished(QNetworkReply *reply)
{

    // 获取响应状态码，200表示正常
    // QVariant nCode = reply->attribute(QNetworkRequest::HttpStatusCodeAttribute);

    if (reply->error() == QNetworkReply::NoError)
    {
        QByteArray bytes = reply->readAll();
    }
    else
    {
        // 错误处理-显示错误信息
        qDebug() <<  reply->error() ; //errorstring
    }
}

老菜鸟的每一天

关注

10
点赞
踩
66

收藏

觉得还不错? 一键收藏
3
评论
Qt 之处理QNetworkAccessManager请求超时处理

QNetworkAccessManager 超时处理及正确响应文章目录前言一、QNetworkAccessManager相关信号二、超时处理1.超时原因（参考过来的）2.如何处理超时3.封装类总结前言项目中，需要用http，get post，去后端请求服务，而由于网络情况不定，在非常弱网的情况下，http长时间拿不到应答，所以项目需要自己手动做个计时，超过该时间主动放弃该请求。qt中QNetworkAccessManager提供了非常方便的异步api，但是手动设置超时的相关接口，需要自己来实现
复制链接

扫一扫