原文： http://zetcode.com/pyqt/qnetworkaccessmanager/

PyQt 教程中的QNetworkAccessManager展示了如何显示如何使用QNetworkAccessManager发送请求和接收响应。

QNetworkAccessManager

QNetworkAccessManager允许应用发送网络请求和接收回复。 QNetworkRequest保留要与网络管理器发送的请求，QNetworkReply包含返回的数据和响应头。

QNetworkAccessManager具有异步 API，这意味着其方法总是立即返回，并且不等到完成时才返回。 而是在请求完成时发出信号。 我们通过附加到完成信号的方法来处理响应。

HTTP GET 请求

HTTP GET 方法请求指定资源的表示形式。

get_request.py

  1. #!/usr/bin/python3
  2. # -*- coding: utf-8 -*-
  4. '''
  5. QNetworkAccessManager in PyQt
  7. In this example we get a web page.
  9. Author: Jan Bodnar
  10. Website: zetcode.com
  11. Last edited: September 2017
  12. '''
  14. from PyQt5 import  QtNetwork
  15. from PyQt5.QtCore import QCoreApplication, QUrl
  16. import sys
  18. class Example:
  20.     def __init__(self):    
  22.         self.doRequest()
  24.     def doRequest(self):   
  26.         url = "http://www.something.com"
  27.         req = QtNetwork.QNetworkRequest(QUrl(url))
  29.         self.nam = QtNetwork.QNetworkAccessManager()
  30.         self.nam.finished.connect(self.handleResponse)
  31.         self.nam.get(req)    
  33.     def handleResponse(self, reply):
  35.         er = reply.error()
  37.         if er == QtNetwork.QNetworkReply.NoError:
  39.             bytes_string = reply.readAll()
  40.             print(str(bytes_string, 'utf-8'))
  42.         else:
  43.             print("Error occured: ", er)
  44.             print(reply.errorString())
  46.         QCoreApplication.quit()    
  48. app = QCoreApplication([])
  49. ex = Example()
  50. sys.exit(app.exec_())

该示例检索指定网页的 HTML 代码。

  1. url = "http://www.something.com"
  2. req = QtNetwork.QNetworkRequest(QUrl(url))

使用QNetworkRequest，我们将请求发送到指定的 URL。

  1. self.nam = QtNetwork.QNetworkAccessManager()
  2. self.nam.finished.connect(self.handleResponse)
  3. self.nam.get(req)

创建一个QNetworkAccessManager对象。 请求完成后，将调用handleResponse()方法。 使用get()方法触发该请求。

  1. def handleResponse(self, reply):
  3.     er = reply.error()
  5.     if er == QtNetwork.QNetworkReply.NoError:
  7.         bytes_string = reply.readAll()
  8.         print(str(bytes_string, 'utf-8'))
  10.     else:
  11.         print("Error occured: ", er)
  12.         print(reply.errorString())
  14.     QCoreApplication.quit()

handleResponse()接收QNetworkReply对象。 它包含已发送请求的数据和标头。 如果网络回复中没有错误，我们将使用readAll()方法读取所有数据； 否则，我们将显示错误消息。 errorString()返回人类可读的最后发生的错误的描述。 readAll()返回QByteArray中必须解码的数据。

  1. $ ./get_request.py 
  2. <html><head><title>Something.</title></head>
  3. <body>Something.</body>
  4. </html>

这是输出。

HTTP POST 请求

HTTP POST 方法将数据发送到服务器。 请求正文的类型由Content-Type标头指示。 POST 请求通常通过 HTML 表单发送。 请求中发送的数据可以采用不同的方式进行编码。 在application/x-www-form-urlencoded中，值被编码为以'&'分隔的键值元组，键和值之间带有'='。 非字母数字字符采用百分比编码。 multipart/form-data用于二进制数据和文件上传。

post_request.py

  1. #!/usr/bin/python3
  2. # -*- coding: utf-8 -*-
  4. '''
  5. QNetworkAccessManager in PyQt
  7. In this example we post data to a web page.
  9. Author: Jan Bodnar
  10. Website: zetcode.com
  11. Last edited: September 2017
  12. '''
  14. from PyQt5 import QtCore, QtGui, QtNetwork
  15. import sys, json     
  17. class Example:
  19.     def __init__(self):    
  21.         self.doRequest()
  23.     def doRequest(self):   
  25.         data = QtCore.QByteArray()
  26.         data.append("name=Peter&")
  27.         data.append("age=34")
  29.         url = "https://httpbin.org/post"
  30.         req = QtNetwork.QNetworkRequest(QtCore.QUrl(url))
  31.         req.setHeader(QtNetwork.QNetworkRequest.ContentTypeHeader, 
  32.             "application/x-www-form-urlencoded")
  34.         self.nam = QtNetwork.QNetworkAccessManager()
  35.         self.nam.finished.connect(self.handleResponse)
  36.         self.nam.post(req, data)    
  38.     def handleResponse(self, reply):
  40.         er = reply.error()
  42.         if er == QtNetwork.QNetworkReply.NoError:
  44.             bytes_string = reply.readAll()
  46.             json_ar = json.loads(str(bytes_string, 'utf-8'))
  47.             data = json_ar['form']
  49.             print('Name: {0}'.format(data['name']))
  50.             print('Age: {0}'.format(data['age']))
  52.             print()
  54.         else:
  55.             print("Error occurred: ", er)
  56.             print(reply.errorString())
  58.         QtCore.QCoreApplication.quit()    
  60. app = QtCore.QCoreApplication([])
  61. ex = Example()
  62. sys.exit(app.exec_())

该示例将发布请求发送到https://httpbin.org/post测试站点，该站点将数据以 JSON 格式发送回。

  1. data = QtCore.QByteArray()
  2. data.append("name=Peter&")
  3. data.append("age=34")

根据规范，我们对QByteArray中发送的数据进行编码。

  1. url = "https://httpbin.org/post"
  2. req = QtNetwork.QNetworkRequest(QtCore.QUrl(url))
  3. req.setHeader(QtNetwork.QNetworkRequest.ContentTypeHeader, 
  4.     "application/x-www-form-urlencoded")

我们指定application/x-www-form-urlencoded编码类型。

  1. bytes_string = reply.readAll()
  3. json_ar = json.loads(str(bytes_string, 'utf-8'))
  4. data = json_ar['form']
  6. print('Name: {0}'.format(data['name']))
  7. print('Age: {0}'.format(data['age']))
  9. print()

在处理器方法中，我们读取响应数据并将其解码。 使用内置的json模块，我们提取发布的数据。

  1. $ ./post_request.py 
  2. Name: Peter
  3. Age: 34

这是输出。

使用QNetworkAccessManager进行认证

每当最终服务器在传递所请求的内容之前请求认证时，都会发出authenticationRequired信号。

authenticate.py

  1. #!/usr/bin/python3
  2. # -*- coding: utf-8 -*-
  4. '''
  5. QNetworkAccessManager in PyQt
  7. In this example, we show how to authenticate
  8. to a web page.
  10. Author: Jan Bodnar
  11. Website: zetcode.com
  12. Last edited: September 2017
  13. '''
  15. from PyQt5 import QtCore, QtGui, QtNetwork
  16. import sys, json
  18. class Example:
  20.     def __init__(self):    
  22.         self.doRequest()
  24.     def doRequest(self):   
  26.         self.auth = 0
  28.         url = "https://httpbin.org/basic-auth/user7/passwd7"
  29.         req = QtNetwork.QNetworkRequest(QtCore.QUrl(url))
  31.         self.nam = QtNetwork.QNetworkAccessManager()
  32.         self.nam.authenticationRequired.connect(self.authenticate)
  33.         self.nam.finished.connect(self.handleResponse)
  34.         self.nam.get(req)  
  36.     def authenticate(self, reply, auth):
  38.         print("Authenticating")
  40.         self.auth += 1
  42.         if self.auth >= 3:
  43.             reply.abort()
  45.         auth.setUser("user7")
  46.         auth.setPassword("passwd7")         
  48.     def handleResponse(self, reply):
  50.         er = reply.error()
  52.         if er == QtNetwork.QNetworkReply.NoError:
  54.             bytes_string = reply.readAll()
  56.             data = json.loads(str(bytes_string, 'utf-8'))
  58.             print('Authenticated: {0}'.format(data['authenticated']))
  59.             print('User: {0}'.format(data['user']))
  61.             print()
  63.         else:
  64.             print("Error occurred: ", er)
  65.             print(reply.errorString())
  67.         QtCore.QCoreApplication.quit()    
  69. app = QtCore.QCoreApplication([])
  70. ex = Example()
  71. sys.exit(app.exec_())

在示例中，使用https://httpbin.org网站显示如何使用QNetworkAccessManager进行认证。

  1. self.nam.authenticationRequired.connect(self.authenticate)

我们将authenticationRequired信号连接到authenticate()方法。

  1. def authenticate(self, reply, auth):
  3.     print("Authenticating")
  4.     ...

authenticate()方法的第三个参数是QAuthenticator，用于传递所需的认证信息。

  1. self.auth += 1
  3. if self.auth >= 3:
  4.     reply.abort()

如果验证失败，则QNetworkAccessManager会继续发出authenticationRequired信号。 在三次失败的尝试之后，我们中止了该过程。

  1. auth.setUser("user7")
  2. auth.setPassword("passwd7")

我们将用户和密码设置为QAuthenticator。

  1. bytes_string = reply.readAll()
  3. data = json.loads(str(bytes_string, 'utf-8'))
  5. print('Authenticated: {0}'.format(data['authenticated']))
  6. print('User: {0}'.format(data['user']))
  8. print()

https://httpbin.org用 JSON 数据响应，该数据包含用户名和指示认证成功的布尔值。

  1. $ ./authenticate.py 
  2. Authenticating
  3. Authenticated: True
  4. User: user7

这是输出。

提取一个网站图标

网站图标是与特定网站相关的小图标。 在以下示例中，我们将从网站上下载网站图标。

fetch_icon.py

  1. #!/usr/bin/python3
  2. # -*- coding: utf-8 -*-
  4. '''
  5. QNetworkAccessManager in PyQt
  7. In this example we fetch a favicon from 
  8. a website.
  10. Author: Jan Bodnar
  11. Website: zetcode.com
  12. Last edited: September 2017
  13. '''
  15. from PyQt5 import QtCore, QtGui, QtNetwork
  16. import sys    
  18. class Example:
  20.     def __init__(self):    
  22.         self.doRequest()
  24.     def doRequest(self):   
  26.         url = "http://www.google.com/favicon.ico"
  27.         req = QtNetwork.QNetworkRequest(QtCore.QUrl(url))
  29.         self.nam = QtNetwork.QNetworkAccessManager()
  30.         self.nam.finished.connect(self.handleResponse)
  31.         self.nam.get(req)    
  33.     def handleResponse(self, reply):
  35.         er = reply.error()
  37.         if er == QtNetwork.QNetworkReply.NoError:
  39.             data = reply.readAll()
  40.             self.saveFile(data)        
  42.         else:
  43.             print("Error occured: ", er)
  44.             print(reply.errorString())
  46.         QtCore.QCoreApplication.quit()    
  48.     def saveFile(self, data):
  50.         f = open('favicon.ico', 'wb')
  52.         with f:
  54.             f.write(data)
  56. app = QtCore.QCoreApplication([])
  57. ex = Example()
  58. sys.exit(app.exec_())

该代码示例下载了 Google 的收藏夹图标。

  1. self.nam.get(req)

我们使用get()方法下载图标。

  1. data = reply.readAll()
  2. self.saveFile(data)

在handleResponse()方法中，我们读取数据并将其保存到文件中。

  1. def saveFile(self, data):
  3.     f = open('favicon.ico', 'wb')
  5.     with f:
  7.         f.write(data)

图像数据以saveFile()方法保存在磁盘上。

在本教程中，我们使用了QNetworkAccessManager。

您可能也对以下相关教程感兴趣： QPropertyAnimation教程， PyQt5 教程和 Python 教程。