一、安装
- 循环、重复回调我们在很多场景中会用到
- 不仅在支付场景中，我们需要通过反复的回调知道用户的支付状态
- 还有在请求中，如果请求失败，我们需要再重新进行进行请求，防止请求异常导致数据缺失
二、一直请求
- 假如我们希望在代码碰到异常时，一直回调，直到成功
- 下面方法中，我们直接访问一个未定义的变量，肯定会走下面的Exception中
- 这个时候我们可以将这一次错误写进日志，但是让程序继续执行这个方法，直到没有异常为止
- 因为这里模拟的是肯定有异常，所以该程序会一直返回回调，不间断的循环往复
from retrying import retry
@retry()
def say():
try:
autofelix
except Exception as e:
# 可以将错误记录日志
print(e)
raise
say()
三、设置最大运行次数
- 如果我们在请求中遇到异常时候
- 可以通过 stop_max_attempt_number 设置一个最大运行次数
- 当回调次数超过设置值，将不再执行回调
- 这里我们设置最大运行次数为5次
from retrying import retry
@retry(stop_max_attempt_number=5)
def say():
try:
autofelix
except Exception as e:
# 可以将错误记录日志
print(e)
raise
say()
四、设置重试的最大时间
- 可以通过
stop_max_delay 设置失败重试的最大时间, 单位毫秒 - 超出时间，则停止重试
from retrying import retry
@retry(stop_max_delay=1000)
def say():
try:
autofelix
except Exception as e:
# 可以将错误记录日志
print(e)
raise
say()
五、设置间隔时间
from retrying import retry
@retry(wait_fixed=1000)
def say():
try:
autofelix
except Exception as e:
# 可以将错误记录日志
print(e)
raise
say()
六、设置随机间隔时间
- 设置失败重试随机性间隔时间, 单位毫秒
- 可以使得访问频率不均匀
from retrying import retry
@retry(wait_random_min=5000, wait_random_max=50000)
def say():
try:
autofelix
except Exception as e:
# 可以将错误记录日志
print(e)
raise
say()
七、随机倍数间隔时间
- 可以通过设置
wait_exponential_multiplier 间隔时间倍数增加 - 可以通过设置
wait_exponential_max 最大间隔时间
from retrying import retry
@retry(wait_exponential_multiplier=1000, wait_exponential_max=10000)
def say():
try:
autofelix
except Exception as e:
# 可以将错误记录日志
print(e)
raise
say()
八、指定异常类型
- 可以通过
retry_on_exception 设置指定异常类型 - 指定的异常类型会重试，不指定的类型，会直接异常退出
- 如果设置
wrap_exception 参数为True，则其他类型异常
from retrying import retry
def retry_error(exception):
return isinstance(exception, RetryError)
# 会重复调用
@retry(etry_on_exception=retry_error)
def say():
try:
autofelix
except RetryError as e:
raise RetryError
# 只调用一次
@retry(etry_on_exception=retry_error, wrap_exception=True)
def say():
raise Exception('a')
say()九、过滤回调
- 可以设置
retry_on_result 指定哪些结果需要去回调 - 将请求结果放到
retry_on_result 指定方法中进行过滤，如果返回None，则继续回调，否则就结束
from retrying import retry
def retry_filter(result):
print("this is result")
return result is not None
@retry(retry_on_result=retry_filter)
def say():
print('Retry forever ignoring Exceptions with no wait if return value is None')
return None
say()十、异常执行
- 通过设置
stop_func 每次抛出异常时都会执行的函数 - 如果和
stop_max_delay、stop_max_attempt_number配合使用，则后两者会失效
from retrying import retry
def stop_record(attempts, delay):
print("logging %d--->%d" % (attempts,delay))
@retry(stop_max_delay=10, stop_func=stop_record)
def say():
print("i am autofelix")
raise Exception
say()
