Retrofit解析9之流程解析

整体Retrofit内容如下：

• 1、Retrofit解析1之前哨站——理解RESTful
• 2、Retrofit解析2之使用简介
• 3、Retrofit解析3之反射
• 4、Retrofit解析4之注解
• 5、Retrofit解析5之代理设计模式
• 6、Retrofit解析6之面向接口编程
• 7、Retrofit解析7之相关类解析
• 8、Retrofit解析8之核心解析——ServiceMethod及注解1
• 9、Retrofit解析8之核心解析——ServiceMethod及注解2
• 10、Retrofit解析9之流程解析
• 11、Retrofit解析10之感谢

本片文章的主要内容如下：

• 1、整体流程简介
• 2、流程详解
• 3、总结
• 4、okHttp+Retrofit的整体架构

一、Retrofit整体流程简介

其实整个Retrofit的流程如下图：

retrofit.png

PS:该图不是我画的，网上盗来的

• 这张图完美的诠释了Retrofit的整个流程图
• 首选创建Retrofit，配置响应的参数，然后Retrofit会的的请求都会交给OkHttp去执行，执行的结果返回Response，再根据转换器进行解析成相对应的返回值类型T。Retrofit内部使用了动态代理，方便了使用，通过retrofit.create返回的其实是一个动态代理类，所有具体的逻辑处理交给ServiceMethod来进行处理。

如果抛各种开适配器和Converter的情况，只考虑发起请求，我们可以这样理解的流程如下图:

单一流程.png

Retrofit总体使用的是外观模式，Retrofit持有所有子系统的引用；Retrofit有两个比较重要的两个Factory，一个是用来生成对应"Call"的CallAdapter的CallAdapterFactory；一个是用来进行响应数据转化(反序列化)的ConvertFactory；这两个都可以用户自己进行添加。在自定义的Service中，每一个method一一对应一个ServiceMethod，而ServiceMethod持有一个Retrofit，前面两个Factory以及生成的Request的RequestBuilder；在okHttp中，Request需要自己进行定义创建，而Retrofit简化了这个操作，进行相应的封装，使用注解的方式来定义RequestBuilder相关参数信息；注解信息的解析则在parseMethodAnnotation()方法里面和parseParameterAnnotation()方法里面分别解析方法注解和参数注解。最终通过RequestBuilder来具体陈生一个Request，RequestBuilder中持有okHttp中的Request.Builder类的引用，其创建Request的过程其实都是交给okHttp来操作的；生成的Request最终封装成一个OkHttpCall，OkHttpCall则可以看做是对okHttp中Call的代理，同时对okHttp的返回Response进行解析，使用convertFactory将其解析为用户所期望的返回类型。

二、流程详解

我们讲解Retrofit整体流程，就依据官方给的demo来吧，代码如下：
代码如下：

public interface GitHub {
    @GET("/repos/{owner}/{repo}/contributors")
    Call> contributors(
        @Path("owner") String owner,
        @Path("repo") String repo);
  }

  public static void main(String... args) throws IOException {
    Retrofit retrofit = new Retrofit.Builder()
        .baseUrl(API_URL)
        .addConverterFactory(GsonConverterFactory.create())
        .build();
    GitHub github = retrofit.create(GitHub.class);
    Call> call = github.contributors("square", "retrofit");
    List contributors = call.execute().body();
    for (Contributor contributor : contributors) {
      System.out.println(contributor.login + " (" + contributor.contributions + ")");
    }
  }

这就是Retrofit最简单的用法，可以从代码看出：

• 首先定义一个接口，接口中的方法用注解方式声明了HTTP请求的相关参数，包括GET方法，相关参数等。方法的返回值为Call>，其中Contributor是定义的一个JavaBean类，即业务所需要的数据格式。
• 其次实例化了一个Retrofit对象，用Retrofit的builder，指定了baseUrl，指定了ConverterFactory，即表示用Gson解析返回值来得到JavaBean。
• 用retrofit.create(GitHub.class)方法得到了一个GitHub实例对象(框架动态代理的方法帮我们生成了接口的实例，后续详细说)

(3).用retrofit.create(GitHub.class)方法得到了GitHub实例对象(框架用动态代理的方式帮我们生成了接口的实例，后续详细说)，调用对象方法得到call对象。其中，call对象有excute()和enqueue()方法，分别为同步和异步进行网络请求。

所以我们把整个流程分解为5大部分

• 1、Retrofit初始化
• 2、发起网络请求
• 3、执行请求
• 4、处理响应

(一)、Retrofit初始化

具体代码如下：

        .baseUrl(API_URL)
        .addConverterFactory(GsonConverterFactory.create())
        .build();

Retrofit的构建，其实就是一个简单的建造者模式(Builder)，通过Builder来进行构建。如下图所示：

Retrofit.Builder.png

其中Retrofit.Builder有以下参数可以设置:

• okhttp3.Call.Factory callFactory。
• HttpUrl baseUrl。
• List converterFactories。
• List adapterFactories。
• Executor callbackExecutor。
• boolean validateEagerly。

补充说明:

• 由于是调用无参的Retrofit.Builder()的构造函数，而无参的构造函数内部又调用了 this(Platform.get());在 this(Platform.get())里面有调用了 converterFactories.add(new BuiltInConverters())，所以Builder的里面默认带一个BuiltInConverters的实例。
• 以上参数均可以通过Retrofit.Builder的addXXX方法进行添加，如果大家对上面的变量理解有疑问，请看上篇文章。

下面我们重点说下build()方法的内容:
代码如下；

 public Retrofit build() {
      if (baseUrl == null) {
        throw new IllegalStateException("Base URL required.");
      }
      // 创建OkHttp，目前Retrofit只支持OkHttp
      okhttp3.Call.Factory callFactory = this.callFactory;
      if (callFactory == null) {
        callFactory = new OkHttpClient();
      }
      // 创建Executor
      Executor callbackExecutor = this.callbackExecutor;
      if (callbackExecutor == null) {
        callbackExecutor = platform.defaultCallbackExecutor();
      }
     // 对adapters进行保护性拷贝，并且加入默认的call adapter（使用上面创建的Executor来构建，可以认为是把主线程中的Handler传入， 构建adapterFactories集合，将defaultAdapterFactory加入其中
      List adapterFactories = new ArrayList<>(this.adapterFactories);
  adapterFactories.add(platform.defaultCallAdapterFactory(callbackExecutor));
      // 对converters进行保护性拷贝，一般传入的为GsonConverterFactory对象，其作用主要是将json转换成java对象
      List converterFactories = new ArrayList<>(this.converterFactories);
       //构建Retrofit对象
      return new Retrofit(callFactory, baseUrl, converterFactories, adapterFactories,
          callbackExecutor, validateEagerly);
    }

build方法主要思路：

• 1、创建callFactory对象
• 2、创建callbackExecutor对象，有平台可知，其实就是主线程，通过MainLooper来构建Handler，其execute方法本质是Handler.post(runnable)，主要用于线程切换
• 3、创建adapterFactories集合，同时添加一个默认的adapterFactory，即通过调用platform.defaultCallAdapterFactory(callbackExecutor)，其实就是ExecutorCallAdapterFactory类实例，这样保证adapterFactories里面至少有一个adapterFactory。而ExecutorCallAdapterFactory的get(Type,Annotation[], Retrofit)方法里面返回的CallAdapter其实是一个new的一个匿名内部类，而这个匿名内部类的里面的adapt(Call