创建多个 OkHttpClient 实例 场景
在 Android 开发中使用 OkHttp 时,创建多个 HttpClient 实例通常是为了满足不同的网络请求需求。以下是需要创建多个 HttpClient 的常见场景:
1. 不同的超时设置
-
短超时请求:普通API请求(5-10秒)
-
长超时请求:文件上传/下载(几分钟)
// 快速API请求Client
val fastClient = OkHttpClient.Builder().connectTimeout(10, TimeUnit.SECONDS).readTimeout(10, TimeUnit.SECONDS).build()// 文件下载Client
val downloadClient = OkHttpClient.Builder().connectTimeout(60, TimeUnit.SECONDS).readTimeout(300, TimeUnit.SECONDS).build()
2. 不同的认证需求
-
不同API端点需要不同的认证方式
-
部分接口需要Token,部分需要Basic Auth
// 主API Client(带Token)
val apiClient = OkHttpClient.Builder().addInterceptor(TokenInterceptor()).build()// 第三方服务Client(带API Key)
val thirdPartyClient = OkHttpClient.Builder().addInterceptor(ApiKeyInterceptor()).build()
3. 不同的拦截器需求
-
日志记录需求不同(部分接口需要详细日志)
-
数据加密/解密需求不同
// 带详细日志的Client
val debugClient = OkHttpClient.Builder().addInterceptor(HttpLoggingInterceptor().apply {level = HttpLoggingInterceptor.Level.BODY}).build()// 生产环境Client(无body日志)
val productionClient = OkHttpClient.Builder().addInterceptor(HttpLoggingInterceptor().apply {level = HttpLoggingInterceptor.Level.BASIC}).build()
4. 不同的缓存策略
-
频繁更新的数据(禁用缓存)
-
静态资源(长期缓存)
// 无缓存Client
val noCacheClient = OkHttpClient.Builder().cache(null).build()// 大缓存Client(用于静态资源)
val cacheClient = OkHttpClient.Builder().cache(Cache(cacheDir, 50L * 1024 * 1024)) // 50MB缓存.build()
5. 不同的网络环境处理
-
Wi-Fi和移动数据不同策略
-
弱网环境特殊处理
// 普通网络Client
val normalClient = OkHttpClient.Builder().build()// 弱网优化Client
val weakNetworkClient = OkHttpClient.Builder().addInterceptor(WeakNetworkInterceptor()).build()
6. 不同的代理配置
-
部分请求需要走代理
-
测试环境需要特殊代理
// 直连Client
val directClient = OkHttpClient.Builder().proxy(Proxy.NO_PROXY).build()// 代理Client
val proxyClient = OkHttpClient.Builder().proxy(Proxy(Proxy.Type.HTTP, InetSocketAddress("proxy.example.com", 8080))).build()
最佳实践建议
-
不要过度创建:每个OkHttpClient都有自己的连接池和线程池,创建过多会浪费资源
-
优先使用拦截器:如果只是请求头等小差异,优先考虑使用拦截器而不是创建新Client
-
考虑使用单例模式:管理多个Client实例,避免重复创建
-
评估实际需求:只有当配置差异确实需要独立Client时才创建
通常,一个中等复杂度的App可能需要2-3个不同的OkHttpClient实例(如API Client、下载Client、特殊认证Client等)。