Retrofit源码学习梳理

Retrofit已经出来很多时间了，项目中也一直在用，只知道它的功能强大，不知其原理，这不是一个号的开发，所以最近一段时间把retrofit源码研究了一下。我们先从它的功能说起。

retrofit功能

retrofit 是一个网络情况框架，配合Okhttp进行网络请求，但是retrofit本身实际是不参与网络请求的过程，它只是根据我们接口定义的参数和配置，生成对应的网络请求类(这个类默认是Httpclient)。

说完了功能，下面我们一点一点的来了解retrofit是怎样的工作流程。

1. Retrofit的创建

        Retrofit retrofit = new Retrofit.Builder()
                                              .baseUrl(baseUrl)
                                              .build();

retrofit的创建是通过retrofit内部的builder来构建的，使用了建造者模式很好的将使用者和调用者分离开了。

retrofit.builder中的属性很多，我们直接跳到build()方法看生产Retrofit

    public Retrofit build() {
          if (baseUrl == null) {
            throw new IllegalStateException("Base URL required.");
          }

          okhttp3.Call.Factory callFactory = this.callFactory;
          if (callFactory == null) {
            callFactory = new OkHttpClient();
          }

          Executor callbackExecutor = this.callbackExecutor;
          if (callbackExecutor == null) {
            callbackExecutor = platform.defaultCallbackExecutor();
          }

          // Make a defensive copy of the adapters and add the default Call adapter.
          List adapterFactories = new ArrayList<>(this.adapterFactories);
          adapterFactories.add(platform.defaultCallAdapterFactory(callbackExecutor));

          // Make a defensive copy of the converters.
          List converterFactories =
              new ArrayList<>(1 + this.converterFactories.size());

          // Add the built-in converter factory first. This prevents overriding its behavior but also
          // ensures correct behavior when using converters that consume all types.
          converterFactories.add(new BuiltInConverters());
          converterFactories.addAll(this.converterFactories);

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

中间主要是对retrofit 中设置一些默认的属性

• baseUrl:请求的base地址，不能为null,否则抛异常
• callFactory: 默认的网络请求，okhttpclient
• callbackExecutor:通过Platform获取到默认的请求线程调度器
• adapterFactories: 网络请求类转换器，默认添加了DefaultCallAdapterFactory
• converterFactories:网络结果response转化对象，默认添加了BuiltInConverters

简单说下PlatForm
platform会更具不同的平台处理不同的代码，这里我们主要关注的是Android

  static class Android extends Platform {
        @Override public Executor defaultCallbackExecutor() {
          return new MainThreadExecutor();
        }

        @Override CallAdapter.Factory defaultCallAdapterFactory(@Nullable Executor callbackExecutor) {
          if (callbackExecutor == null) throw new AssertionError();
          return new ExecutorCallAdapterFactory(callbackExecutor);
        }

        static class MainThreadExecutor implements Executor {
          private final Handler handler = new Handler(Looper.getMainLooper());

          @Override public void execute(Runnable r) {
            handler.post(r);
          }
        }
      }

可以留意到platform中提供两个方法
- defaultCallbackExecutor()默认的调度器，用来指定，我们回调在哪个线程调用
- defaultCallAdapterFactory()默认的CallAdapterFactory(这个类主要是用来将retrofit2.call请求类型转化为我们接口定义的类型转换器)，具体后面会说明

小结: 在retrofit创建的时候，已经初始化指定了一些默认参数
1. baseUrl:请求base地址
2. CallFactory: 网络请求类 OkhttpClient
3. CallBackExcutor: 网络返回调度器(默认是在主线程)
4. CallAdapterFactory: 网络请求类转换器(转换我们接口中定义的请求网络返回类型)
5. Convert: 默认返回response转换器

好了，retrofit的创建基本已经分析完了，下面的自定义的接口实例的创建了。

2.自定义接口类型的创建

retrofit.create(Interface.class)进去看方法。

    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