
投稿文章,作者:missummer(簡書)
上一篇我們梳理了 SDWebImage 下載圖片的基本流程,這一篇則聚焦在下載器 SDWebImageDownloader 的周邊類別與關鍵設計。理解這部分,有助於釐清圖片下載、回調、取消與併發控制是如何串起來的。
SDWebImageManager 並不直接處理網路請求,而是把下載工作交給 SDWebImageDownloader。Downloader 負責建立與管理下載任務,真正執行下載的是 SDWebImageDownloaderOperation。
Manager 呼叫的核心方法可以簡化理解為:
downloadImageWithURL:options:progress:completed:
SDWebImageDownloaderOptions 定義了多種行為,包括低優先級下載、漸進式下載、是否使用 NSURLCache、是否忽略快取回應、背景執行、Cookie 處理、允許不受信任的 SSL 憑證,以及高優先級下載等。這些選項可以組合使用,以符合不同場景的需求。
Downloader 定義了幾個重要 block:進度回調會回報已接收與預期大小;完成回調會回傳圖片、資料、錯誤與是否完成;Header 過濾 block 則允許開發者自訂 HTTP 請求標頭。
此外,程式也定義了下載開始與停止的全域通知,方便外部監聽下載狀態。
Downloader 暴露了多個實用屬性,例如是否解壓圖片、最大併發下載數、目前下載數量、逾時時間、執行順序、單例存取方法、預設憑證、使用者名稱、密碼,以及自訂 Header 過濾器。
其中,maxConcurrentDownloads 控制同時下載的數量;downloadTimeout 決定請求逾時;executionOrder 則可選擇先進先出或後進先出。
Downloader 內部使用 dispatch_barrier_sync 保護 URLCallbacks 這個可變字典。作者特別回顧了 GCD 的概念:序列佇列、併發佇列、同步、異步,以及 barrier 的作用。
barrier 可以確保某個區塊在指定時機成為佇列中唯一執行的任務,因此非常適合用來保護資源的讀寫。這也是 SDWebImage 能避免同一個 URL 被重複下載的重要關鍵。
addProgressCallback:completedBlock:forURL:createCallback: 會先檢查 URL 是否為空,接著在 barrierQueue 中建立或取得對應 URL 的回調陣列。若同一個 URL 第一次被使用,才會呼叫 createCallback 真正建立下載操作;後續相同 URL 的回調則會被加入同一個陣列中。
這樣設計的好處是:同一張圖片若被多個位置請求,只需要一次下載,完成後再通知所有等待中的回調。
createCallback 中會設定逾時時間、建立 NSMutableURLRequest,並依選項決定是否使用本地快取、是否處理 Cookie,以及是否套用自訂 Header。接著建立 SDWebImageDownloaderOperation,把進度、完成與取消回調傳入,最後設定憑證、優先級,並加入 downloadQueue。
若需要後進先出,程式會透過 addDependency 建立操作之間的依賴關係。這也解釋了為何建立任務時必須使用同步的 barrier,否則依賴順序可能不如預期。
當伺服器要求客戶端提供驗證資訊時,NSURLCredential 扮演重要角色。流程通常是:伺服器回傳挑戰,客戶端提供憑證,伺服器驗證成功後才會回傳真正資料;若失敗,則可能收到 401。
這個類別繼承自 NSOperation,負責實際的網路請求。它的 start 方法是下載執行的核心:先檢查是否取消,再處理背景任務,接著建立 NSURLConnection 並啟動。為了讓 connection 能在目前 RunLoop 中持續運作,程式會進入 RunLoop 等待,直到下載完成或失敗。
在 connection:didReceiveResponse: 中,程式會判斷 HTTP 狀態碼,設定預期大小,初始化 imageData,並發送回應通知。若狀態碼異常,則取消連線並回傳錯誤。
在 connection:didReceiveData: 中,資料會被附加到 imageData。若啟用漸進式下載,還會嘗試從目前資料建立部分圖片,讓 UI 能提前顯示模糊的縮圖。
在 connectionDidFinishLoading: 中,程式會停止 RunLoop、清理 connection 與 thread,發送完成通知,並把 imageData 轉成 UIImage。若圖片尺寸為零或資料為空,則回傳錯誤。
SDWebImageDownloader 的設計重點不只是下載,而是把回調、併發、取消與執行緒安全整合在一起。讀懂 barrierQueue 與 callback 字典的生命週期,就能理解 SDWebImage 為何能在高頻圖片載入場景中保持穩定。