本平臺的文章更新會有延遲挂滓，大家可以關(guān)注微信公眾號-顧林海馒索，包括年底前會更新kotlin由淺入深系列教程，目前計劃在微信公眾號進行首發(fā)红碑，如果大家想獲取最新教程舞吭，請關(guān)注微信公眾號，謝謝!
在使用Retrofit時析珊，需要創(chuàng)建Retrofit的實例羡鸥，定義一個網(wǎng)絡(luò)請求接口并為接口中的方法添加注解，接著通過動態(tài)代理生成網(wǎng)絡(luò)請求對象忠寻，關(guān)于動態(tài)代理的介紹可以查看《Android小知識-剖析Retrofit前的預(yù)備知識（靜態(tài)代理與動態(tài)代理）》惧浴，在Retrofit中會去解析在網(wǎng)絡(luò)請求接口中的注解，并配置網(wǎng)絡(luò)請求參數(shù)奕剃，通過動態(tài)代理攔截生成網(wǎng)絡(luò)請求對象衷旅。
內(nèi)部通過網(wǎng)絡(luò)請求適配器將網(wǎng)絡(luò)請求對象進行平臺適配捐腿，比如Android或Java8， 接著通過網(wǎng)絡(luò)請求執(zhí)行器發(fā)送網(wǎng)絡(luò)請求柿顶，這個網(wǎng)絡(luò)請求執(zhí)行器就是Call茄袖，這個Call就是對OkHttp的一個封裝，底層還是使用OkHttp來發(fā)送請求的嘁锯，服務(wù)端返回的數(shù)據(jù)會經(jīng)過數(shù)據(jù)轉(zhuǎn)換器進行解析绞佩，在《Android小知識-Retrofit框架的介紹以及使用方式》章節(jié)中，使用的是GsonConverter來解析數(shù)據(jù)猪钮，最終轉(zhuǎn)換成Java對象品山，接著通過回調(diào)執(zhí)行器切換線程，最后客戶端在主線程處理返回的結(jié)果烤低。
Retrofit retrofit = new Retrofit.Builder()
.baseUrl("http://icould.glh/")
.addConverterFactory(GsonConverterFactory.create())
.addCallAdapterFactory(RxJavaCallAdapterFactory.create())
.build();
上面創(chuàng)建Retrofit的實例在《Android小知識-Retrofit框架的介紹以及使用方式》中已經(jīng)講過了肘交，創(chuàng)建Retrofit實例采用的是構(gòu)建者模式，構(gòu)建者模式可以將一個對象的復(fù)雜構(gòu)建與表示進行分離扑馁，我們進入Retrofit的源碼涯呻。
public final class Retrofit {
private final Map<Method, ServiceMethod<?, ?>> serviceMethodCache = new ConcurrentHashMap<>();
final okhttp3.Call.Factory callFactory;
final HttpUrl baseUrl;
final List<Converter.Factory> converterFactories;
final List<CallAdapter.Factory> callAdapterFactories;
final @Nullable Executor callbackExecutor;
final boolean validateEagerly;
...
}
在具體分析源碼前，我們有必要了解Retrofit的幾個成員變量腻要。
serviceMethodeCache是一個LinkedHashMap對象复罐，它的key值是Method，對應(yīng)的就是Http的請求方法雄家，value是ServiceMethod效诅，ServiceMethod是對網(wǎng)絡(luò)請求接口內(nèi)的方法的注解進行解析封裝后的對象。
callFactory是網(wǎng)絡(luò)請求工廠趟济，在Retrofit內(nèi)默認的網(wǎng)絡(luò)請求工廠采用的就是OkHttpClient乱投。
baseUrl就是網(wǎng)絡(luò)請求的URL的基地址，baseUrl加上網(wǎng)絡(luò)請求接口中通過注解定義的相對地址顷编，就組成了一個完整的請求地址戚炫。
converterFactories是數(shù)據(jù)轉(zhuǎn)換器工廠集合，內(nèi)部存放的是數(shù)據(jù)轉(zhuǎn)換器工廠媳纬，而數(shù)據(jù)轉(zhuǎn)換器工廠是用于生產(chǎn)數(shù)據(jù)轉(zhuǎn)換器双肤，數(shù)據(jù)轉(zhuǎn)換器的作用就是對請求網(wǎng)絡(luò)之后的Response進行轉(zhuǎn)換，通過GsonConverter轉(zhuǎn)換成Java對象钮惠。
adapterFactories是網(wǎng)絡(luò)請求適配器工廠集合茅糜，內(nèi)部存放的是網(wǎng)絡(luò)請求適配器工廠，網(wǎng)絡(luò)適配器工廠是用生產(chǎn)網(wǎng)絡(luò)適配器萌腿，網(wǎng)絡(luò)請求適配器的作用就是將Call對象轉(zhuǎn)換成其他類型限匣，如果需要支持RxJava，就可以將Call對象轉(zhuǎn)換成RxJava平臺的Call。
callbackExecutor是一個線程池米死，用于執(zhí)行回調(diào)的線程池锌历。
validateEagerly是一個標(biāo)志位，是否需要立即解析接口中的方法峦筒，具體后面進行講解究西，這里先有個印象。
Retrofit的7個成員變量介紹完了物喷，接著進入Retrofit的Builder類：
public final class Retrofit {
...
public static final class Builder {
private final Platform platform;
private @Nullable okhttp3.Call.Factory callFactory;
private HttpUrl baseUrl;
private final List<Converter.Factory> converterFactories = new ArrayList<>();
private final List<CallAdapter.Factory> callAdapterFactories = new ArrayList<>();
private @Nullable Executor callbackExecutor;
private boolean validateEagerly;
...
}
...
}
Builder類是Retrofit的靜態(tài)內(nèi)部類卤材，成員變量platform表示Retrofit適配的平臺，主要包括Android和Java 8峦失，默認情況下使用的是Android平臺扇丛；callFactory表示請求網(wǎng)絡(luò)的OkHttp的工廠，默認情況下使用OkHttp來完成請求尉辑；baseUrl表示網(wǎng)絡(luò)請求的URL帆精，通過Builder的baseUrl方法傳入一個String類型的url，再將String類型的url轉(zhuǎn)換成HttpUrl隧魄；converterFactories是數(shù)據(jù)轉(zhuǎn)換器工廠的集合卓练；callAdapterFactories是網(wǎng)絡(luò)請求適配器工廠的集合；callbackExecutor用執(zhí)行異步回調(diào)购啄；validateEagerly是一個標(biāo)志位襟企，表示是否需要立即解析接口中的方法，在使用動態(tài)代理時對網(wǎng)絡(luò)請求接口中方法的注解進行解析時會用到這個標(biāo)志位狮含。
public final class Retrofit {
...
public static final class Builder {
public Builder() {
this(Platform.get());
}
...
}
...
}
在Builder的構(gòu)造函數(shù)中通過this傳入一個Platform類型顽悼，也就是適配的平臺，進入Platform的get方法：
private static final Platform PLATFORM = findPlatform();
static Platform get() {
return PLATFORM;
}
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();
}
Platform是一個單例類辉川，通過findPlatform方法來初始化實例表蝙，在靜態(tài)方法get中返回了PLATFORM靜態(tài)變量拴测，而PLATFORM靜態(tài)變量的初始化是在findPlatform方法中完成的乓旗，在findPlatform方法中先是通過反射加載"android.os.Build"類，接著返回一個Android平臺的Platform對象集索，我們看一下這個Android對象屿愚。
static class Android extends Platform {
@Override public Executor defaultCallbackExecutor() {
return new MainThreadExecutor();
}
@Override CallAdapter.Factory defaultCallAdapterFactory(@Nullable Executor callbackExecutor) {
if (callbackExecutor == null) throw new AssertionError();
return new ExecutorCallAdapterFactory(callbackExecutor);
}
static class MainThreadExecutor implements Executor {
private final Handler handler = new Handler(Looper.getMainLooper());
@Override public void execute(Runnable r) {
handler.post(r);
}
}
}
在defaultCallbackExecutor中返回一個MainThreadExecutor對象，表示默認的回調(diào)方法執(zhí)行器务荆，這個執(zhí)行器的作用是從子線程切換到主線程妆距，看下面MainThreadExecutor實現(xiàn)了Executor，是一個線程池函匕，并且內(nèi)部在創(chuàng)建Handler時傳入的是主線程的Looper娱据，通過Looper.getMainLooper()獲取主線程Looper，也就是說這個Executor和主線程已經(jīng)綁定了盅惜。繼續(xù)看Android類中的defaultCallAdapterFactory方法中剩，它表示創(chuàng)建一個默認的網(wǎng)絡(luò)請求適配器工廠的執(zhí)行器忌穿，在Call對象執(zhí)行異步請求時，需要一個執(zhí)行器將異步請求后的數(shù)據(jù)傳遞到主線程结啼，defaultCallAdapterFactory放內(nèi)傳入的就是異步請求時進行數(shù)據(jù)傳遞所需要的執(zhí)行器掠剑。
在Builder的無參構(gòu)造方法內(nèi)調(diào)用了有參構(gòu)造方法：
Builder(Platform platform) {
this.platform = platform;
}
將創(chuàng)建好的Android平臺Platform對象賦值給Builder類的成員變量platform。
Builder的相關(guān)成員變量的初始化已經(jīng)介紹完畢郊愧，接著看看它的build方法：
public Retrofit build() {
...
//創(chuàng)建OkHttpClient的工廠
okhttp3.Call.Factory callFactory = this.callFactory;
if (callFactory == null) {
callFactory = new OkHttpClient();
}
//創(chuàng)建主線程執(zhí)行器
Executor callbackExecutor = this.callbackExecutor;
if (callbackExecutor == null) {
callbackExecutor = platform.defaultCallbackExecutor();
}
//添加網(wǎng)絡(luò)請求適配器工廠
List<CallAdapter.Factory> callAdapterFactories = new ArrayList<>(this.callAdapterFactories);
callAdapterFactories.add(platform.defaultCallAdapterFactory(callbackExecutor));
//添加數(shù)據(jù)轉(zhuǎn)換器工廠
List<Converter.Factory> converterFactories =
new ArrayList<>(1 + this.converterFactories.size());
converterFactories.add(new BuiltInConverters());
converterFactories.addAll(this.converterFactories);
//創(chuàng)建Retrofit實例
return new Retrofit(callFactory, baseUrl, unmodifiableList(converterFactories),
unmodifiableList(callAdapterFactories), callbackExecutor, validateEagerly);
}
build方法中的注釋已經(jīng)很詳細了朴译，判斷callFactory是否為空，如果為空属铁，默認創(chuàng)建OkHttpClient眠寿，這也說明了Retrofit內(nèi)部默認是使用OkHttp來進行網(wǎng)絡(luò)請求的；callbackExecutor默認通過platform的defaultCallbackExecutor方法獲取執(zhí)行器焦蘑，這里的platform默認是Android平臺澜公，在前面講解Android平臺類時，就已經(jīng)知道了它的defaultCallbackExecutor方法返回的是主線程的執(zhí)行器喇肋，最終數(shù)據(jù)就是通過主線程的執(zhí)行器發(fā)送到主線程的坟乾。
創(chuàng)建完主線程的執(zhí)行器后，添加網(wǎng)絡(luò)請求適配器工廠蝶防，這里添加了Android平臺的defaultCallAdapterFactory方法傳入主線程的執(zhí)行器甚侣，這樣在進行異步請求后可以通過主線程的執(zhí)行器進行數(shù)據(jù)傳遞。
最后就是添加數(shù)據(jù)轉(zhuǎn)換器工廠间学，默認添加了一個BuiltInConverters對象殷费，BuiltInConverters表示的是內(nèi)置的默認的數(shù)據(jù)轉(zhuǎn)換器工廠。
搜索微信“顧林旱秃”公眾號详羡，定期推送優(yōu)質(zhì)文章。
