iOS-SDWebImage使用（轉）

SDWebImage提供了以下三個category來進行緩存。

MKAnnotationView(WebCache)

UIButton(WebCache)

UIImageView(WebCache)

第一步，下載SDWebImage，導入工程。github託管地址https://github.com/rs/SDWebImage

第二步，在須要的地方導入頭文件

1 #import "UIImageView+WebCache.h"

 第三步，調用sd_setImageWithURL：方法緩存圖片，注意，這就是新版本的新方法，舊方法是setImageWithURL:。下面將幾個方法都介紹一下。

1. sd_setImageWithURL：

1 2	//圖片緩存的基本代碼，就是這麼簡單      [self.image1 sd_setImageWithURL:imagePath1];

2. sd_setImageWithURL:  completed:

1 2 3 4 5 6

//用block 能夠在圖片加載完成以後作些事情      [self.image2 sd_setImageWithURL:imagePath2 completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {                     NSLog(@ "這裏能夠在圖片加載完成以後作些事情" );                 }];

3. sd_setImageWithURL:  placeholderImage:

1 2	//給一張默認圖片，先使用默認圖片，當圖片加載完成後再替換      [self.image1 sd_setImageWithURL:imagePath1 placeholderImage:[UIImage imageNamed:@ "default" ]];

4. sd_setImageWithURL:  placeholderImage:  completed:

1 2 3 4 5 6

//使用默認圖片，並且用block 在完成後作一些事情      [self.image1 sd_setImageWithURL:imagePath1 placeholderImage:[UIImage imageNamed:@ "default" ] completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {                     NSLog(@ "圖片加載完成後作的事情" );                 }];

5. sd_setImageWithURL:  placeholderImage:  options:

1 2 3

//options 選擇方式             [self.image1 sd_setImageWithURL:imagePath1 placeholderImage:[UIImage imageNamed:@ "default" ] options:SDWebImageRetryFailed];

使用示範的代碼：

UITableView使用UIImageView+WebCache類（基本應用，UIImageView的一個category）

前提#import導入UIImageView+WebCache.h文件，而後在tableview的cellForRowAtIndexPath：方法下：
複製代碼
1 - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
2 static NSString *MyIdentifier = @"MyIdentifier";
3 UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:MyIdentifier];
4 if (cell == nil) {
5 cell = [[[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:MyIdentifier] autorelease];
6 }
7 // Here we use the new provided setImageWithURL: method to load the web image
8 [cell.imageView setImageWithURL:[NSURL URLWithString:@"http://www.domain.com/path/to/image.jpg"] placeholderImage:[UIImage imageNamed:@"placeholder.png"]];
9 cell.textLabel.text = @"My Text";
10 return cell;
11 }
複製代碼
基本代碼：[imageView setImageWithURL:[NSURL URLWithString:@"http://www.domain.com/path/image.jpg"]];
setImageWithURL:placeholderImage:options: 先顯示 placeholderImage ，同時由SDWebImageManager 根據 URL 來在本地查找圖片。

使用SDWebImageManager類：能夠進行一些異步加載的工做。
複製代碼
SDWebImageManager *manager = [SDWebImageManager sharedManager];
UIImage *cachedImage = [manager imageWithURL:url]; // 將須要緩存的圖片加載進來
if (cachedImage) {
// 若是Cache命中，則直接利用緩存的圖片進行有關操做
// Use the cached image immediatly
} else {
// 若是Cache沒有命中，則去下載指定網絡位置的圖片，而且給出一個委託方法
// Start an async download
[manager downloadWithURL:url delegate:self];
}
複製代碼
固然你的類要實現SDWebImageManagerDelegate協議，而且要實現協議的webImageManager:didFinishWithImage:方法。
// 當下載完成後，調用回調方法，使下載的圖片顯示
- (void)webImageManager:(SDWebImageManager *)imageManager didFinishWithImage:(UIImage *)image {
// Do something with the downloaded image
}
獨立的異步圖像下載
可能會單獨用到異步圖片下載，則必定要用downloaderWithURL:delegate:來創建一個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:方法的第三個參數帶一負值
來替代。

 

 

其餘就不一一介紹了，oc是自文檔語言，看方法名就知道幹什麼的了。除了帶options選項的方法，其餘的方法都是綜合存儲，也就是內存緩存和磁盤緩存結合的方式，若是你只須要內存緩存，那麼在options這裏選擇SDWebImageCacheMemoryOnly就能夠了。

若是不想深刻了解，到這裏你已經能夠用SDWebimage進行圖片緩存了，接下來我要解釋options的全部選項，以及SDWebImage內部執行流程。

1、options全部選項：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33

//失敗後重試       SDWebImageRetryFailed = 1 << 0,               //UI交互期間開始下載，致使延遲下載好比UIScrollView減速。       SDWebImageLowPriority = 1 << 1,               //只進行內存緩存       SDWebImageCacheMemoryOnly = 1 << 2,               //這個標誌能夠漸進式下載,顯示的圖像是逐步在下載       SDWebImageProgressiveDownload = 1 << 3,               //刷新緩存       SDWebImageRefreshCached = 1 << 4,               //後臺下載       SDWebImageContinueInBackground = 1 << 5,               //NSMutableURLRequest.HTTPShouldHandleCookies = YES;               SDWebImageHandleCookies = 1 << 6,               //容許使用無效的SSL證書       //SDWebImageAllowInvalidSSLCertificates = 1 << 7,               //優先下載       SDWebImageHighPriority = 1 << 8,               //延遲佔位符       SDWebImageDelayPlaceholder = 1 << 9,               //改變更畫形象       SDWebImageTransformAnimatedImage = 1 << 10,

2、SDWebImage內部實現過程

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. connection:didReceiveData: 中利用 ImageIO 作了按圖片下載進度加載效果。

12. connectionDidFinishLoading: 數據下載完成後交給 SDWebImageDecoder 作圖片解碼處理。

13. 圖片解碼處理在一個 NSOperationQueue 完成，不會拖慢主線程 UI。若是有須要對下載的圖片進行二次處理，最好也在這裏完成，效率會好不少。

14. 在主線程 notifyDelegateOnMainThreadWithInfo: 宣告解碼完成，imageDecoder:didFinishDecodingImage:userInfo: 回調給 SDWebImageDownloader。

15. imageDownloader:didFinishWithImage: 回調給 SDWebImageManager 告知圖片下載完成。

16. 通知全部的 downloadDelegates 下載完成，回調給須要的地方展現圖片。

17. 將圖片保存到 SDImageCache 中，內存緩存和硬盤緩存同時保存。寫文件到硬盤也在以單獨 NSInvocationOperation 完成，避免拖慢主線程。

18. SDImageCache 在初始化的時候會註冊一些消息通知，在內存警告或退到後臺的時候清理內存圖片緩存，應用結束的時候清理過時圖片。

19. SDWI 也提供了 UIButton+WebCache 和 MKAnnotationView+WebCache，方便使用。

20. SDWebImagePrefetcher 能夠預先下載圖片，方便後續使用。

從上面流程能夠看出，當你調用setImageWithURL:方法的時候，他會自動去給你幹這麼多事，當你須要在某一具體時刻作事情的時候，你能夠覆蓋這些方法。好比在下載某個圖片的過程當中要響應一個事件，就覆蓋這個方法：

1 2 3 4 5 6 7 8 9 10 11

//覆蓋方法，指哪打哪，這個方法是下載imagePath2的時候響應      SDWebImageManager *manager = [SDWebImageManager sharedManager];             [manager downloadImageWithURL:imagePath2 options:SDWebImageRetryFailed progress:^(NSInteger receivedSize, NSInteger expectedSize) {                     NSLog(@ "顯示當前進度" );                 } completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) {                     NSLog(@ "下載完成" );      }];