Retrofit原理解析

问题：

1、什么是Retrofit?
2、为什么要用Retrofit？
3、Retrofit原理？

问题1：什么是Retrofit?

Retrofit是squareup公司开源的一个网络请求工具框架，是一种用于Android和java进行网络请求的类型安全客户端。简单理解就是它是一种用于网络请求的工具框架，仅适用于Android和java。
细心的同学会提出疑问怎么是网络请求工具而不是网络请求呢？其实Retrofit对okhttp进行封装，方便网络请求的调用，真正实现网络请求的是okhttp，进行原来解析时会进行应证。

问题2：为什么要用Retrofit？

1、okhttp进行网络请求相对而言偏底层，使用还是比较麻烦，而Retrofit就是为了简便使用okhttp而开发的工具框架，Retrofit还提供了对请求、响应、okhttpclient等进行扩展
2、Retrofit实现了Restful api的设计风格

问题3：Retrofit原理

下面先对Retrofit核心源码进行解析，再对Retrofit原理进行总结：
使用Retrofit时，一般都是先build一个Retrofit实例：

Retrofit retrofit = new Retrofit.Builder()
                .baseUrl(HttpConst.HOST)
                .addConverterFactory(CustomGsonConverter.create(new GsonBuilder()
                        .disableHtmlEscaping()
                        .create()))
                .addCallAdapterFactory(RxJava2CallAdapterFactory.create())
                .client(buildOkHttp(builder))
                .build();

3.1、我们看下Retrofit.Builder的build方法

public Retrofit build() {
      //http url前缀，一般是域名
      if (baseUrl == null) {
        //如果baseUrl为空则抛出异常
        throw new IllegalStateException("Base URL required.");
      }
      //callFactory的实现类是OkHttpClient
      okhttp3.Call.Factory callFactory = this.callFactory;
      if (callFactory == null) {
         //如果callFactory 为空则创建一个默认的OkHttpClient
        callFactory = new OkHttpClient();
      }
      //http响应回调执行器
      Executor callbackExecutor = this.callbackExecutor;
      if (callbackExecutor == null) {
        //callbackExecutor为空，则使用平台的默认回调执行器
        callbackExecutor = platform.defaultCallbackExecutor();
      }
      
      //网络请求适配器工厂类，并添加平台的默认请求请求适配器工厂类
      // Make a defensive copy of the adapters and add the default Call adapter.
      List callAdapterFactories = new ArrayList<>(this.callAdapterFactories);
      callAdapterFactories.add(platform.defaultCallAdapterFactory(callbackExecutor));
      
      //网络响应内容解析工厂类，并添加BuiltInConverters
      // 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);
      //根据配置参数，构建Retrofit
      return new Retrofit(callFactory, baseUrl, unmodifiableList(converterFactories),
          unmodifiableList(callAdapterFactories), callbackExecutor, validateEagerly);
    }

上面的代码，可以总结构建Retrofit可配置的主要参数有：
a、baseUrl：http url 前缀，一般是域名，这个是必现要配置的
b、OkHttpClient: 可以不配置，如果配置了必现不为空，如果没有配置则默认创建一个新的OkHttpClient
c、callAdapterFactory: http请求适配器工厂类
d、converterFactory: http网络请求响应内容解析工厂类
3.2、build方法代码中有个platform，我们看下其实现：

public Builder() {
      this(Platform.get());
    }

Builder(Retrofit retrofit) {
      platform = Platform.get();
      //....省略
}

Platform.get的实现：

private static final Platform PLATFORM = findPlatform();

static Platform get() {
    return PLATFORM;
}

findPlatform方法的实现：

private static Platform findPlatform() {
    try {
      Class.forName("android.os.Build");
      if (Build.VERSION.SDK_INT != 0) {
        return new Android();
      }
    } catch (ClassNotFoundException ignored) {
    }
    try {
      Class.forName("java.util.Optional");
      return new Java8();
    } catch (ClassNotFoundException ignored) {
    }
    return new Platform();
  }

findPlatform方法是确定当前是Android还是java，它首先尝试调用Android的API，如果是Android则创建Android平台对象并返回；否则创建Java平台并返回
3.3、Retrofit的create方法
一般创建Retrofit之后，就通过create创建api请求的代理类，我们看下create方法的实现：

/**
@params service 网络请求代理类接口
*/
public  T create(final Class service) {
    //校验service是接口类型并且没有父类
    Utils.validateServiceInterface(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.
            //如果是Object对象，则直接调用Object的方法
            if (method.getDeclaringClass() == Object.class) {
              return method.invoke(this, args);
            }
            
            //如果调用的是默认方法，直接调用
            if (platform.isDefaultMethod(method)) {
              return platform.invokeDefaultMethod(method, service, proxy, args);
            }
            //对网络请求方法进行包装生成ServiceMethod
            ServiceMethod serviceMethod =
                (ServiceMethod) loadServiceMethod(method);
            //生成网络请求对象
            OkHttpCall