12_OkHttp初体验
12_OkHttp初体验
在 Java 开发中,网络请求是非常常见的需求。除了 Spring 自带的 RestTemplate
和 WebClient
,一个非常轻量级、性能强劲的 HTTP 客户端库就是 OkHttp。
今天就来记录一下我在 Spring Boot 项目中集成并使用 OkHttp 的初体验。
📦 一、OkHttp 配置类
首先在 Spring Boot 中,我们通常会将 OkHttpClient
配置成一个 Bean,方便全局注入使用。
/*** @Author: sqnugy* @Date: 2025/7/29 20:13* @Version: v1.0.0* @Description: OkHttp 客户端配置类**/
@Configuration
public class OkHttpConfig {@Beanpublic OkHttpClient okHttpClient(@Value("${okhttp.connect-timeout}") int connectTimeout,@Value("${okhttp.read-timeout}") int readTimeout,@Value("${okhttp.write-timeout}") int writeTimeout,@Value("${okhttp.max-idle-connections}") int maxIdleConnections,@Value("${okhttp.keep-alive-duration}") int keepAliveDuration) {return new OkHttpClient.Builder().connectTimeout(connectTimeout, TimeUnit.MILLISECONDS) // 建立连接超时.readTimeout(readTimeout, TimeUnit.MILLISECONDS) // 读取数据超时.writeTimeout(writeTimeout, TimeUnit.MILLISECONDS) // 写入数据超时.connectionPool(new ConnectionPool(maxIdleConnections, keepAliveDuration, TimeUnit.MINUTES)) // 连接池配置.build();}
}
这样一来,OkHttpClient
就能作为 Spring Bean 被注入使用啦 🎉
⚙️ 二、配置文件
为了灵活性,我们把超时时间、连接池参数等写到 application.yml
中:
okhttp: # OkHttp 客户端配置connect-timeout: 5000 # 建立连接的最大等待时间(毫秒)read-timeout: 30000 # 读取数据的最大等待时间(毫秒)write-timeout: 15000 # 写入数据的最大等待时间(毫秒)max-idle-connections: 200 # 连接池中保持的最大空闲连接数keep-alive-duration: 5 # 空闲连接在连接池中的存活时间(分钟)
这样后续如果需要调整参数,就不需要改代码了,非常方便。
🔍 三、OkHttp 使用示例
以一个 同步 GET 请求为例,我们来抓取指定 URL 的 HTML 内容。
/*** 同步获取指定 URL 的 HTML 内容* @param url 请求地址* @return 页面 HTML 字符串*/
private String syncFetchHtmlContent(String url) {// 构建 HTTP GET 请求Request request = new Request.Builder().url(url) .header("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36") // 模拟浏览器 UA.header("Accept", "text/html") // 接受 HTML 格式.build();try (Response response = okHttpClient.newCall(request).execute()) {// 判断响应是否成功if (!response.isSuccessful() || response.body() == null) {return "";}// 返回响应内容return response.body().string();} catch (IOException e) {e.printStackTrace();return "";}
}
📌 四、几点感受
- 轻量级:相比
RestTemplate
,OkHttp 使用起来更简洁,API 风格清晰。 - 高性能:支持连接池,能复用 TCP 连接,减少资源消耗。
- 灵活性高:可以方便地添加拦截器(例如日志、鉴权),在底层做更多定制化操作。
- 同步 & 异步支持:既支持阻塞调用,也支持回调式异步请求。
📝 总结
第一次上手 OkHttp 给我的感受是:简单、好用、性能强。
如果你的项目里有需要进行大量 HTTP 调用的场景,完全可以考虑在 Spring Boot 里集成 OkHttp。后续我也会继续探索 拦截器、异步请求 和 上传下载文件等功能。