Retrofit：Square 出品的 HTTP 客户端，43k+ Star

Retrofit：Square 出品的 HTTP 客户端，43k+ Star

Square 公司开源的 Retrofit，在 GitHub 上拿下了 43k+ 的 Star：

Retrofit 是一个适用于 Android 和 Java 的类型安全 HTTP 客户端。

这个库把 HTTP API 转换成 Java 接口，开发者只需要定义接口方法和注解，Retrofit 就能自动生成对应的网络请求实现。

Retrofit 的核心设计理念是通过注解来描述 HTTP 请求。支持 GET、POST、PUT、DELETE、PATCH 等常见请求方式，也支持 multipart 文件上传和表单提交。

这个库对 Android 开发者来说很熟悉，它和 OkHttp 配合使用，OkHttp 负责底层的网络通信，Retrofit 负责上层的 API 定义和数据转换。

Retrofit 支持多种数据格式的序列化和反序列化，包括 JSON、Protocol Buffers、XML 等。通过 Converter 机制，可以灵活接入 Gson、Moshi、Jackson 等第三方库。

环境要求

Retrofit 要求 Java 8 及以上版本，Android 项目需要 API 21 及以上。

安装方式

通过 Maven Central 引入依赖：

com.squareup.retrofit2:retrofit:3.0.0

也可以下载 JAR 文件直接集成。

开发中的快照版本可以在 Sonatype 的 snapshots 仓库获取。

基本使用

定义一个接口，用注解描述请求：

public interface GitHubService { @GET("users/{user}/repos") Call<List<Repo>> listRepos(@Path("user") String user); }

创建 Retrofit 实例并生成接口实现：

Retrofit retrofit = new Retrofit.Builder() .baseUrl("https://api.github.com/") .build(); GitHubService service = retrofit.create(GitHubService.class);

调用接口方法就能发起网络请求，返回的 Call 对象支持同步和异步两种执行方式。

代码混淆

使用 R8 的项目不需要额外配置，混淆规则会自动包含。

使用 ProGuard 的项目需要手动添加 retrofit2.pro 文件中的规则，同时可能需要添加 OkHttp 的混淆规则。

Retrofit 采用 Apache License 2.0 开源协议，由 Square 公司维护，代码质量稳定，社区活跃度高。

实际应用场景

Retrofit 在 Android 项目中使用广泛。很多公司的 Android 客户端都用它作为网络层的基础库。

配合 RxJava 或 Kotlin 协程，可以优雅地处理异步请求和复杂的网络调用链。比如先登录获取 token，再用 token 请求用户信息，这种场景用 Retrofit 写出来很清晰。

支持自定义 Converter，如果项目用的是自定义的数据格式，也可以自己写转换器来处理。

与其他库的对比

相比原生的 HttpURLConnection，Retrofit 的 API 设计更现代，代码量更少。

相比 Volley，Retrofit 的扩展性更强，社区生态更丰富。

OkHttp 是 Retrofit 的底层依赖，两者配合使用效果最好。如果项目已经用了 OkHttp，加上 Retrofit 会让代码更简洁。

版本历史

Retrofit 从 2013 年开始维护，到现在已经十多年了。3.0 版本是一次大更新，对内部实现做了优化，API 保持了向后兼容。

Square 公司的开源库质量一直有保障，OkHttp、Picasso、LeakCanary 都是他们家的。

这个库的 Issue 区回复很及时，遇到问题基本都能找到解决方案。

are 公司的开源库质量一直有保障，OkHttp、Picasso、LeakCanary 都是他们家的。

这个库的 Issue 区回复很及时，遇到问题基本都能找到解决方案。