Retrofit2源码大致流程

注意：这篇文章不是一篇系统的文章，如果查看完整系统文章可以参考文末的相关文章。
这篇文章只对自己觉得重要的地方进行了分析。

使用方法：官方使用教程
主要有以下步骤：

1. 编写Api接口
2. 创建Retrofit实例
3. 获得ApiService
4. 获取请求
5. 执行请求（同步或者异步）

类似下面的代码：

//1.编写Api接口：
public interface GitHubService {
  @GET("users/{user}/repos")
  Call> listRepos(@Path("user") String user);
}
//2.创建Retrofit实例
Retrofit retrofit = new Retrofit.Builder()
        .baseUrl("https://api.github.com/")
        .addConverterFactory(GsonConverterFactory.create())
        .build();
//3.获得ApiService     
GitHubService service = retrofit.create(GitHubService.class); 
//4.获取请求  
Call> repos = service.listRepos("octocat");
//5.执行请求
repos.enqueue(new Callback>()
        {
            @Override
            public void onResponse(Call> call, Response> response)
            {
            }

            @Override
            public void onFailure(Call> call, Throwable t)
            {
            }
        });

源码解析：

首先给出Retrofit类中非常重要成员变量的解释：

  final okhttp3.Call.Factory callFactory;  //okhttpClient，用于产生Call请求
  final List converterFactories; //数据解析器，将ResponseBody和定义的数据类型进行转换
  final List adapterFactories; //对Call进行转化，默认为 ExecutorCallbackCall
  final @Nullable Executor callbackExecutor; // 请求返回的线程池

下面进行源码分析（基于上面提到的使用方式中的代码进行分析）：

1. 跟踪Retrofit的创建

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

底层实现（Retrofit.class）

//采用Build模式，通过传入的参数构建实例
public Retrofit build() {
    
      okhttp3.Call.Factory callFactory = this.callFactory;
      if (callFactory == null) {
        //所以可以看出callFactory其实是OkHttpClient，并且如果外部没有设定就自己new一个
        callFactory = new OkHttpClient();
      }
      
      //请求返回的线程执行者
      Executor callbackExecutor = this.callbackExecutor;
      if (callbackExecutor == null) {
        callbackExecutor = platform.defaultCallbackExecutor();
      }

      List adapterFactories = new ArrayList<>(this.adapterFactories);
      adapterFactories.add(platform.defaultCallAdapterFactory(callbackExecutor));
      
      //添加的GsonConverterFactory.create()存储converterFactories里
      List converterFactories = new ArrayList<>(this.converterFactories);

      return new Retrofit(callFactory, baseUrl, converterFactories, adapterFactories,
          callbackExecutor, validateEagerly);
    }
  }

2. ApiService的创建

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

底层实现（Retrofit.class）

//使用动态代理的方式进行对象构造。
//之所以选择接口的形式，个人认为是因为比较简洁
public  T create(final Class 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