Android Retrofit 2.5.0 源碼分析

主要參考文章:
Android Retrofit 2.0 的詳細(xì) 使用攻略(含實(shí)例講解)
Android:手把手帶你 深入讀懂 Retrofit 2.0 源碼

主要過(guò)程:
1撬碟、建造者模式- 初始化所需 變量
2叠殷、使用retrofit.create(AccessApi.class) 生成動(dòng)態(tài)代理對(duì)象该窗,調(diào)用方法時(shí),解析方法上的 注解+參數(shù)+參數(shù)的注解 生成ServiceMethod 并緩存
3腻菇、ServiceMethod 中能獲取到retrofit初始化的變量作岖,ServiceMethod.invoke(...) 中使用 這些變量發(fā)起請(qǐng)求callAdapter.adapt(new OkHttpCall<>(requestFactory, args, callFactory, responseConverter));
4、以rxjava為例胁住,ServiceMethod.invoke(...) 返回來(lái)Observable趁猴, 訂閱者->callAdapter->OkHttpCall->okhttp3.Call->網(wǎng)絡(luò)請(qǐng)求->okhttp3.Call->OkHttpCall->converter數(shù)據(jù)解析->callAdapter->訂閱者

1刊咳、初始化

主要是初始化以下 Retrofit 變量

變量 說(shuō)明
callFactory OkHttpClient 調(diào)用newCall(...) 生成 原始請(qǐng)求
CallbackExecutor MainThreadExecutor使用handler切換到主線程
CallAdapterFactories 對(duì)OkHttpCall在一次包裝,可以理解為CallAdapter(OkHttpCall(okhttp3.Call))
ConverterFactories 在OkHttpCall中 對(duì) 返回的原始數(shù)據(jù)進(jìn)行 解析
HttpLoggingInterceptor loggerInterceptor = new HttpLoggingInterceptor();//打印 信息
loggerInterceptor.setLevel(HttpLoggingInterceptor.Level.BODY);
OkHttpClient client = new OkHttpClient.Builder().addNetworkInterceptor(loggerInterceptor).build();
// 初始化Retrofit
mRetrofit = new Retrofit.Builder()
    .client(client)
    .baseUrl(baseUrl)
    .addConverterFactory(GsonConverterFactory.create(buildGson()))
    .addCallAdapterFactory(RxJava2CallAdapterFactory.create())
    .build();

1.1 Retrofit.Builder() 變量

private final Platform platform; //平臺(tái)類型
private @Nullable okhttp3.Call.Factory callFactory;//OkHttpClient

private @Nullable HttpUrl baseUrl;
//自己添加的 GsonConverterFactory
private final List<Converter.Factory> converterFactories = new ArrayList<>();
//自己添加的 RxJava2CallAdapterFactory
private final List<CallAdapter.Factory> callAdapterFactories = new ArrayList<>();
//沒(méi)賦值 就是用 platform.defaultCallbackExecutor() = MainThreadExecutor
private @Nullable Executor callbackExecutor;
private boolean validateEagerly;

平臺(tái)類型 有 Android儡司, java8娱挨;這里主要看android

平臺(tái)類型 CallbackExecutor CallAdapterFactories ConverterFactories
Android MainThreadExecutor CompletableFutureCallAdapterFactory
(api 24以上才有)
ExecutorCallAdapterFactory
OptionalConverterFactory
(api 24以上才有)
java8 。捕犬。跷坝。 。碉碉。柴钻。 。垢粮。贴届。

1.2 Retrofit.Builder.build() 得到Retrofit 實(shí)例

Retrofit(okhttp3.Call.Factory callFactory, HttpUrl baseUrl,
List<Converter.Factory> converterFactories, List<CallAdapter.Factory> callAdapterFactories,
@Nullable Executor callbackExecutor, boolean validateEagerly) {

  this.callFactory = callFactory;//OkHttpClient
  this.baseUrl = baseUrl;
  this.converterFactories = converterFactories; // Copy+unmodifiable at call site.
  //BuiltInConverters + 自己添加的 + android平臺(tái) 
  //BuiltInConverters、GsonConverterFactory蜡吧、 OptionalConverterFactory(api24以上有)
  this.callAdapterFactories = callAdapterFactories; // Copy+unmodifiable at call site.
  //自己添加的+android平臺(tái)  RxJava2CallAdapterFactory,CompletableFutureCallAdapterFactory(>api24)毫蚓、ExecutorCallAdapterFactory
  this.callbackExecutor = callbackExecutor;//android 平臺(tái)來(lái)說(shuō)就是 MainThreadExecutor
  this.validateEagerly = validateEagerly;//作用:是否提前對(duì)業(yè)務(wù)接口中的注解進(jìn)行驗(yàn)證轉(zhuǎn)換的標(biāo)志位

}
-- CallbackExecutor CallAdapterFactories ConverterFactories
Retrofit.Builder MainThreadExecutor CompletableFutureCallAdapterFactory(>api24)
ExecutorCallAdapterFactory
OptionalConverterFactory
(>api24)
Retrofit MainThreadExecutor RxJava2CallAdapterFactory
CompletableFutureCallAdapterFactory(>api24)
ExecutorCallAdapterFactory
BuiltInConverters
GsonConverterFactory
OptionalConverterFactory
(>api24)

2、使用

構(gòu)建用了動(dòng)態(tài)代理昔善, 最終是通過(guò)okhttp
2.1 ServiceMethod 構(gòu)建

public class JavaBean {}
public interface AccessApi {
  @GET("openapi.do?keyfrom=Yanzhikai&key=2032414398&type=data&doctype=json&version=1.1&q=car")
  Call<JavaBean> getCall();
}
AccessApi NetService = retrofit.create(AccessApi.class);
Call<JavaBean> call = NetService.getCall();

retrofit.create(AccessApi.class) 生成 代理對(duì)象

public <T> T create(final Class<T> service) {
    Utils.validateServiceInterface(service);
    if (validateEagerly) {
      eagerlyValidateMethods(service);//提前解析所有方法绍些,加入緩存
    }
    return (T) Proxy.newProxyInstance(service.getClassLoader(), new Class<?>[] { service },
       new InvocationHandler() {
        private final Platform platform = Platform.get();
        private final Object[] emptyArgs = new Object[0];

        @Override public Object invoke(Object proxy, Method method, @Nullable Object[] args)
        throws Throwable {//返回 接口方法的返回參數(shù),即方法返回的結(jié)果
            // If the method is a method from Object then defer to normal invocation.
            if (method.getDeclaringClass() == Object.class) {
                return method.invoke(this, args);
            }
            //1.8之后接口可以有默認(rèn)的實(shí)現(xiàn)
            if (platform.isDefaultMethod(method)) {
                return platform.invokeDefaultMethod(method, service, proxy, args);
            }
            return loadServiceMethod(method).invoke(args != null ? args : emptyArgs);
        }
       });
}

loadServiceMethod(…) —> ServiceMethod.parseAnnotations(this, method); 根據(jù)方法的注解 生成 ServiceMethod實(shí)例

static <T> ServiceMethod<T> parseAnnotations(Retrofit retrofit, Method method) {
    RequestFactory requestFactory = RequestFactory.parseAnnotations(retrofit, method);
    //解析方法的注解耀鸦,方法參數(shù)的注解柬批,加上各種校驗(yàn)注解使用的正確性,構(gòu)造出RequestFactory袖订,待新建請(qǐng)求時(shí)使用

    Type returnType = method.getGenericReturnType();
    if (Utils.hasUnresolvableType(returnType)) {
        throw methodError(method,"Method return type must not include a type variable or wildcard: %s", returnType);
    }
    if (returnType == void.class) {
        throw methodError(method, "Service methods cannot return void.");
    }
    return HttpServiceMethod.parseAnnotations(retrofit, method, requestFactory);
}

HttpServiceMethod<ResponseT, ReturnT> extends ServiceMethod<ReturnT>
返回了 new HttpServiceMethod<>(requestFactory, callFactory, callAdapter, responseConverter)

參1氮帐、requestFactory = RequestFactory.parseAnnotations(retrofit, method);
參2、callFactory = retrofit.callFactory//OkHttpClient
參3洛姑、callAdapter 從 retrofit.callAdapterFactories 中 根據(jù)返參和注解上沐,查找并生成 合適的CallAdapter;
參4楞艾、responseConverter 從 retrofit.converterFactories中 根據(jù)返參和注解参咙,查找并生成 合適的Converter

2.2 ServiceMethod 方法的調(diào)用

@Override ReturnT invoke(Object[] args) {
return callAdapter.adapt(
    new OkHttpCall<>(requestFactory, args, callFactory, responseConverter));
}

OkHttpCall中會(huì)新建 原始請(qǐng)求,okhttp3 的請(qǐng)求

private okhttp3.Call createRawCall() throws IOException {
  okhttp3.Call call = callFactory.newCall(requestFactory.create(args));
  if (call == null) {
    throw new NullPointerException("Call.Factory returned null.");
  }
  return call;
}

OkHttpCall.enqueue(final Callback<T> callback) --> 調(diào)用 okhttp3.Call.enqueue(new okhttp3.Callback() {...}
結(jié)果返回后通過(guò) responseConverter.convert(...) 將okhttp3 返回的數(shù)據(jù) 解析 為 想要的返回值(如Gson 轉(zhuǎn)型)最后是一層一層回調(diào)出去硫眯。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末蕴侧,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子两入,更是在濱河造成了極大的恐慌净宵,老刑警劉巖,帶你破解...
    沈念sama閱讀 218,607評(píng)論 6 507
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異择葡,居然都是意外死亡紧武,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,239評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門(mén)敏储,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)阻星,“玉大人,你說(shuō)我怎么就攤上這事已添⊥谆” “怎么了?”我有些...
    開(kāi)封第一講書(shū)人閱讀 164,960評(píng)論 0 355
  • 文/不壞的土叔 我叫張陵酝碳,是天一觀的道長(zhǎng)矾踱。 經(jīng)常有香客問(wèn)我恨狈,道長(zhǎng)疏哗,這世上最難降的妖魔是什么? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 58,750評(píng)論 1 294
  • 正文 為了忘掉前任禾怠,我火速辦了婚禮返奉,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘吗氏。我一直安慰自己芽偏,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,764評(píng)論 6 392
  • 文/花漫 我一把揭開(kāi)白布弦讽。 她就那樣靜靜地躺著污尉,像睡著了一般。 火紅的嫁衣襯著肌膚如雪往产。 梳的紋絲不亂的頭發(fā)上被碗,一...
    開(kāi)封第一講書(shū)人閱讀 51,604評(píng)論 1 305
  • 那天,我揣著相機(jī)與錄音仿村,去河邊找鬼锐朴。 笑死,一個(gè)胖子當(dāng)著我的面吹牛蔼囊,可吹牛的內(nèi)容都是我干的焚志。 我是一名探鬼主播,決...
    沈念sama閱讀 40,347評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼畏鼓,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼酱酬!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起云矫,我...
    開(kāi)封第一講書(shū)人閱讀 39,253評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤岳悟,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體贵少,經(jīng)...
    沈念sama閱讀 45,702評(píng)論 1 315
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡呵俏,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,893評(píng)論 3 336
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了滔灶。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片普碎。...
    茶點(diǎn)故事閱讀 40,015評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖录平,靈堂內(nèi)的尸體忽然破棺而出麻车,到底是詐尸還是另有隱情,我是刑警寧澤斗这,帶...
    沈念sama閱讀 35,734評(píng)論 5 346
  • 正文 年R本政府宣布动猬,位于F島的核電站,受9級(jí)特大地震影響表箭,放射性物質(zhì)發(fā)生泄漏赁咙。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,352評(píng)論 3 330
  • 文/蒙蒙 一免钻、第九天 我趴在偏房一處隱蔽的房頂上張望彼水。 院中可真熱鬧,春花似錦极舔、人聲如沸凤覆。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 31,934評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)盯桦。三九已至,卻和暖如春渤刃,著一層夾襖步出監(jiān)牢的瞬間拥峦,已是汗流浹背。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 33,052評(píng)論 1 270
  • 我被黑心中介騙來(lái)泰國(guó)打工溪掀, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留事镣,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 48,216評(píng)論 3 371
  • 正文 我出身青樓揪胃,卻偏偏與公主長(zhǎng)得像璃哟,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子喊递,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,969評(píng)論 2 355

推薦閱讀更多精彩內(nèi)容

  • 目錄介紹 1.首先回顧Retrofit簡(jiǎn)單使用方法 2.Retrofit的創(chuàng)建流程源碼分析2.1 Retrofit...
    楊充211閱讀 1,061評(píng)論 0 16
  • 最近非常流行 Retrofit+RxJava+OkHttp 這一整套的網(wǎng)絡(luò)請(qǐng)求和異步操作的開(kāi)源框架随闪,從 Jake ...
    慌不要慌閱讀 1,974評(píng)論 1 7
  • Retrofit是Square出品的Android Http請(qǐng)求框架,是基于Okhttp的(Okhttp也是該機(jī)構(gòu)...
    Uprising閱讀 11,412評(píng)論 1 60
  • Retrofit 2 源碼解析 關(guān)于Retrofit 2的使用請(qǐng)看上一篇https://www.jianshu.c...
    gogoingmonkey閱讀 517評(píng)論 0 1
  • 臨江仙 叩心 風(fēng)舞嬋娟萬(wàn)絳絲骚勘, 白羽冰心掩門(mén)铐伴; 欲將愁緒訴黃昏撮奏, 相見(jiàn)路不從, 淚眼看疏影当宴。 軟語(yǔ)枕邊最銷(xiāo)魂畜吊, 應(yīng)...
    寒冰_6a8f閱讀 209評(píng)論 2 1