Python中urllib3.util.Retry()的特点和用法分析

urllib3是一个强大的Python HTTP库，可用于发送HTTP请求。urllib3.util.Retry()是一个Retry类，它提供了对请求的重试和超时的控制。以下是对urllib3.util.Retry()的特点和用法的分析，并附带了一个使用例子。

特点：

1. 支持设置重试次数和重试等待时间，可以指定每次重试等待的时间间隔。

2. 支持设置重试状态码，可以指定只针对特定的HTTP状态码进行重试。

3. 支持设置重试错误，可以指定只针对特定的异常错误进行重试。

4. 支持设置重试回调函数，可以在每次重试之前或之后执行自定义的回调函数。

5. 可以通过配置参数控制是否允许重定向、重用连接等。

用法：

1. 创建Retry对象：

from urllib3.util import Retry

# 创建一个Retry对象
retry = Retry(...)

2. 设置重试次数和重试等待时间：

# 设置最大重试次数为3次
retry.total = 3

# 设置每次重试等待的时间间隔为3秒
retry.backoff_factor = 3

3. 设置重试状态码：

# 设置只对状态码为500和502的请求进行重试
retry.status_forcelist = [500, 502]

4. 设置重试错误：

# 设置只对ConnectionError和TimeoutError错误进行重试
retry.retry_on_error = [ConnectionError, TimeoutError]

5. 设置重试回调函数：

# 设置一个在重试之前执行的回调函数
def before_retry_callback(retry, response):
    print("Retrying...")
    
retry.pre_request = before_retry_callback

6. 发送请求时使用Retry对象：

import urllib3

# 创建一个HTTP连接池
http = urllib3.PoolManager()

# 发送请求时使用Retry对象
response = http.request("GET", "https://www.example.com", retries=retry)

以上示例演示了如何使用urllib3.util.Retry()来设置重试参数，并使用Retry对象来发送HTTP请求。 Retry对象会在请求失败时根据设置的重试次数和条件进行重试，直到成功或达到重试次数上限。

请注意，urllib3.util.Retry()可以与urllib3.PoolManager()和urllib3.HTTPSConnectionPool()一起使用，以控制连接池中的请求重试和超时。也可以与urllib3.HTTPConnectionPool()一起使用，但重试只会在单个连接上进行，而不是在整个连接池上进行。