SDWebImage庫的作用:提供一個UIImageView分類以支持加載來自網絡圖片。具有異步下載、緩存管理、同一個URL下載次數控制和優化等功能。SDWebImage在github上的[下載地址](https://github.com/rs/SDWebImage)
主要用到的對象:
? ? ? ?1、UIImageView (WebCache)類別,入口封裝,實現讀取圖片完成后的回調
? ? ? ?2、SDWebImageManager,對圖片進行管理的中轉站,記錄那些圖片正在讀取。
? ? ? ? ? ?向下層讀取Cache(調用SDImageCache),或者向網絡讀取對象(調用SDWebImageDownloader) 。
? ? ? ? ? ? 實現SDImageCache和SDWebImageDownloader的回調。
? ? ? ? ?3、SDImageCache,根據URL的MD5摘要對圖片進行存儲和讀取(實現存在內存中或者存在硬盤上兩種實現)
? ? ? ? ? ? ?實現圖片和內存清理工作。
? ? ? ? ? 4、SDWebImageDownloader,根據URL向網絡讀取數據(實現部分讀取和全部讀取后再通知回調兩種方式)
一、我們先來了解一下SDWebImage的使用:
1、導入框架,引入頭文件:
#import "UIImageView+WebCache.h"
也可以直接使用CocoaPods來引入和管理
(OC 如下)
platform :ios, '7.0'
pod 'SDWebImage', '~>3.8'
(swift)并且要確保添加了use_frameworks,iOS版本為8.0+
platform :ios, '8.0'
use_frameworks!
2、圖片下載并緩存方法:
//得到當前圖片的url
- (NSURL *)sd_imageURL;
// 異步下載圖片并緩存
- (void)sd_setImageWithURL:(NSURL *)url;
// 異步下載圖片并緩存,沒下載完之前先顯示占位圖片,下載完之后再替換
- (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder;
/**
* 異步下載圖片并緩存
* @param url? ? ? ? ? 下載圖片路徑
* @param placeholder? 占位圖片,直到下載完成才替換
* @param options? ? ? 下載圖片選擇方式(這個選項也就是3中要介紹的options選項)
*/
- (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options;
/**
* 異步下載圖片并緩存,但沒有占位圖片,完成后可以在block中做事情
* @param url? ? ? ? ? 下載圖片url
* @param completedBlock
SDWebImageCompletionBlock:(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL)
block中可以得到下載圖片,錯誤信息,緩存類型,下載圖片地址? 參數,給用戶做相應操作
*/
- (void)sd_setImageWithURL:(NSURL *)url completed:(SDWebImageCompletionBlock)completedBlock;
/**
* 異步下載圖片并緩存,提供占位圖片,并完成后可以在block中做事情
* @param url ? ? ? ? ? ?下載圖片url
* @param placeholder ? ?占位圖片,直到下載完成才替換
* @param completedBlock
SDWebImageCompletionBlock:UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL)
block中可以得到下載圖片,錯誤信息,緩存類型,下載圖片地址? 參數,給用戶做相應操作
*/
- (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder completed:(SDWebImageCompletionBlock)completedBlock;
/**
* 異步下載圖片并緩存,不僅提供占位圖,還可以設置下載方式:options,完成后可以在block中做事情
* @param url? ? ? ? ? 下載圖片路徑
* @param placeholder? 占位圖片,直到下載完成才替換
* @param options? ? ? 下載圖片選擇方式
* @param completedBlock? 同上
*/
- (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options completed:(SDWebImageCompletionBlock)completedBlock;
/**
* 異步下載圖片并緩存,不僅提供占位圖,還可以設置下載方式:options,同時可以監聽下載進度,完成后可以在block中做事情
* @param url? ? ? ? ? 下載圖片路徑
* @param placeholder? 占位圖片,直到下載完成才替換
* @param options? ? ? 下載圖片選擇方式
* @param progress ? ?圖片下載進度
* SDWebImageDownloaderProgressBlock:NSInteger receivedSize(當前下載大小), NSInteger expectedSize(總大小)
* @param completedBlock? 同上
*/
- (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options progress:(SDWebImageDownloaderProgressBlock)progressBlock completed:(SDWebImageCompletionBlock)completedBlock;
/**
* 異步下載圖片并緩存,不僅提供占位圖,還可以設置下載方式:options,同時可以監聽下載進度,還可以提供下載大小,完成后可以在block中做事情
* @param url? ? ? ? ? 下載圖片路徑
* @param placeholder? 占位圖片,直到下載完成才替換
* @param options? ? ? 下載圖片選擇方式
* @param progress
* SDWebImageDownloaderProgressBlock:NSInteger receivedSize(當前下載大小), NSInteger expectedSize(總大小)
* @param completedBlock? 同上
*/
- (void)sd_setImageWithPreviousCachedImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options progress:(SDWebImageDownloaderProgressBlock)progressBlock completed:(SDWebImageCompletionBlock)completedBlock;,
3、options所有選項
//失敗后重試
SDWebImageRetryFailed = 1 << 0,
//最低優先級,當正在進行UI交互時,自動暫停內部的一些下載操作
SDWebImageLowPriority = 1 << 1,
//只緩存內存
SDWebImageCacheMemoryOnly = 1 << 2,
//漸進式下載,顯示的圖像是逐步在下載
SDWebImageProgressiveDownload = 1 << 3,
//刷新緩存
SDWebImageRefreshCached = 1 << 4,
//后臺下載
SDWebImageContinueInBackground = 1 << 5,
/**
* Handles cookies stored in NSHTTPCookieStore by setting
* NSMutableURLRequest.HTTPShouldHandleCookies = YES;
*/
SDWebImageHandleCookies = 1 << 6,
//允許使用無效的SSL證書
SDWebImageAllowInvalidSSLCertificates = 1 << 7,
//高優先級下載
SDWebImageHighPriority = 1 << 8,
//延遲占位符
SDWebImageDelayPlaceholder = 1 << 9,
//改變動畫形象
SDWebImageTransformAnimatedImage = 1 << 10,
/**
* By default, image is added to the imageView after download. But in some cases, we want to
* have the hand before setting the image (apply a filter or add it with cross-fade animation for instance)
* Use this flag if you want to manually set the image in the completion when success
*/
SDWebImageAvoidAutoSetImage = 1 << 11
4、內存處理:當app接收到內存警告時,我們要釋放內存(可以在AppDelegate.m 的applicationDidReceiveMemoryWarning方法中釋放,也可以在控制器的didReceiveMemoryWarning方法中釋放)
SDWebImageManager *manager = [SDWebImageManager sharedManager];
// 取消正在下載的操作
[manager cancelAll];
// 清除內存緩存
[manager.imageCache clearMemory];
//釋放磁盤的緩存
[manager.imageCache cleanDisk];
5、使用SDWebImageManager類:可以進行一些異步加載的工作
SDWebImageManager *manager = [SDWebImageManager sharedManager];
UIImage *cachedImage = [manager imageWithURL:url]; // 將需要緩存的圖片加載進來
if (cachedImage) {
// 如果Cache命中,則直接利用緩存的圖片進行有關操作
} else {
// 如果Cache沒有命中,則去下載指定網絡位置的圖片,并且給出一個委托方法
[manager downloadWithURL:url delegate:self];
}
當然你的類要實現SDWebImageManagerDelegate協議,并且要實現協議的webImageManager:didFinishWithImage:方法。
// 當下載完成后,調用回調方法,使下載的圖片顯示
- (void)webImageManager:(SDWebImageManager *)imageManager didFinishWithImage:(UIImage *)image {
}
6、獨立的異步圖像下載和獨立的異步圖像緩存
獨立的異步圖像下載?
可能會單獨用到異步圖片下載,則一定要用downloaderWithURL:delegate:來建立一個SDWebImageDownloader實例。
SDWebImageDownloader *downloader = [SDWebImageDownloader downloaderWithURL:url delegate:self];
這樣SDWebImageDownloaderDelegate協議的方法imageDownloader:didFinishWithImage:被調用時下載會立即開始并完成。
獨立的異步圖像緩存
SDImageCache類提供一個創建空緩存的實例,并用方法imageForKey:來尋找當前緩存。
UIImage *myCachedImage = [SDImageCache sharedImageCache] imageFromKey:myCacheKey];
存儲一個圖像到緩存是使用方法storeImage: forKey:
[SDImageCache sharedImageCache] storeImage:myImage forKey:myCacheKey];
默認情況下,圖像將被存儲在內存緩存和磁盤緩存中。如果僅僅是想內存緩存中,要使用storeImage:forKey:toDisk:方法的第三個參數帶一負值來替代。
來替代。
二、SDWebImage內部實現原理
? ? ? SDImageCache是怎么做數據管理的?(如下圖所示:)
圖片解釋:內存層面的相當是個緩存器,以Key-Value的形式存儲圖片。當內存不夠的時候會清除所有緩存圖片。用搜索文件系統的方式做管理,文件替換方式是以時間為單位,剔除時間大于一周的圖片文件。當SDWebImageManager向SDImageCache要資源時,先搜索內存層面的數據,如果有直接返回,沒有的話去訪問磁盤,將圖片從磁盤讀取出來,然后做Decoder,將圖片對象放到內存層面做備份,再返回調用層。
1、入口 setImageWithURL:placeholderImage:options: 會先把 placeholderImage 顯示,然后 SDWebImageManager 根據 URL 開始處理圖片。
2、進入 SDWebImageManager-downloadWithURL:delegate:options:userInfo:,交給 SDImageCache 從緩存查找圖片是否已經下載 queryDiskCacheForKey:delegate:userInfo:.
3、如果內存中已經有圖片緩存,SDImageCacheDelegate 回調 imageCache:didFindImage:forKey:userInfo: 到 SDWebImageManager。
4、SDWebImageManagerDelegate 回調 webImageManager:didFinishWithImage: 到 UIImageView+WebCache 等前端展示圖片。
5、如果內存緩存中沒有,生成 NSInvocationOperation 添加到隊列開始從硬盤查找圖片是否已經緩存。
6、根據 URLKey 在硬盤緩存目錄下嘗試讀取圖片文件。這一步是在 NSOperation 進行的操作,所以回主線程進行結果回調 notifyDelegate:。
7、如果硬盤中有該圖片,將圖片添加到內存緩存中(如果空閑內存過小,會先清空內存緩存)。SDImageCacheDelegate 回調 imageCache:didFindImage:forKey:userInfo:。進而回調展示圖片。
8、如果從硬盤緩存目錄讀取不到圖片,說明所有緩存都不存在該圖片,需要下載圖片,回調 imageCache:didNotFindImageForKey:userInfo:。
9、共享或重新生成一個下載器 SDWebImageDownloader 開始下載圖片。
10、圖片下載由 NSURLConnection 來做,實現相關 delegate 來判斷圖片下載中、下載完成和下載失敗。
11、imageDownloader:didFinishWithImage: 回調給 SDWebImageManager 告知圖片下載完成。
12、通知所有的 downloadDelegates 下載完成,回調給需要的地方展示圖片。
13、將圖片保存到 SDImageCache 中,內存緩存和硬盤緩存同時保存。寫文件到硬盤也在以單獨 NSInvocationOperation 完成,避免拖慢主線程。SDImageCache 在初始化的時候會注冊一些消息通知,在內存警告或退到后臺的時候清理內存圖片緩存,應用結束的時候清理過期圖片。