Retrofit配置RxJava真的很好用。
希望亲们看的时候,自己也看下代码,这样效果最好了。
1. 初始化过程
一般来说,我们通过Builder去初始化Retrofit。我们看看支持我们配置那些呢。如下图:
- platform 平台信息(java,android,ios)
- callFactory 进行实际请求的(一般为okhttpclient)
- baseUrl baseUrl
- convertFactories 包装器集合,对请求数据和响应数据进行包装的东西
- adapterFactories 适配器集合,用来配置其他框架使用的,如RxJava
- callbackExecuter 执行回调的小玩意
- validateEagerly 是否先进行ServiceMethod的初始化(稍后就介绍ServiceMethod)
我们针对platform和callbackExecuter来说下。
2. Platform 平台信息
Android为例,如图
callbackExecuter,就是defaultCallbackExecutor返回值,对应Android平台也就是这个了。这里就不多介绍了哈。
3. Retrofit#create
这个方法中,用动态代理的方式,构建出我们的ApiService。瞟一眼代码。
上面提到的validateEagerly,在这里起到作用了,eagerlyValidateMethods方法体中是什么呢?看一下。
没错,也是loadServiceMethod,和我们在InvocationHandler中load并没有很么区别,唯一的区别就是先手顺序了。
create方法非常重要的三步骤,就是最下面的三行代码。
- 构建ServiceMethod
- 构建OKHttpCall
- 构建ApiService
ok,我们继续。
4. ServiceMethod
先来看看loadServiceMethod方法。
优质代码无处不在!!!ServiceMethod被缓存起来,没有缓存,在初始化。平常没有缓存这种思想,一定要注意了。
我们来看ServiceMethod.Builder的初始化方法干了什么。
这里就是获取我们的注解信息
- getAnnotations 获取方法的注解
- getGenericParameterTypes 获取参数的类型
- getParameterAnnotations 获取参数的注解
接下来,就是build方法了。这个方法很重要,也是核心。代码稍长,我们分段来看,啦啦啦。
- 初始化callAdapter
- 出实处responseType
- 初始化responseConverter
createCallAdapter,根据method的返回值和注解返回callAdapter
会调用Retrofit类的这里。
我们添加RxJava的Adapter,用Observable<>的时候,就会返回RxJavaAdapter,当然,有一个默认的Adapter,就是这个DefaultCallAdapterFactory。
responseType,DefaultCallAdapterFactory就是Call<?> 中?的部分,为什么呢?这是由于会使用utils来获取泛型参数类型的关系
同理createResponseConverter,也调用了Retrofit里的方法,返回对应的Converter,当然,这里也有个默认的BuiltInConverters,如果我们添加了GsonConverter的话,就会返回Gson相关的。
然而,这并没有完,接下来会解析methodAnnotations。将都安排哟普那个parseMethodAnnotation方法,我们以解析POST为例。 parseHttpMethodAndPath(“POST”, ((POST) annotation).value(), true);如图:
- 确保url中参数不含{}块,要用@Query来替代,就是说url不能是/xxx?name={xx},这样的。
- 解析url中查询参数
解析其他标签,也类似,当然,有几个不同,如图:
到这里。你以为ServiceMethod.Builder#build完了么?年轻,继续
这部分代码是干啥子。当然是解析参数中的注解了。
请留意一下ParameterHandler类,我们稍后会用到。
parseParameter,解析了我们的参数的注解,返回ParameterHandler。
我们重点看下parseParameterAnnotation方法,这个方法巨长。我们看下Field相关的一段。
- 参数类型是Iterable
- 参数是Array
- 其他
三种参数类型对应的代码,唯一的区别就在与Converter。一般来说,我们传的Field为String(以简单的来看。。。),那么最终就会调用下面这行代码(Retrofit.class里面)
return (Converter<T, String>) BuiltInConverters.ToStringConverter.INSTANCE;
,没错,默认的Convert。现在我们回过头来,来看ParameterHandler类。这次我们看他的子类,ParameterHandler.FIeld类。
,哈,到这里,这个类只是浮现在我们的眼前,他的关键用处,让我们回到Retrofit#create方法。
ps:到这里,ServiceMethod暂时完结了。
5. Retrofit#create方法剩下的两行代码
OkHttpCall okHttpCall = new OkHttpCall<>(serviceMethod, args);
return serviceMethod.callAdapter.adapt(okHttpCall);
adapt 干了什么呢?默认的是DefaultCallAdapterFactory,(我们平常使用RxJavaCallAdapter),而DefaultCallAdapterFactory.adapt直接返回okhttpCall。我们接下来就会调用OkHttpCall的enqueue方法。到这里,就基本将后续交给OkHttp了。不过,在enqueue方法中会调用createRawCall。
6. OkHttpCall#createRawCall
Request request = serviceMethod.toRequest(args);
亚哈,又转区serviceMethod的。
7. serviceMethod#toRequest
看到没。这行代码中,出现了parameterHandlers。并且出现了apply。
我们看看去。还是以Field为
apply方法,调用RequestBuilder的addFormField方法,添加一个表单字段,其他同理。
最后,调用build方法,组装完成的Request,然后交给Okhttp来执行,后面的事,就不说了。
如果觉得对您有帮助,点一波关注吧。