1.综述
QNetworkReply类包含用QNetworkAccessManager发送的请求的数据和报头
QNetworkReply类包含与QNetworkAccessManager发布的请求相关的数据和元数据。像QNetworkRequest一样,它包含一个URL和报头(以解析的和原始的形式),一些关于应答状态的信息和应答本身的内容。
QNetworkReply是一个顺序访问的QIODevice,这意味着一旦从对象中读取数据,它就不再被设备保存。因此,如果需要,应用程序有责任保存这些数据。每当从网络接收并处理更多数据时,就会发出readyRead()信号。
当接收到数据时,downloadProgress()信号也会发出,但如果对内容进行了任何转换(例如,解压和删除协议开销),则其中包含的字节数可能不代表实际接收的字节数。
即使QNetworkReply是一个连接到应答内容的QIODevice,它也会发出uploadProgress()信号,该信号指示具有此类内容的操作的上传进度。
注意:不要删除连接到error()或finished()信号的槽中的对象。应该使用deleteLater()。
参见QNetworkRequest和QNetworkAccessManager。
2.重要的信号
void downloadProgress(qint64 bytesReceived, qint64 bytesTotal)
发出这个信号是为了指示这个网络请求的下载部分的进度(如果有的话)。如果没有与此请求相关的下载,这个信号将被发送一次,并以0作为bytesReceived和bytestal的值。
bytesReceived参数表示接收的字节数,而bytestal表示预期下载的总字节数。如果不知道要下载的字节数,bytesTotal将为-1。
当bytesReceived等于bytestal时,下载结束。到那时,bytesTotal将不会是-1。
注意bytesReceived和bytestal的值可能不同于size(),通过read()或readAll()获得的总字节数,或头的值(ContentLengthHeader)。这样做的原因是可能会有协议开销,或者在下载过程中数据可能被压缩。
想要获取更多信息,课查阅uploadProgress()和bytesAvailable()。
void encrypted()
这个信号在SSL/TLS会话成功完成初始握手时发出。此时,还没有传输用户数据。该信号可用于对证书链执行额外的检查,例如在网站的证书更改时通知用户。如果应答不符合预期的条件,那么它应该通过一个连接到这个信号的槽调用QNetworkReply::abort()来中止。使用中的SSL配置可以使用QNetworkReply::sslConfiguration()方法检查。
在内部,QNetworkAccessManager可以打开到服务器的多个连接,以便允许它并行处理请求。这些连接可以被重用,这意味着不会发出encrypted()信号。这意味着,在QNetworkAccessManager的生命周期中,您只保证在第一次连接到站点时收到此信号。
请参见QSslSocket::encrypted()和QNetworkAccessManager::encrypted()。
void error(QNetworkReply::NetworkError code)
当应答检测到处理中的错误时,就会发出这个信号。finished()信号可能随后出现,指示连接结束。
code参数包含检测到的错误的代码。调用errorString()以获得错误条件的文本表示。
注意:不要删除连接到该信号的槽中的对象。应该使用deleteLater()。
注意:本信号在这个类中是重载的。要使用函数指针语法连接到这个函数,你必须在静态转换中指定信号类型,如下例所示:
connect(networkReply, static_cast<void(QNetworkReply::*)(QNetworkReply::NetworkError)>(&QNetworkReply::error),
[=](QNetworkReply::NetworkError code){ /* ... */ });
void finished()
该信号在应答完成处理时发出。在发出此信号后,应答的数据或元数据将不再有更新。
除非调用了close()或abort(),否则应答仍将打开以供读取,因此可以通过调用read()或readAll()来检索数据。特别是,如果readyRead()没有调用read(),则调用readAll()将检索QByteArray中的全部内容。
这个信号是与QNetworkAccessManager::finished()一起发出的,在QNetworkAccessManager::finished()中,信号的reply参数就是这个对象。
注意:不要删除连接到该信号的槽中的对象。应该使用deleteLater()。
您还可以使用isFinished()来检查QNetworkReply是否已经完成,甚至在您收到finished()信号之前。
请参见setFinished(), QNetworkAccessManager::finished()和isFinished()。
void metaDataChanged()
每当此应答中的元数据发生更改时,就会发出此信号。元数据是不是内容(数据)本身的任何信息,包括网络头。在大多数情况下,元数据在接收到数据的第一个字节时就已经完全知道了。但是,在数据处理期间,可以接收头或其他元数据的更新。
参见header(), rawHeaderList(), rawHeader()和hasRawHeader()。
void preSharedKeyAuthenticationRequired(QSslPreSharedKeyAuthenticator *authenticator)
如果SSL/TLS握手协商PSK密码套件,则会发出该信号,因此需要进行PSK身份验证。
当使用PSK时,客户端必须向服务器发送一个有效的身份和一个有效的预共享密钥,以便SSL握手继续。应用程序可以在连接到该信号的槽中提供此信息,方法是根据它们的需要填充所传递的验证器对象。
注意:忽略这个信号,或者不能提供所需的凭证,将导致握手失败,因此连接将被中止。
注意:authenticator对象由reply拥有,应用程序不能删除它。
void redirectAllowed()
当处理redirected()信号的客户端代码验证了新URL后,它会发出这个信号,以允许继续重定向。该协议适用于重定向策略为“QNetworkRequest::userverifiedredirectpolicy”的网络请求。
void redirected(const QUrl &url)
如果在请求中设置了QNetworkRequest::FollowRedirectsAttribute,并且服务器用3xx状态(特别是301、302、303、305、307或308状态码)响应,在位置报头中使用一个有效的url,指示HTTP重定向,则会发出这个信号。url参数包含服务器在位置报头中返回的新重定向url。
void sslErrors(const QList<QSslError> &errors)
如果SSL/TLS会话在设置过程中遇到错误,包括证书验证错误,则会发出此信号。errors参数包含错误列表。
为了表明错误不是致命的,并且连接应该继续,应该从连接到这个信号的槽调用ignoreSslErrors()函数。如果没有调用它,SSL会话将在交换任何数据(包括URL)之前被拆除。
此信号可用于向用户显示一条错误消息,表明安全性可能受到损害,并显示SSL设置(请参阅sslConfiguration()获取该设置)。如果用户决定在分析远程证书之后继续,那么插槽应该调用ignoreSslErrors()。
void uploadProgress(qint64 bytesSent, qint64 bytesTotal)
发出这个信号是为了指示这个网络请求的上传部分的进度(如果有的话)。如果没有与此请求关联的上传,则不会发出此信号。
bytesSent表示已上传的字节数,bytesTotal表示上传的总字节数。如果无法确定要上传的字节数,bytesTotal将为-1。
当bytesSent等于bytesTotal时,上传完成。到那时,bytesTotal将不会是-1。