-
架構(gòu)
- 底層處理類:
SDImageCache(負(fù)責(zé)image的存儲)
SDWebImageDownloader (負(fù)責(zé)webImage的下載)
SDWebImageDownloaderOperation (繼承自NSOpration的下載任務(wù)類) - 工具輔助類
NSData+ImageContentType(負(fù)責(zé)根據(jù)圖片Data獲取圖片類型)
SDWebImageCompat(定義根據(jù)url后2x友浸,3x處理圖片scale(縮放因子)科吭、以及定義安全主隊(duì)列執(zhí)行宏)
UIImage+MultiFormat(根據(jù)Data區(qū)分類型獲取正確的圖片)
UIImage+GIF(處理GIF圖片分類)
UIView+WebCacheOperation(用于存儲在View類的operation或者取消operation) - 底層之上的處理類
SDWebImageManager (負(fù)責(zé)采用SDWebImageDownloader和SDImageCache儲存的邏輯整合管理類)
SDWebImagePrefetcher (封裝SDWebImageManager的SDWebImageManager預(yù)取器)
UIButton+WebCache (UIButton設(shè)置網(wǎng)絡(luò)圖片的分類)
UIImageView+HighlightedWebCache (UIImageView設(shè)置高亮webImage的分類)
UIImageView+WebCache(UIImageView 設(shè)置webImage的分類)
-
代碼解讀
- SDImageCache
負(fù)責(zé)圖片存儲定拟、清理功能,主要分為memoryCache(內(nèi)存緩存)和diskCache(磁盤緩存)骤菠。
故定義存儲類型為SDImageCacheType:SDImageCacheTypeNone、SDImageCacheTypeDisk、SDImageCacheTypeMemory拙毫。
基本的屬性就不在此做篇幅了蝇率,解釋都很清楚迟杂。我們主要記錄相關(guān)知識點(diǎn)以及設(shè)計(jì)思路。
此類有意設(shè)計(jì)為一個單利類本慕。同時也預(yù)留出了其他非單利初始化方法排拷,方便用戶自己定義一個存儲區(qū)。通過sharedImageCache生成的是我們?nèi)謫卫惞荆捎媚J(rèn)的存儲路徑监氢;通過- (id)initWithNamespace:(NSString *)ns;- (id)initWithNamespace:(NSString *)ns diskCacheDirectory:(NSString *)directory;兩個方法創(chuàng)建自己的存儲路徑。
下面我們說一下藤违,存浪腐、取以及清理。
存的方式我們采用NSCache作為內(nèi)存讀寫顿乒,采用NSFileManager作為磁盤讀寫议街。
關(guān)于寫:
根據(jù)屬性是否寫入內(nèi)存:如果寫入內(nèi)存,先[self.memCache setObject:image forKey:key cost:cost];設(shè)置NSCache璧榄,之后diskCache特漩,diskCache采用GCD異步串行隊(duì)列存儲,異步保證不會阻塞當(dāng)前線程犹菱,串行保證隊(duì)列所有任務(wù)都能保證按FIFO的順序執(zhí)行拾稳,避免造成線程并發(fā)存儲造成崩潰。從緩存中取圖片的時候腊脱,首先會從NSCache中查找访得,再從DiskCache中查找。
清理緩存:
1. 按照key清理陕凹,清除內(nèi)存緩存(根據(jù)shouldCacheImagesInMemory熟悉)->清除disk緩存(異步串行隊(duì)列執(zhí)行)
2.全部清除:
全部清除clear
clearMemory([self.memCache removeAllObjects];)悍抑、clearDisk(異步串行隊(duì)列刪除緩存地址所有文件->創(chuàng)建緩存路徑)
清理clean
清理緩存只有清理disk緩存,先清理過期的圖片->按最后修改日期排序直到刪除到緩存<最大緩存量(也就是算法中經(jīng)常說的最近最少使用LRU算法)
- SDWebImageDownloader
此類也設(shè)計(jì)為單利杜耙,負(fù)責(zé)從網(wǎng)絡(luò)上下載圖片搜骡。網(wǎng)絡(luò)請求采用NSURLSession處理(當(dāng)然以前的NSURLConnection已經(jīng)廢棄了)
關(guān)于下載流程主要濃縮于一個方法:- (id <SDWebImageOperation>)downloadImageWithURL:(NSURL *)url options:(SDWebImageDownloaderOptions)options progress:(SDWebImageDownloaderProgressBlock)progressBlock completed:(SDWebImageDownloaderCompletedBlock)completedBlock 在這個方法里調(diào)用了一個重要的方法- (void)addProgressCallback:(SDWebImageDownloaderProgressBlock)progressBlock completedBlock:(SDWebImageDownloaderCompletedBlock)completedBlock forURL:(NSURL *)url createCallback:(SDWebImageNoParamsBlock)createCallback
這個方法 應(yīng)用dispatch_barrier_sync(GCD同步柵欄函數(shù)并發(fā)隊(duì)列執(zhí)行任務(wù), 此函數(shù)的意義在于同步執(zhí)行佑女,并且當(dāng)前任務(wù)直到在此之前加進(jìn)去的所有任務(wù)執(zhí)行完畢才會執(zhí)行)執(zhí)行從URLCallbacks取以url為鍵名的Array(存儲了kProgressCallbackKey(進(jìn)度回調(diào))记靡、kCompletedCallbackKey(完成回調(diào)))如果不存在谈竿,將其標(biāo)記為first(第一次下載)并且初始化url對應(yīng)的數(shù)組,然后將添保存進(jìn)度和完成回調(diào)的字典添加進(jìn)數(shù)組摸吠。如果第一次下載回調(diào)creatCallBack()空凸。接下來我們看creatCallBack回調(diào)里做了什么事情:生成NSMutableURLRequest(配置相關(guān)屬性)->生成SDWebImageDownloaderOperation(繼承抽象類NSOperation的自定義類->配置operation的相關(guān)屬性 -> 添加到自定義并發(fā)隊(duì)列([NSOperationQueue addOperation] 添加完就會調(diào)用[NSOperation start])->如果執(zhí)行順序是SDWebImageDownloaderLIFOExecutionOrder,添加這次上次op依賴于這次op寸痢。那么SDWebImageDownloaderOperation又做了什么呢呀洲?
它是繼承自NSOperation抽象類的,并且實(shí)現(xiàn)了NSURLSessionTaskDelegate啼止、NSURLSessionDataDelegate道逗、SDWebImageOperation(自定義Operation協(xié)議)
- (void)start
通過可選項(xiàng)SDWebImageDownloaderOptions是否為SDWebImageDownloaderContinueInBackground后臺繼續(xù)下載模式,開啟后臺激活后臺長運(yùn)行任務(wù)[app beginBackgroundTaskWithExpirationHandler:^{}],用已經(jīng)傳進(jìn)來的session繼續(xù)執(zhí)行任務(wù)献烦。其中使用同步鎖@synchronized (self){}執(zhí)行屬性賦值等操作 - NSURLSessionDataDelegate
- (void)URLSession:(NSURLSession *)session
dataTask:(NSURLSessionDataTask *)dataTask
didReceiveResponse:(NSURLResponse *)response
completionHandler:(void (^)(NSURLSessionResponseDisposition disposition))completionHandler; // 開始接收到response的代理滓窍。如果返回statusCode < 400 && statusCode != 304說明返回數(shù)據(jù)正常,否則說明返回錯誤仿荆。正確賦值給預(yù)期大小贰您,初始化imageData數(shù)據(jù),回調(diào)進(jìn)度block拢操,通知SDWebImageDownloadReceiveResponseNotification锦亦;錯誤情況下取消任務(wù)發(fā)送SDWebImageDownloadStopNotification通知,回調(diào)完成block返回錯誤信息令境。
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data;// 開始接收數(shù)據(jù)代理杠园,拼接接收到的數(shù)據(jù),并且根據(jù)是否SDWebImageDownloaderProgressiveDownload舔庶,是否處理漸進(jìn)下載抛蚁。首先如果高度+寬度=0。獲取寬度惕橙、高度瞧甩、方向。CGImageSourceCreateWithData()創(chuàng)建CGImageSourceRef弥鹦,獲取CGImageSourceRef的info信息CFDictionaryRef肚逸,其中包括高度val = CFDictionaryGetValue(properties, kCGImagePropertyPixelHeight)、寬度CFDictionaryGetValue(properties, kCGImagePropertyPixelWidth)彬坏、以及方向CFDictionaryGetValue(properties, kCGImagePropertyOrientation)朦促。
如果當(dāng)前width+height>0&& 當(dāng)前數(shù)據(jù)大小<預(yù)期數(shù)據(jù)大小,根據(jù)當(dāng)前數(shù)據(jù)生成圖片 CGImageSourceCreateImageAtIndex生成CGImageRef栓始, CGBitmapContextCreate()生成位圖context务冕,CGContextDrawImage()繪制到當(dāng)前的位圖context中,從當(dāng)前的context中生成圖片CGBitmapContextCreateImage()幻赚,根據(jù)imageRef生成image禀忆。
- (void)URLSession:(NSURLSession *)session
dataTask:(NSURLSessionDataTask *)dataTask
willCacheResponse:(NSCachedURLResponse *)proposedResponse
completionHandler:(void (^)(NSCachedURLResponse *cachedResponse))completionHandler;//將會緩存response臊旭,根據(jù)是否NSURLRequestReloadIgnoringLocalCacheData;阻止緩存
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error油湖;// 下載完成巍扛;首先清空數(shù)據(jù)發(fā)送下載完畢通知或者停止通知, 其次根據(jù)是否error乏德,分別賦值不同的完成回調(diào)參數(shù)。主要看!error的情況:1.如果response從緩存里取得吠昭,那么返回nil的image喊括;2.如果imageData存在通過分類方法sd_imageWithData生成圖片2.1如果尺寸為0那么回調(diào)參數(shù)賦值錯誤原因2.2否則返回正確回調(diào)3.返回?zé)o數(shù)據(jù)錯誤完成回調(diào)
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didReceiveChallenge:(NSURLAuthenticationChallenge *)challenge completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition disposition, NSURLCredential *credential))completionHandler;// 處理相關(guān)認(rèn)證
- SDWebImageManager
此類也設(shè)計(jì)為單利,同時也提供了自定義downloader矢棚、cache初始化郑什。其中單利默認(rèn)采用SDWebImageDownloader下載圖片SDImageCache存取圖片。
主要類解析:
- (id <SDWebImageOperation>)downloadImageWithURL:(NSURL *)url
options:(SDWebImageOptions)options
progress:(SDWebImageDownloaderProgressBlock)progressBlock
completed:(SDWebImageCompletionWithFinishedBlock)completedBlock;
- 轉(zhuǎn)化url參數(shù)為NSURL
2.判斷(url是否在失敗池&&operations不包括包括SDWebImageRetryFailed)|| url有錯蒲肋,直接返回錯誤結(jié)束任務(wù)蘑拯。
3.將創(chuàng)建好的operation加入到runningOperations - 用[SDImageCache queryDiskCacheForKey]查找緩存圖片,回調(diào)處理
4.1任務(wù)取消兜粘,結(jié)束
4.2 ((!image || options & SDWebImageRefreshCached) && (![self.delegate respondsToSelector:@selector(imageManager:shouldDownloadImageForURL:)] || [self.delegate imageManager:self shouldDownloadImageForURL:url])) 處理
4.2.1如果圖片存在并且operations包括SDWebImageRefreshCached申窘,先回調(diào)完成block返回數(shù)據(jù);再組合operations 利用SDImageDownloader下載圖片孔轴,回調(diào)處理
4.2.1.1 operation取消剃法,不做任何操作
4.2.1.2 下載錯誤,將此URL添加到失敗池路鹰,返回完成回調(diào)但會錯誤贷洲。
4.2.1.3 除此只玩的相關(guān)處理:1.options & SDWebImageRetryFailed 移除失敗池的當(dāng)前url2.options & SDWebImageRefreshCached && image && !downloadedImage 未做操作3.(downloadedImage && (!downloadedImage.images || (options & SDWebImageTransformAnimatedImage)) && [self.delegate respondsToSelector:@selector(imageManager:transformDownloadedImage:withURL:) DownloadImage存在&&(downloadimage沒有不是GIF||做過處理)
從代理中獲取處理過的圖片,如果圖片存在并且下載完全完成晋柱,儲存圖片优构,回調(diào)完成block。
4.2.1.4 下載圖片存在&&下載已經(jīng)完成 緩存圖片 回調(diào)完成block
4.2.1.4 全部完成下載雁竞,移除執(zhí)行操作池當(dāng)前操作
4.2.2 如果image存在 回調(diào)完成block钦椭,移除執(zhí)行操作池當(dāng)前操作
4.2.3否則回調(diào)block,SDImageCacheTypeNone
- SDWebImagePrefetcher
利用SDWebImageManager 進(jìn)行預(yù)下載多個圖片
- UIImageView+WebCache
快速設(shè)置網(wǎng)絡(luò)圖片的UIImageView分類浓领。
我們只需要看玉凯,他的“全能初始化方法”
- (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options progress:(SDWebImageDownloaderProgressBlock)progressBlock completed:(SDWebImageCompletionBlock)completedBlock
1.取消當(dāng)前所有獲取image任務(wù)
2.根據(jù)是都延遲賦值placeholder賦值
3.[SDWebImageManager.sharedManager downloadImageWithURL:url options:options progress:progressBlock completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) 查詢或者下載圖片
4.回調(diào)中根據(jù)選項(xiàng)處理圖片。
從底層看到這里其實(shí)這部分的代碼就so easy了联贩,就不細(xì)說了漫仆。
關(guān)于其他工具類,和分類就不一一記錄了泪幌。