Retrofit源码总结

**本文总结基于Retrofit 2.4.0**

GitHub:  [https://github.com/square/retrofit](https://note.youdao.com/)

官方文档:  [https://square.github.io/retrofit/](https://note.youdao.com/)

Retrofit 底层是基于OkHttp的进行网络请求的一种封装库。

其实各类大佬博客，公众号，学习网站对Retrofit框架都有详细解读和完美分析了，菜鸟与我，对大佬之敬佩之膜拜，如滔滔江水，延绵不绝，但是，技术是大家的，文章是别人的，带来的结果就是理解但不深刻，掌握但不全面。所以来个自我总结，与人分享，才能共同进步，系不系 O(∩_∩)O

分为以下三大步来总结

**1 Retrofit的使用方式**

**2 Retrofit的源码总结**

**3 Retrofit的原理总结**

# Retrofit的使用方式
直接使用官网例子

第一步：肯定添加一个Retrofit依赖了

compile 'com.squareup.retrofit2:retrofit:2.4.0'


当然也可以直接复制依赖。

第二步：创建一个Retrofit对象，并指定api的域名。

```
Retrofit retrofit = new Retrofit.Builder()
                .baseUrl("https://api.github.com/")
                .build();
                
//这是通过一个Builder模式来构建Retrofit对象的。
//这里说一下我理解的构造着模式的好处吧，总结两点：
//1. 将一个对象的构建和它的表示进行分离，比如一个对象很多属性需要初始化，
//可以通过Builder一键配置。链式调用，方便简洁。
//2. 直接创建对象，对象属性依次初始化，比如
//Person person = new Person();
//person.setName("小吴渐渐")；
//person.setAge("27");
//出现的问题是对象已经创建，内存空间，
//系统资源都已经配置好了，小吴渐渐这个人本来是15岁的小鲜肉，突然变成了27岁的老腊肉了，
//系统就需要把以前的资源擦除，重新配置资源这样就带来了性能问题了。
//而 Builder模式是将所有的属性事先配置好，最后通过build一下，一次性完成所有的资源配置。
```

第三步：根据api声明一个java接口，通过java注解来描述这个api

public interface GitHubService {
    @GET("users/{user}/repos")
    Call> listRepos(@Path("user") String user);
}
//List是根据接口返回的json声明需要的返回值类型
//本来是Response，可是我们需要具体的返回值对象，所以Retrofit支持转换器工厂配置addConverterFactory()

所以第二步可以这样写，这个时候需要添加Gson支持，添加依赖方式参照第一步
compile 'com.squareup.retrofit2:converter-gson:2.4.0'

Retrofit retrofit = new Retrofit.Builder()
                .baseUrl("https://api.github.com/")
                .addConverterFactory(GsonConverterFactory.create(new Gson()))
                .build();

第四步：通过retrofit创建这个接口对象

GitHubService gitHubService = retrofit.create(GitHubService.class);
Call> repos = gitHubService.listRepos("octocat");

 

最后一步：网络请求

//同步请求（在原来的线程中执行）
repos.execute();
//异步请求（在新的线程中执行）看字面意思是一个队列，但多个请求同时请求时，
//并不是排队进行的，而是并行的。当请求数特别多的时候，考虑网络性能的原因，
//会等待其他网络请求完成时，再去执行。
repos.enqueue(new Callback>() {...);

 

# Retrofit的源码总结
**看Retrofit.Builder源码**

Builder(Retrofit retrofit) {
      platform = Platform.get();
      callFactory = retrofit.callFactory;
      baseUrl = retrofit.baseUrl;
      ......
      callbackExecutor = retrofit.callbackExecutor;
      
    }
//懵逼状态，也不知道这些初始化变量有啥用，暂时放下Builder

**往下看retrofit.create(GitHubService.class);，这个方法创建了接口的实例对象，这里的疑问就是接口对象是怎么实例化的,所以下面的代码是Retrofit整个结构的核心**

public  T create(final Class service) {

//验证传入的service是否是接口，且是否是原生接口也就是不能是继承其他接口的接口，
//其实做的事情就是类型校验

    Utils.validateServiceInterface(service);
    
//对你service中的所有声明的合法性，是否需要提前验证，
//这样做的目的是接口创建的一瞬间进行集中验证，能够及早
//发现代码错误，但是不利于性能，因为每个地方都要验证的话,会造成卡顿。
//一般是关闭的。
    if (validateEagerly) {
      eagerlyValidateMethods(service);
    }
    
//真正的核心代码是下面这行，是的，只有一行，网上很多解释
//就是通过动态代理实现的，怎么就实现了，大多都是略过了，直接把代码抽出来单独看，请往下⬇️。
    return (T) Proxy.newProxyInstance(service.getClassLoader(), new Class[] { service },
        new InvocationHandler() {
    
          private final Platform platform = Platform.get();

          @Override public Object invoke(Object proxy, Method method, @Nullable Object[] args)
              throws Throwable {
            // If the method is a method from Object then defer to normal invocation.
            if (method.getDeclaringClass() == Object.class) {
              return method.invoke(this, args);
            }
            if (platform.isDefaultMethod(method)) {
              return platform.invokeDefaultMethod(method, service, proxy, args);
            }
            
            
            ServiceMethod serviceMethod =
                (ServiceMethod) loadServiceMethod(method);
                
            OkHttpCall