Retrofit源码之请求对象的转换笔记

2023-09-12 22:44:04 177

之前在Retrofit源码初探一文中我们提出了三个问题：

什么时候开始将注解中参数拼装成http请求的信息的？
如何产生发起http请求对象的？
如何将对象转换成我们在接口中指定的返回值的？

其中前两个问题在前几篇文章已经做了解答，今天我们探究下最后一个问题：

我们定义接口时，有这样的：

@GET("hello/world")
CallgetNews(@Query("num")Stringnum,@Query("page")Stringpage);

也有这样的：

@GET("book/search")
ObservablegetSearchBook(@Query("q")Stringname,
@Query("tag")Stringtag,@Query("start")intstart,
@Query("count")intcount);

可以看到接口的返回值是不一样的，现在我们就来分析下，一个OkHttpCall对象是如何转换成对应的返回值的。

核心代码是这句：

returnserviceMethod.adapt(okHttpCall);

进到adapt中去：

Tadapt(Callcall){
returncallAdapter.adapt(call);
}

可以看到是调用了callAdapter.adapt方法，此处的callAdapter是一个接口类型，所以想要看它的adapt方法的具体实现就得看这个callAdapter具体怎么生成的。

经过搜索，发现它的生成方式如下：

ServiceMethod(Builderbuilder){
//………………
this.callAdapter=builder.callAdapter;
//………………
}

而这个构造方法是在ServiceMethod.Builder的build方法中调用的：

publicServiceMethodbuild(){
callAdapter=createCallAdapter();
//…………
returnnewServiceMethod<>(this);
}

所以继续跟进createCallAdapter()中去：

privateCallAdaptercreateCallAdapter(){
TypereturnType=method.getGenericReturnType();
if(Utils.hasUnresolvableType(returnType)){
throwmethodError(
"Methodreturntypemustnotincludeatypevariableorwildcard:%s",returnType);
}
if(returnType==void.class){
throwmethodError("Servicemethodscannotreturnvoid.");
}
Annotation[]annotations=method.getAnnotations();
try{
//noinspectionunchecked
return(CallAdapter)retrofit.callAdapter(returnType,annotations);
}catch(RuntimeExceptione){//Wideexceptionrangebecausefactoriesareusercode.
throwmethodError(e,"Unabletocreatecalladapterfor%s",returnType);
}
}

可以看到，这里的主要作用就是获取方法级别的注解以及返回值，然后传入到retrofit.callAdapter中去获取正真的CallAdapter，所以继续跟到retrofit.callAdatper中去：

publicCallAdaptercallAdapter(TypereturnType,Annotation[]annotations){
returnnextCallAdapter(null,returnType,annotations);
}

继续进到nextCallAdapter中：

publicCallAdapternextCallAdapter(@NullableCallAdapter.FactoryskipPast,TypereturnType,
Annotation[]annotations){
checkNotNull(returnType,"returnType==null");
checkNotNull(annotations,"annotations==null");

intstart=callAdapterFactories.indexOf(skipPast)+1;
for(inti=start,count=callAdapterFactories.size();iadapter=callAdapterFactories.get(i).get(returnType,annotations,this);
if(adapter!=null){
returnadapter;
}
}
//省略一些不重要代码
}

这里主要就是遍历Retrofit的所有CallAdapter，然后找到能够处理该返回类型以及方法注解的那个直接返回。
对于默认返回类型的处理CallAdapter，其实是在Retrofit生成时默认加上的：

publicRetrofitbuild(){
//省略部分代码
ExecutorcallbackExecutor=this.callbackExecutor;
if(callbackExecutor==null){
callbackExecutor=platform.defaultCallbackExecutor();
}

//MakeadefensivecopyoftheadaptersandaddthedefaultCalladapter.
ListcallAdapterFactories=newArrayList<>(this.callAdapterFactories);
callAdapterFactories.add(platform.defaultCallAdapterFactory(callbackExecutor));
//省略部分代码
returnnewRetrofit(callFactory,baseUrl,unmodifiableList(converterFactories),
unmodifiableList(callAdapterFactories),callbackExecutor,validateEagerly);
}

这里有一点要事先说下，所有的CalllAdapter对象其实都是通过CallAdapter.Factory对象调用get()方法生成的。
所以这里利用platform.defaultCallAdapterFactory()生成了一个对应的CallAdapter.Factory对象，但生成这个对象首先生成了一个callbackExecutor,我们先看下它是怎么回事：

@NullableExecutordefaultCallbackExecutor(){
returnnull;
}

咦，为什么是返回null的？别慌，Retrofit的build中的platform根据不同的情况会是不同的子类，并不一定是Platform的实例，而是它的子类：

staticclassAndroidextendsPlatform{
@OverridepublicExecutordefaultCallbackExecutor(){
returnnewMainThreadExecutor();
}

@OverrideCallAdapter.FactorydefaultCallAdapterFactory(@NullableExecutorcallbackExecutor){
if(callbackExecutor==null)thrownewAssertionError();
returnnewExecutorCallAdapterFactory(callbackExecutor);
}

staticclassMainThreadExecutorimplementsExecutor{
privatefinalHandlerhandler=newHandler(Looper.getMainLooper());

@Overridepublicvoidexecute(Runnabler){
handler.post(r);
}
}
}

我们重点关注Android平台的，可以看到这里生成的callbackExecutor的execute()方法主要就是用来将操作发送到主线程执行。

ok,callbackExecutor我们弄清楚了，那么接下来我们继续看platform.defaultCallAdapterFactory()方法生成了什么样的CallAdapter.Factory对象:

CallAdapter.FactorydefaultCallAdapterFactory(@NullableExecutorcallbackExecutor){
if(callbackExecutor!=null){
returnnewExecutorCallAdapterFactory(callbackExecutor);
}
returnDefaultCallAdapterFactory.INSTANCE;
}

对于Android平台来说，我们之前生成了一个对应的callbackExecutor,所以我们继续跟进if中的语句,发现最终生成了一个ExecutorCallAdapterFactory()对象，当然，我们主要是看它的get()方法能得到什么样的CallAdapter对象：

@Override
publicCallAdapterget(TypereturnType,Annotation[]annotations,Retrofitretrofit){
if(getRawType(returnType)!=Call.class){
returnnull;
}
finalTyperesponseType=Utils.getCallResponseType(returnType);
returnnewCallAdapter>(){
@OverridepublicTyperesponseType(){
returnresponseType;
}

@OverridepublicCall

Retrofit源码之请求对象的转换笔记

热门推荐

随机推荐