Android Retrofit框架源码分析（创建篇）

Android技术研究原创如需转载请注明出处

配置篇

上次分析了Retrofit的配置代码流程，这次分析下它的的create流程

Retrofit-create.png

首先分析restAdapter，它是一个Retrofit对象，以上代码调用了它的create方法，下面是create中的相关代码:

create.png

现在逐行分析以上代码，首先分析validateServiceInterface方法，以下是相关代码：

validateServiceInterface.png

这段代码告诉我们传递的参数必须是一个接口并且这个接口不可以有继承关系，否则会主动抛出一个异常，接着是eagerlyValidateMethods方法，这个方法的调用必须要validateEagerly为true，从配置篇中我们知道这个参数的默认值是false，所以在当前配置的操作中他是不会进入的，那么看下这个方法在true的时候会做的事情，以下是eagerlyValidateMethods方法的相关代码：

eagerlyValidateMethods.png

Platform.png

在以上的代码中两段代码中，首先获取了当前的平台，我们当前是android平台，那么相当于返回了一个Android platform ＝ new Android()的对象，接着判断service接口申明的方法是否是Platform的默认方法，如果不是则走loadMethodHandler(method)方法

loadMethodHandler.png

以上代码中首先在缓存列表methodHandlerCache中通过method去获取handler，当获取不到的时候创建一个新的handler，并且存入缓存列表methodHandlerCache中，到此位置eagerlyValidateMethods方法分析完毕，可以看到如果validateEagerly参数如果我们在配置的时候设置为true的时候，程序是在做一个预处理的操作，只是提前创建了一些MethodHandler对象在缓存中。

现在来分析下MethodHandler.create()方法做的事情，它需要两个参数一个是Retrofit对象，一个是当前的Method，代码如下:

methodHandler_create.png

以上代码中，先看最后返回的MethodHandler用到的对象，分别是Retrofit、CallAdapter、Converter、RequestFactory，首先分析CallAdpter的创建，代码如下:

createCallAdapter.png

以上代码中首先或者了Method的返回类型，然后对类型进行了校验，接着获取Method的所有注释，然后调用了Retorfit对象的callAdapter方法，传递的参数是当前方法的返回类型和注释数组，callAdapter方法如下：

callAdapter.png

nextcallAdapter.png

以上代码从indexOf这段开始看，这段是比较核心的，在配置篇中adapterFactories是被初始化过了，而且里面是有值的，包含RxJavaCallAdapterFactory，DefaultCallAdapter两个CallAdapter，那么现在indexOf方法中传递的参数从以上代码可以分析出来是null，那么返回值就是-1，start的值就是0，那么adapterFactories.get(0)返回的就是RxJavaCallAdapterFactory对象，这个时候再调用RxJavaCallAdapterFactory对象的get方法，代码如下:

get.png

getCallAdapter.png

以上代码主要看getCallAdapter方法，这里主要有三种方式会返回CallAdapter，第一种是Observable,第二种是Observable,其他对象(Observable<其他认识object>)都返回SimpleCallAdapter，现在看下初始化SimpleCallAdapt，它需要一个被观察者(Observable)的参数，下面是SimpleCallAdapter的代码:

SimpleCallAdapter.png

具体实现方法的作用现在不做解释，现在整个CallAdapter的create流程完毕了，也就是MethodHandler.create()方法中的CallAdapter有值了，是一个SimpleCallAdapter，在获取SimpleCallAdapter的过程中核心是通过接口方法获取了具体的返回类型。

接着看MethodHandler.create()方法中的第二行，因为我们在上面SimpleCallAdapter已经获取了response的类型，那么就可以获取到，这段代码不做解释，接着看createResponseConverter方法,这个方法返回Converter responseConverter，代码如下:

createResponseConverter.png

以上代码调用Retorfit中的responseConverter方法，传递的参数是当前Method的返回类型及注释数组，代码如下：

responseConverter.png

以上代码中可以看到converterFactories.get(i)方法，这个方法获取是我们在配置篇中初始化的GsonConverterFactory对象，调用了这个对象中的formResponseBody方法，传递参数是当前Method的返回类型及注释数组，代码如下:

formResponseBody.png

在以上代码中new了一个GsonResponseBodyConverter对象，传递了在配置篇中初始化的Gson对象及本篇中CallAdpater中获取的具体返回类型，目前位置GsonResponseBodyConverter的初始化工作也完毕了。

本篇分析比较长，在这里注释下GsonResponseBodyConverter具备的能力
1、已经具备了解析json数据的能力
2、已经知道了json解析后需要转换成什么类型(Observable<我们的对象类型>)

接着分析MethodHandler.create()中最后一个对象RequestFactory的获取，代码如下:

parse.png

先来分析parseMethodAnnotations方法，代码如下

parseMethodAnnotations.png

以上代码中遍历了当前Method的注释数组，并进行了解析，接着是解析传递的参数，代码如下:

par1.png

par2.png

这段代码比较长，留着后面单独分析，到目前位置已经解析了注释和参数类型，这个时候拿到了RequestFactory对象，代码如下:

Paste_Image.png

创建的流程完毕，在这个流程中，获取了三个对象CallAdapter后续介绍，Converter数据转换对象，RequestFactory数据解析对象。