iOS第三方網狀圖片載入－ SDWebImage筆記

標籤：

SDWebImage託管在github上。https://github.com/rs/SDWebImage

這個類庫提供一個UIImageView類別以支援載入來自網路的遠程圖片。具有緩衝管理、非同步下載、同一個URL下載次數控制和最佳化等特徵。
使用示範的代碼：

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

前提#import匯入UIImageView+WebCache.h檔案，然後在tableview的cellForRowAtIndexPath：方法下： 

 - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {

     static NSString *MyIdentifier = @"MyIdentifier";

     UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:MyIdentifier];

    if (cell == nil) {

         cell = [[[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:MyIdentifier] autorelease];

     }

// Here we use the new provided setImageWithURL: method to load the web image

    [cell.imageView setImageWithURL:[NSURL URLWithString:@"http://www.domain.com/path/to/image.jpg"] placeholderImage:[UIImage imageNamed:@"placeholder.png"]];

    cell.textLabel.text = @"My Text";

    return cell;

 }

基本代碼：[imageView setImageWithURL:[NSURL URLWithString:@"http://www.domain.com/path/image.jpg"]];

使用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:方法的第三個參數帶一負值

來替代。

SDWebImage 支援非同步圖片下載+緩衝，提供了 UIImageView+WebCacha 的 category，方便使用。紀錄一下 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 可以預先下載圖片，方便後續使用。

SDWebImage庫的作用：
通過對UIImageView的類別擴充來實現非同步載入替換圖片的工作。

主要用到的對象：
1、UIImageView (WebCache)類別，入口封裝，實現讀取圖片完成後的回調
2、SDWebImageManager，對圖片進行管理的中轉站，記錄那些圖片正在讀取。
向下層讀取Cache（調用SDImageCache），或者向網路讀取對象（調用SDWebImageDownloader） 。
實現SDImageCache和SDWebImageDownloader的回調。
3、SDImageCache，根據URL的MD5摘要對圖片進行儲存和讀取（實現存在記憶體中或者存在硬碟上兩種實現）
實現圖片和記憶體清理工作。
4、SDWebImageDownloader，根據URL向網路讀取資料（實現部分讀取和全部讀取後再通知回調兩種方式）

其他類：
SDWebImageDecoder，非同步對映像進行了一次解壓??
目前不明白為什麼要做這麼道工序。（現在清楚了，功能解釋見下文）

有趣的點：
1、SDImageCache是怎麼做資料管理的?
SDImageCache分兩個部分，一個是記憶體層面的，一個是硬碟層面的。
記憶體層面的相當是個緩衝器，以Key-Value的形式儲存圖片。當記憶體不夠的時候會清除所有緩衝圖片。
用搜尋檔案系統的方式做管理，檔案替換方式是以時間為單位，剔除時間大於一周的圖片檔案。
當SDWebImageManager向SDImageCache要資源時，先搜尋記憶體層面的資料，如果有直接返回，沒有的話去訪問磁碟，將圖片從磁碟讀取出來，然後做Decoder，將圖片對象放到記憶體層面做備份，再返回調用層。

2、為啥必須做Decoder?
通過這個部落格：http://www.cocoanetics.com/2011/10/avoiding-image-decompression-sickness/
現在明白了，由於UIImage的imageWithData函數是每次畫圖的時候才將Data解壓成ARGB的映像，
所以在每次畫圖的時候，會有一個解壓操作，這樣效率很低，但是只有瞬時的記憶體需求。
為了提高效率通過SDWebImageDecoder將封裝在Data下的資源解壓，然後畫在另外一張圖片上，這樣這張新圖片就不再需要重複解壓了。

這種做法是典型的空間換時間的做法。

   

iOS第三方網狀圖片載入－ SDWebImage筆記（轉）