Retrofit2源码阅读

本次分析的要点：

1. Retrofit中的动态代理和整个流程（Proxy、ServiceMethod、OkHttpCall）
2. Retrofit中的转换器和适配器（Converter、CallAdapter）

Retrofit整体流程和动态代理

首先我们回顾一下retrofit的使用demo

   Retrofit retrofit = new Retrofit.Builder()
                //设置OKHttpClient
                .client(okHttp.INSTANCE.getOkHttpClient())
                //Rx适配器
                .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
                //gson转化器
                .addConverterFactory(GsonConverterFactory.create())
                // 设置API基础的Url
                .baseUrl("https://www.baidu.com")
                // 创建Retrofit
                .build();
    BaiduAPI api = retrofit.create(BaiduAPI.class);
    
    Call call = api.getInfo();
    
    call.enqueue(new Callback() {
            @Override
            public void onResponse(Call call, Response response) {

            }

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

            }
        });
    
    public interface BaiduAPI{
        @GET("https://www.baidu.com)
        Call getInfo();
    }

retrofit的使用还是比较简单的，通过定义规定好的接口，通过Builder来创建Retrofit对象，通过create方法来创建接口的代理对象，然后调用定义好的方法就可以请求网络来获取数据了。

首先看一下Builder类吧

public static final class Builder {
    // 平台验证 JAVA和Android，这里是Android
    private final Platform platform;
    // 真正发起OkHttp3请求的Call类
    private @Nullable okhttp3.Call.Factory callFactory;
    // 将字符url包装为HttpUrl
    private HttpUrl baseUrl;
    // 转换工厂集合，Retrofit可以插入多个转换器，例如Gson，jackson等
    private final List converterFactories = new ArrayList<>();
    // 用于发起请求和接受相应的Call适配器集合
    private final List adapterFactories = new ArrayList<>();
    // 并发框架
    private @Nullable Executor callbackExecutor;
    // 是否立即加载所有的接口方法，转换为ServiceMethod对象，放在serviceMethodCache中
    private boolean validateEagerly;
    
    // 省略代码
    ...

重点是create方法

 public  T create(final Class service) {
    // 检查接口的合法性，必须是接口，并且不能继承其他接口
    Utils.validateServiceInterface(service);
    // 是否立即给接口中的所有方法生成包装类，默认是false
    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 {
            // 如果方法对象的类时Object的对象，就走普通的代理方法
            if (method.getDeclaringClass() == Object.class) {
              return method.invoke(this, args);
            }
            // 在Android平台上是是返回false的
            if (platform.isDefaultMethod(method)) {
              return platform.invokeDefaultMethod(method, service, proxy, args);
            }
            // 生成ServiceMethod对象，这个对象是为了将请求的方法是配成HTTP Call
            ServiceMethod serviceMethod =
                (ServiceMethod) loadServiceMethod(method);
            // 创建OkHttpCall对象
            OkHttpCall