前言
SDWebImage是一個很受歡迎的圖片緩存第三方庫剩胁,使用十分方便,只需一行代碼就可以實現(xiàn)設(shè)置占位圖以及在網(wǎng)絡(luò)圖片拉取成功后替換占位圖的功能。雖然楣富,乍一看只是現(xiàn)實了拉取網(wǎng)絡(luò)圖片的小小功能访忿,但是瞧栗,里面還包含了很多邏輯代碼,也是很復(fù)雜的海铆。下面我主要講的是關(guān)于設(shè)置網(wǎng)絡(luò)圖片的一些邏輯代碼的實現(xiàn)迹恐,有關(guān)其它的功能(比如:圖片緩存,圖片下載線程的實現(xiàn)等等)一概不討論卧斟。
1.SDWebImage庫整體工作流程
- 在網(wǎng)絡(luò)獲取圖片前殴边,取消并移除當前對象的圖片下載線程。
- 動態(tài)關(guān)聯(lián)該圖片url(用于圖片存緩存的key)珍语,一般默認選項有占位圖則先顯示占位圖(其中有個options選項可以不顯示或者延時顯示占位圖等等锤岸,稍后再講)。
- 使用關(guān)聯(lián)的 key作為路徑板乙,在內(nèi)存中尋找該圖片是偷,找不到,再到本地中找募逞,還是找不到蛋铆,則通過url去服務(wù)器中下載。
- 在上一步中放接,如果在內(nèi)存中找到了該圖片戒职,則直接返回;如果在本地找到了該圖片透乾,則先加載到內(nèi)存中洪燥,再返回;如果需要到服務(wù)器拉取乳乌,則先把拉取到的圖片加載到內(nèi)存中捧韵,再存到本地,最后才返回汉操。
- 設(shè)置對象的圖片并顯示再来。
具體邏輯如下圖:
2.下面詳細說明這個流程所用到的函數(shù)
- 取消當前對象的下載線程
//通過key(一般都是url)獲取下載線程
- (void)sd_cancelImageLoadOperationWithKey:(NSString *)key {
// Cancel in progress downloader from queue
NSMutableDictionary *operationDictionary = [self operationDictionary]; //獲取下載隊列字典
id operations = [operationDictionary objectForKey:key]; //取出當前key的所有隊列
···
[operation cancel]; //取消當前線程
···
[operationDictionary removeObjectForKey:key]; //所有隊列執(zhí)行完cancel操作后,在所在數(shù)組移除
}
}
- 設(shè)置關(guān)聯(lián)的key
objc_setAssociatedObject(self, &imageURLKey, url, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
- 設(shè)置占位圖
if (!(options & SDWebImageDelayPlaceholder)) {
dispatch_main_async_safe(^{
self.image = placeholder;
});
}
- 下載圖片(在緩存或者本地緩存獲取也算在這里面,這里只列出了核心代碼芒篷,完整代碼在Github上下載SDWebImage庫了解)
//下載圖片搜变,返回一個實現(xiàn)SDWebImageOperation協(xié)議的對象。注:該協(xié)議只有一個cancel函數(shù)
id <SDWebImageOperation> operation = [SDWebImageManager.sharedManager downloadImageWithURL:url options:options progress:progressBlock completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) {
dispatch_main_sync_safe(^{
completedBlock(image, error, cacheType, url);
}
});
}];
//圖片下載
- (id <SDWebImageOperation>)downloadImageWithURL:(NSURL *)url
options:(SDWebImageOptions)options
progress:(SDWebImageDownloaderProgressBlock)progressBlock
completed:(SDWebImageCompletionWithFinishedBlock)completedBlock {
...
//獲取圖片
operation.cacheOperation = [self.imageCache queryDiskCacheForKey:key done:^(UIImage *image, SDImageCacheType cacheType) {...}];
return operation;
}
//queryDiskCacheForkey函數(shù)里面首先會先去內(nèi)存中尋找圖片针炉,沒有再去本地找挠他,最后才去服務(wù)器下載
- (NSOperation *)queryDiskCacheForKey:(NSString *)key done:(SDWebImageQueryCompletedBlock)doneBlock {
//獲取內(nèi)存中的圖片
UIImage *image = [self imageFromMemoryCacheForKey:key];
...
//獲取本地儲存的圖片
UIImage *diskImage = [self diskImageForKey:key];
...
return operation;
}
4.options的作用
typedef NS_OPTIONS(NSUInteger, SDWebImageOptions) {
SDWebImageRetryFailed = 1 << 0,
SDWebImageLowPriority = 1 << 1,
SDWebImageCacheMemoryOnly = 1 << 2,
SDWebImageProgressiveDownload = 1 << 3,
SDWebImageRefreshCached = 1 << 4,
SDWebImageContinueInBackground = 1 << 5,
SDWebImageHandleCookies = 1 << 6,
SDWebImageAllowInvalidSSLCertificates = 1 << 7,
SDWebImageHighPriority = 1 << 8,
SDWebImageDelayPlaceholder = 1 << 9,
SDWebImageTransformAnimatedImage = 1 << 10,
SDWebImageAvoidAutoSetImage = 1 << 11
};
就說說SDWebImageRetryFailed有什么作用,先看一下注釋:
By default, when a URL fail to be downloaded, the URL is blacklisted so the library won't keep trying.This flag disable this blacklisting.
默認options=0篡帕,也就是如果不傳SDWebImageRetryFailed殖侵,圖片下載失敗了就會被加入黑名單,不會再重新下載镰烧,除非設(shè)置options=SDWebImageRetryFailed拢军。
if ( error.code != NSURLErrorNotConnectedToInternet
&& error.code != NSURLErrorCancelled
&& error.code != NSURLErrorTimedOut
&& error.code != NSURLErrorInternationalRoamingOff
&& error.code != NSURLErrorDataNotAllowed
&& error.code != NSURLErrorCannotFindHost
&& error.code != NSURLErrorCannotConnectToHost) {
@synchronized (self.failedURLs) {
[self.failedURLs addObject:url];
}
}
5.其他
-
AutoPurgeCache
NSCache子類,初始化的時候注冊通知怔鳖,監(jiān)聽內(nèi)存報警茉唉,會在接收到通知后清除內(nèi)存,代碼如下:
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(removeAllObjects) name:UIApplicationDidReceiveMemoryWarningNotification object:nil];
-
設(shè)置image
在獲取圖片后沒有立即刷新结执,而是設(shè)置刷新標志度陆,下一次runloop的時候刷新,代碼如下:
wself.image = image;
[wself setNeedsLayout];
6.總結(jié)
其實SDWebImage的源碼很好理解昌犹,核心邏輯代碼條理清晰,只不過览芳,作者在這基礎(chǔ)上完善了很多功能邏輯斜姥,功能模塊分離,降低耦合度沧竟,除了UIImageView控件铸敏,還有UIButton控件也能用來設(shè)置Image。源碼不多悟泵,建議感興趣的都可以去看一下杈笔,了解一下。最后糕非,來說一下緩存和本地緩存的區(qū)別:1.本地緩存顧名思義是存在本地的蒙具,具體是存在應(yīng)用沙盒的cache文件里,而cache里面會在某些情況下被系統(tǒng)自動清除朽肥,比如禁筏,內(nèi)存報警,所以一般放不太重要的衡招,不需要備份的文件篱昔。2.緩存是一個大概念,本地緩存也算緩存,這里NSCahce指的應(yīng)該是內(nèi)存州刽,看是否已經(jīng)加在到內(nèi)存里了空执,如果已經(jīng)存在內(nèi)存,就可以直接從內(nèi)存中獲取設(shè)置圖片了穗椅。