转载

【赏码会】HTTP Client中的瑞士军刀：Retrofit

写在前面

最近开始在GitHub上找一些优秀的开源项目，跟团队一起阅读源代码，每周一次，每次一个半小时左右，美其名曰“赏码会”（还记得《唐伯虎点秋香》那句“赏花赏月赏秋香”吗？）。为什么要阅读源代码？好处举不胜举，比如学习如何合理的命名，如何写出简洁、清晰的注释，如何编写有效的单元测试，知道良好的编码风格是什么样的。有一些积累之后，可以试试看找一找隐藏在代码里的设计模式，加一些新的单元测试，想一想如果自己实现会如何设计。阅读源代码可以说是有百利而无一害，属于典型的第二象限的事（参见《高效能人士的七个习惯》）。

Retrofit简介

第一次“赏码会”我选的是 Retrofit 项目，为啥选它呢？第一，小巧（核心代码不到5000行），第二，高Star（17+K），第三，平时一直在用。先简单介绍一下Retrofit这个框架。Retrofit是 Square 公司开源的一个Java实现的轻量级HTTP Client框架，本质上是对Square公司另一个开源框架OkHTTP的一层type-safe的封装。所谓的type-safe，我的理解就是将OkHTTP原生的Request/Response对象通过类型安全的方式转化为其他任意类型的对象，比如String，用户自定义类型等。

面向接口的声明式API定义风格是Retrofit最受欢迎的特性，例如下面的GitHubService接口的listRepos方法定义了GitHub的 List user repositories API。

java

public interface GitHubService {

  @GET("users/{user}/repos")

  Call<List<Repo>> listRepos(@Path("user") String user);

}

无需定义具体的实现类，就可以直接调用，例如：

java

Retrofit retrofit = new Retrofit.Builder()

    .baseUrl("https://api.github.com/")

    .build();

GitHubService service = retrofit.create(GitHubService.class);

Call<List<Repo>> repos = service.listRepos("octocat");

有经验的Java程序员立刻就能看出，相对于其他的HTTP Client框架，比如 Apache HttpClient 或者 Async Http Client ，使用Retrofit编程效率将产生质的提升。

核心类

从GitHub拉取Retrofit的源代码，导入retrofit子工程，核心代码都在retrofit包下。

核心类列举如下：

Retrofit: Retrofit框架的门面类，大多数情况下，你的代码中只需要用到它。
ServiceMethod: 对应接口类中的一个方法（比如上文中的listRepos），负责解析方法签名中用到的各种注解，生成最终的Request对象。
Call: 类似于Java 8里面的CompletableFuture，提供异步支持。
CallAdapter: Retrofit默认只接受Call<?>作为方法返回类型，如果需要使用其他类型，就要添加额外的CallAdapter。
Converter: Retrofit默认只接受Response和Void作为Call<?>的类型参数，如果需要使用其他类型，就要添加额外的Converter。