Kingfisher源碼解析之ImagePrefetcher

Kingfisher源碼解析系列,由于水平有限,哪里有錯规辱,肯請不吝賜教

ImagePrefetcher提供了哪些功能

ImagePrefetcher是Kingfisher提供預(yù)加載功能的一個類赛糟,提供了一下功能

  • start():開啟預(yù)加載
  • stop():停止預(yù)加載
  • maxConcurrentDownloads:設(shè)置最大緩存并發(fā)量
  • progressBlock和progressSourceBlock:緩存進度的回調(diào)
  • completionHandler和completionSourceHandler:緩存結(jié)束的回調(diào)

ImagePrefetcher預(yù)加載的流程圖

預(yù)加載的流程圖

ImagePrefetcher兩個問題

當調(diào)用stop()函數(shù)之后的邏輯

先來看下stop函數(shù)的實現(xiàn),實現(xiàn)比較簡單晒他,在預(yù)加載的隊列里異步的執(zhí)行把標志位stopped設(shè)置為true,并且取消當前所有未完成的下載任務(wù)逸贾,看起來很簡單陨仅。

public func stop() {
    pretchQueue.async {
        if self.finished { return }
        self.stopped = true
        self.tasks.values.forEach { $0.cancel() }
    }
}

但是stopped這個標志位只在網(wǎng)絡(luò)請求結(jié)束的回調(diào)里去判斷了,這就會發(fā)生一些歧義铝侵,交給讀者去判斷Kingfisher這么做是否是合理的灼伤?當調(diào)用stop函數(shù)時,會出現(xiàn)以下幾種情況以及對應(yīng)的結(jié)果

  1. 調(diào)用stop時咪鲜,已經(jīng)預(yù)加載結(jié)束了狐赡,由于已經(jīng)結(jié)束,會直接返回
  2. 調(diào)用stop時疟丙,現(xiàn)在已經(jīng)有正在下載圖片的任務(wù)了颖侄,會取消所所有請求鸟雏,然后請求就會走結(jié)束的回調(diào),在結(jié)束的回調(diào)里把剩下的未加載的數(shù)據(jù)放入到失敗的數(shù)據(jù)源的數(shù)組中览祖,調(diào)用結(jié)束回調(diào)
  3. 調(diào)用stop時孝鹊,還沒有正在下載的任務(wù),會繼續(xù)預(yù)加載數(shù)據(jù)展蒂,直到結(jié)束又活,或者有一個請求結(jié)束

對于情況1和情況2都是合理的,并且是絕大部分都會是情況1和情況2玄货,對于情況3皇钞,調(diào)用stop時并沒有真正的去停止,但是這種情況也是較少出現(xiàn)的松捉。

對于stop方法夹界,喵神的注釋是這樣的

/// Stops current downloading progress, and cancel any future prefetching activity that might be occuring.

緩存進度和緩存結(jié)束的回調(diào)為什么要各有2個

我第一次看代碼,就想為什么要有2個呢隘世?為什么這么設(shè)計呢可柿?這里以緩存進度的回調(diào)舉例,它們兩個的原因是一樣的丙者。先來看下定義复斥,

public typealias PrefetcherProgressBlock =
    ((_ skippedResources: [Resource], _ failedResources: [Resource], _ completedResources: [Resource]) -> Void)

public typealias PrefetcherSourceProgressBlock =
    ((_ skippedSources: [Source], _ failedSources: [Source], _ completedSources: [Source]) -> Void)

我們發(fā)現(xiàn)基本是一樣的,只是回調(diào)里的參數(shù)類型不一樣械媒,一個Resource目锭,另一個Source。如果你對這2個類型比較了解纷捞,想必你應(yīng)該能猜到這么設(shè)計的原因了痢虹。

Source是一個枚舉,Kingfisher中為UIImage提供數(shù)據(jù)源用的主儡,定義如下,有2個case奖唯,一個是關(guān)聯(lián)了Resource,另一個關(guān)聯(lián)了ImageDataProvider

public enum Source {
    case network(Resource)
    case provider(ImageDataProvider)
}

Resource是一個協(xié)議糜值,定義如下丰捷,提供數(shù)據(jù)源的真正類型之一,一般用于加載網(wǎng)絡(luò)圖片

public protocol Resource {
    var cacheKey: String { get }
    var downloadURL: URL { get }
}

ImageDataProvider也是一個協(xié)議寂汇,定義如下病往,提供數(shù)據(jù)源的另一個真正類型,一般用于本地圖片

public protocol ImageDataProvider {
    var cacheKey: String { get }
    func data(handler: @escaping (Result<Data, Error>) -> Void)
}

回答上面的問題骄瓣,由于我們一般情況下預(yù)加載的都是網(wǎng)絡(luò)圖片停巷,因此提供一個方便我們使用的回調(diào),但為了覆蓋到所有情況,就提供了2個情況的回調(diào)叠穆,這個在ImagePrefetcher的便利初始化方法里我們就能看出來,當使用[URL](注:在URL的擴展里實現(xiàn)了Resource協(xié)議)或者[Resource]初始化的時候臼膏,就使用PrefetcherProgressBlock硼被,當使用[Source]初始化時,就使用的PrefetcherSourceProgressBlock

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末渗磅,一起剝皮案震驚了整個濱河市嚷硫,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌始鱼,老刑警劉巖仔掸,帶你破解...
    沈念sama閱讀 207,113評論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異医清,居然都是意外死亡起暮,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,644評論 2 381
  • 文/潘曉璐 我一進店門会烙,熙熙樓的掌柜王于貴愁眉苦臉地迎上來负懦,“玉大人,你說我怎么就攤上這事柏腻≈嚼鳎” “怎么了?”我有些...
    開封第一講書人閱讀 153,340評論 0 344
  • 文/不壞的土叔 我叫張陵五嫂,是天一觀的道長颗品。 經(jīng)常有香客問我,道長,這世上最難降的妖魔是什么奶段? 我笑而不...
    開封第一講書人閱讀 55,449評論 1 279
  • 正文 為了忘掉前任话肖,我火速辦了婚禮,結(jié)果婚禮上闺金,老公的妹妹穿的比我還像新娘。我一直安慰自己峰档,他們只是感情好败匹,可當我...
    茶點故事閱讀 64,445評論 5 374
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著讥巡,像睡著了一般掀亩。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上欢顷,一...
    開封第一講書人閱讀 49,166評論 1 284
  • 那天槽棍,我揣著相機與錄音,去河邊找鬼。 笑死炼七,一個胖子當著我的面吹牛缆巧,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播豌拙,決...
    沈念sama閱讀 38,442評論 3 401
  • 文/蒼蘭香墨 我猛地睜開眼陕悬,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了按傅?” 一聲冷哼從身側(cè)響起捉超,我...
    開封第一講書人閱讀 37,105評論 0 261
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎唯绍,沒想到半個月后拼岳,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,601評論 1 300
  • 正文 獨居荒郊野嶺守林人離奇死亡况芒,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,066評論 2 325
  • 正文 我和宋清朗相戀三年惜纸,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片牛柒。...
    茶點故事閱讀 38,161評論 1 334
  • 序言:一個原本活蹦亂跳的男人離奇死亡堪簿,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出皮壁,到底是詐尸還是另有隱情椭更,我是刑警寧澤,帶...
    沈念sama閱讀 33,792評論 4 323
  • 正文 年R本政府宣布蛾魄,位于F島的核電站虑瀑,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏滴须。R本人自食惡果不足惜舌狗,卻給世界環(huán)境...
    茶點故事閱讀 39,351評論 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望扔水。 院中可真熱鬧痛侍,春花似錦、人聲如沸魔市。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,352評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽待德。三九已至君丁,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間将宪,已是汗流浹背绘闷。 一陣腳步聲響...
    開封第一講書人閱讀 31,584評論 1 261
  • 我被黑心中介騙來泰國打工橡庞, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人印蔗。 一個月前我還...
    沈念sama閱讀 45,618評論 2 355
  • 正文 我出身青樓扒最,卻偏偏與公主長得像,于是被迫代替她去往敵國和親华嘹。 傳聞我的和親對象是個殘疾皇子扼倘,可洞房花燭夜當晚...
    茶點故事閱讀 42,916評論 2 344

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