Retrofit vs Feign: 介绍、对比及示例
1. 介绍
Retrofit
Retrofit 是 Square 公司开发的一个类型安全的 HTTP 客户端库，主要用于 Android 和 Java 应用。它将 HTTP API 转换为 Java 接口，通过注解来描述 HTTP 请求。
主要特点:
- 基于注解的 API 定义
- 支持同步和异步调用
- 支持多种数据格式转换 (JSON, XML 等)
- 可与 RxJava、Coroutines 等集成
- 主要用于移动端开发
Feign
Feign 是 Netflix 开发的一个声明式 Web Service 客户端，后被纳入 Spring Cloud 生态。它使得编写 Web Service 客户端变得更简单。
主要特点:
- 声明式的 REST 客户端
- 与 Spring Cloud 深度集成
- 支持负载均衡 (与 Ribbon 集成)
- 支持服务发现 (与 Eureka 集成)
- 主要用于微服务间的调用
2. 对比
| 特性 | Retrofit | Feign |
|---|---|---|
| 开发公司 | Square | Netflix (现属于 Spring Cloud) |
| 主要使用场景 | Android/Java 客户端应用 | 微服务间调用 |
| 注解支持 | 是 | 是 |
| 同步/异步 | 都支持 | 主要同步，可通过其他方式实现异步 |
| 集成能力 | OkHttp, RxJava, Coroutines | Ribbon, Hystrix, Eureka |
| 配置复杂度 | 相对简单 | 与 Spring Cloud 集成时较复杂 |
| 负载均衡 | 不支持 | 支持 (通过 Ribbon) |
| 服务发现 | 不支持 | 支持 (通过 Eureka) |
| 社区支持 | 主要面向移动端 | 主要面向微服务 |
3. 示例代码
Retrofit 示例
// 1. 定义接口
public interface GitHubService {@GET("users/{user}/repos")Call<List<Repo>> listRepos(@Path("user") String user);@GET("users/{user}/repos")Observable<List<Repo>> listReposRx(@Path("user") String user);
}// 2. 创建 Retrofit 实例
Retrofit retrofit = new Retrofit.Builder().baseUrl("https://api.github.com/").addConverterFactory(GsonConverterFactory.create()).addCallAdapterFactory(RxJava2CallAdapterFactory.create()).build();// 3. 创建服务实例
GitHubService service = retrofit.create(GitHubService.class);// 4. 同步调用
Call<List<Repo>> call = service.listRepos("octocat");
Response<List<Repo>> response = call.execute();// 5. 异步调用
call.enqueue(new Callback<List<Repo>>() {@Overridepublic void onResponse(Call<List<Repo>> call, Response<List<Repo>> response) {// 处理响应}@Overridepublic void onFailure(Call<List<Repo>> call, Throwable t) {// 处理错误}
});// 6. RxJava 方式调用
service.listReposRx("octocat").subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread()).subscribe(repos -> {// 处理结果}, throwable -> {// 处理错误});
Feign 示例
// 1. 添加依赖 (Spring Cloud OpenFeign)
// 在Spring Boot应用中// 2. 启用Feign客户端
@SpringBootApplication
@EnableFeignClients
public class MyApplication {public static void main(String[] args) {SpringApplication.run(MyApplication.class, args);}
}// 3. 定义Feign客户端接口
@FeignClient(name = "github-client", url = "https://api.github.com")
public interface GitHubClient {@GetMapping("/users/{user}/repos")List<Repo> listRepos(@PathVariable("user") String user);// 带负载均衡的示例 (需要服务注册中心)@FeignClient(name = "user-service") // 从注册中心获取服务实例@GetMapping("/api/users/{id}")User getUserById(@PathVariable("id") Long id);
}// 4. 在Controller或Service中使用
@RestController
public class MyController {private final GitHubClient gitHubClient;public MyController(GitHubClient gitHubClient) {this.gitHubClient = gitHubClient;}@GetMapping("/repos/{user}")public List<Repo> getRepos(@PathVariable String user) {return gitHubClient.listRepos(user);}
}// 5. 配置示例 (application.yml)
feign:client:config:default:connectTimeout: 5000readTimeout: 5000loggerLevel: basichystrix:enabled: true # 启用熔断
4. 如何选择
-
选择 Retrofit 当:
- 开发 Android 应用
- 需要与 RxJava 或 Coroutines 集成
- 调用第三方 API 而非自己的微服务
- 需要更轻量级的解决方案
-
选择 Feign 当:
- 开发 Spring Cloud 微服务
- 需要服务发现和负载均衡
- 需要与 Hystrix 熔断器集成
- 在服务间进行 REST 调用
两者都是优秀的 HTTP 客户端库，选择取决于具体的使用场景和技术栈。
如果需要更复杂的微服务功能（如负载均衡、服务发现），Feign 仍是更好的选择，但 Retrofit 在客户端场景下的简洁性和性能表现更胜一筹。