OkHttp源码学习之retryOnConnectionFailure属性

retryOnConnectionFailure的作用

在OKHTTP中,retryOnConnectionFailure 是一个配置选项,它用于控制当网络连接失败时是否应该重试请求。这个选项通常在 OkHttpClient 的配置中设置,用于决定在网络连接失败的情况下,是否应该自动重试请求。

retryOnConnectionFailure 控制的是 连接失败 时是否自动重试请求。具体来说,如果设置为 true,当请求连接失败时,OkHttp 会尝试重新建立连接并重试该请求;如果设置为 false,则在连接失败时不会重试请求,而是直接返回失败。

默认值:

默认情况下,retryOnConnectionFailure 的值为 true,这意味着如果请求的连接发生故障,OkHttp 会自动进行重试,直到请求成功或遇到最大重试次数(通常是无穷次,具体依赖于操作系统和网络环境)。

配置方式:

可以在创建 OkHttpClient 时,通过 OkHttpClient.Builder 配置 retryOnConnectionFailure。比如:

kotlin 复制代码
val client = OkHttpClient.Builder()
    .retryOnConnectionFailure(true) // 设置为 true 表示启用重试
    .build()

如果你希望禁用自动重试,可以将其设置为 false

kotlin 复制代码
val client = OkHttpClient.Builder()
    .retryOnConnectionFailure(false) // 设置为 false 表示禁用重试
    .build()

适用场景:

/**

  • Configure this client to retry or not when a connectivity problem is encountered. By default,this client silently recovers from the following problems:
  • Unreachable IP addresses. If the URL's host has multiple IP addresses, failure to reach any individual IP address doesn't fail the overall request. This canincrease availability of multi-homed services.
  • Stale pooled connections. The [ConnectionPool] reuses sockets to decrease request latency, but these connections will occasionally time out.
  • Unreachable proxy servers. A [ProxySelector] can be used to attempt multiple proxy servers in sequence, eventually falling back to a direct connection.
  • Set this to false to avoid retrying requests when doing so is destructive. In this case the calling application should do its own recovery of connectivity failures.

*/

通过上面的源码注释,可以看到retryOnConnectionFailure主要适用下面的三个场景,

  1. 自动重试连接
    例如,如果请求的服务器出现短暂的网络问题或连接问题(如服务器不可达、TCP 连接超时等),启用重试可以增加请求成功的机会,避免因临时网络问题导致请求失败。
  2. 防止短暂的网络波动导致请求失败
    在某些情况下,网络环境可能出现短暂的波动或丢包,如果不进行重试,请求可能会立即失败,影响用户体验。启用重试可以提高网络请求的成功率。
  3. 避免服务器压力过大
    如果某个请求失败并立即重试,可能会导致服务器在高负载下变得更加拥堵。对于某些高并发应用场景,避免重试可能是一个合理的选择。
相关推荐
·云扬·8 分钟前
【Java源码阅读系列37】深度解读Java BufferedReader 源码
java·开发语言
Bug退退退1231 小时前
RabbitMQ 高级特性之重试机制
java·分布式·spring·rabbitmq
小皮侠1 小时前
nginx的使用
java·运维·服务器·前端·git·nginx·github
Zz_waiting.1 小时前
Javaweb - 10.4 ServletConfig 和 ServletContext
java·开发语言·前端·servlet·servletconfig·servletcontext·域对象
全栈凯哥1 小时前
02.SpringBoot常用Utils工具类详解
java·spring boot·后端
兮动人1 小时前
获取终端外网IP地址
java·网络·网络协议·tcp/ip·获取终端外网ip地址
呆呆的小鳄鱼2 小时前
cin,cin.get()等异同点[面试题系列]
java·算法·面试
独立开阀者_FwtCoder2 小时前
"页面白屏了?别慌!前端工程师必备的排查技巧和面试攻略"
java·前端·javascript
Touper.2 小时前
JavaSE -- 泛型详细介绍
java·开发语言·算法
vocal2 小时前
【我的安卓第一课】Android 多线程与异步通信机制(1)
android