【Python】PySide6应用如何防止网络请求阻塞窗口的响应

Q：在开发PySide6的应用时，进行网络请求时会导致整个窗口卡死，当目标服务器宕机时，会导致客户端的窗口完全无响应，请问如何让网络请求不影响窗口？

A：遇到这个问题，通常的解决方案是将网络请求放到一个单独的线程中，这样即使请求发生阻塞也不会影响主线程的UI渲染。PySide6（和其基础库Qt）都提供了工具来帮助你管理线程。下面是一个使用QThread的基础示例来展示如何实现这一点：

创建一个派生自QThread的类用于执行网络请求。
在这个类中重写run方法去执行耗时的网络调用。
创建该类的实例并使用start方法来触发线程，在其内部执行网络请求。

这里是一个简单的代码示例：

from PySide6.QtCore import QThread, Signal
from PySide6.QtWidgets import QApplication, QMainWindow
import sys
import requests

class NetworkThread(QThread):
    # 可以使用信号来发送网络请求的结果回主线程
    result_signal = Signal(str)

    def __init__(self, url):
        super(NetworkThread, self).__init__()
        self.url = url

    def run(self):
        # 尝试进行网络请求
        try:
            response = requests.get(self.url)
            self.result_signal.emit(response.text)  # 发送请求结果的信号
        except requests.RequestException as e:
            self.result_signal.emit('Error: ' + str(e))  # 发送请求错误的信号

class MainWindow(QMainWindow):
    def __init__(self):
        super(MainWindow, self).__init__()

        # 创建网络线程实例
        self.network_thread = NetworkThread('http://example.com')

        # 连接信号，设置网络请求完成时的行为
        self.network_thread.result_signal.connect(self.on_result)

    def on_result(self, result):
        # 在这里处理网络请求的结果，更新UI等
        print(result)

    def start_request(self):
        # 启动网络线程
        self.network_thread.start()

app = QApplication(sys.argv)
mainWin = MainWindow()
mainWin.show()
mainWin.start_request()  # 开始网络请求
sys.exit(app.exec())

这个例子中，NetworkThread类会在一个单独的线程中执行get请求，并将结果通过result_signal发送回主线程。修改UI只能在主线程中完成，所以你需要用信号和槽将结果从工作线程传递回主线程。在主线程中创建的MainWindow实例就是通过这种方式连接信号并处理结果的。

记得处理网络通讯时，仍需考虑用户体验。例如，可以通过UI提供一种方法来取消阻塞的请求，或者设置合理的超时时间等。

Q：我的客户端与服务端连接中有很多接口，这样的话我是否需要写很多NetworkThread类？

A：不必为每个接口都创建一个NetworkThread类。你可以设计一个通用的NetworkThread类，它可以接受不同的请求参数并执行相应的网络操作。

通用的NetworkThread类可以包括接口名称、请求类型（如GET或POST）、请求参数等信息。然后在类的run方法中，根据这些信息构建请求，并发送给服务器。你还可以增加处理请求结果的逻辑，例如使用信号将结果发送回UI线程。

这是一个简化的NetworkThread类示例，它能够处理不同的网络请求：

from PySide6.QtCore import QThread, Signal

class NetworkThread(QThread):
    finished_signal = Signal(dict)

    def __init__(self, url, method='GET', params=None, data=None, headers=None):
        super(NetworkThread, self).__init__()
        self.url = url
        self.method = method
        self.params = params
        self.data = data
        self.headers = headers

    def run(self):
        try:
            if self.method == 'GET':
                response = requests.get(self.url, params=self.params, headers=self.headers)
            elif self.method == 'POST':
                response = requests.post(self.url, data=self.data, headers=self.headers)
            # 可以根据需要添加其他请求类型的处理
            # ...

            # 检查响应状态码等
            if response.status_code == 200:
                self.finished_signal.emit({'status': 'success', 'data': response.json()})
            else:
                self.finished_signal.emit({'status': 'error', 'data': response.text})
        except requests.RequestException as e:
            self.finished_signal.emit({'status': 'error', 'data': str(e)})

使用时，你可以根据需要创建NetworkThread的实例，并根据具体的网络请求提供参数：

# 创建一个GET请求的线程实例
get_thread = NetworkThread('http://api.example.com/data', params={'key': 'value'})
get_thread.finished_signal.connect(handle_get_response)  # 连接到处理响应的函数
get_thread.start()

# 创建一个POST请求的线程实例
post_thread = NetworkThread('http://api.example.com/submit', method='POST', data={'some': 'data'})
post_thread.finished_signal.connect(handle_post_response)  # 连接到处理响应的函数
post_thread.start()

在上面的代码里，你需要定义handle_get_response和handle_post_response两个函数来处理不同请求的响应结果，并实现更新UI等功能。

通过这种方式，你可以只用一个NetworkThread类来处理多种不同的网络请求，避免了为每个接口创建单独线程类的繁琐。

Q：如何设置合理的超时时间？

A：设置合理的超时时间对于保证应用程序的用户体验非常关键，尤其是在网络请求可能会因为各种原因延迟甚至失败的情况下。超时时间的设置依赖于你的应用程序的具体要求以及你预期的用户体验。以下是一些设置超时时间时可以考虑的因素：

请求的类型：一些请求比其他的更耐等待，例如，后台数据同步不需要非常快速响应，但是用户界面上的请求则需要迅速完成以避免用户长时间等待。
用户的期望：如果用户期待快速响应（例如在一个搜索框中输入查询），则必须设置较短的超时时间。
网络的质量：在移动设备上或网络不稳定的地区，可能需要设置更长的超时时间。
服务器的响应时间：如果你知道服务器通常需要较长时间来处理某些请求，你可能需要设置更长的超时时间来适配。

典型的HTTP请求超时时间设置在10到30秒之间，但这完全取决于上述提到的因素。对于非关键性的操作，可以设置更长的超时时间，尤其是如果你知道服务器可能需要时间处理请求。对于用户界面上的操作，应当设置较短的超时时间来快速给用户反馈。

在requests库中，可以通过timeout参数来设置网络请求的超时时间（以秒为单位）：

response = requests.get('http://example.com', timeout=10)  # 设置超时时间为10秒

在以上例子的NetworkThread类中，这样设置超时：

class NetworkThread(QThread):
    # ...
    def __init__(self, url, method='GET', params=None, data=None, headers=None, timeout=10):
        # ...
        self.timeout = timeout  # 设置默认的超时时间

    def run(self):
        try:
            if self.method == 'GET':
                response = requests.get(self.url, params=self.params, headers=self.headers, timeout=self.timeout)
            elif self.method == 'POST':
                response = requests.post(self.url, data=self.data, headers=self.headers, timeout=self.timeout)
            # ...
        # ...

在这个修改后的类定义中，你可以在创建NetworkThread实例的时候传递一个timeout值，或者使用设定的默认值。这样就可以针对不同的网络请求灵活设置超时时间。

若无特殊说明，文章版权归作者所有，请勿转载至任何平台。

THE END