SDWebImage使用——一個可管理遠程圖片加載的類庫

時間  2019-12-01
標籤 sdwebimage 使用 一個 管理 遠程 圖片 加載 简体版
原文   原文鏈接

SDWebImage使用——一個可管理遠程圖片加載的類庫html

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

這個類庫提供一個UIImageView類別以支持加載來自網絡的遠程圖片。具備緩存管理、異步下載、同一個URL下載次數控制和優化等特徵。git

將SDWebImage類庫添加入工程時，必定注意須要添加MapKit.framework，如圖所示，由於MKAnnotationView+WebCache.h依賴該framework。github

使用示範的代碼：web

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

前提#import導入UIImageView+WebCache.h文件，而後在tableview的cellForRowAtIndexPath：方法下：網絡

[cpp] view plain copy print ?
  1. #import "UIImageView+WebCache.h"  
  2.   
  3. ...  
  4.   
  5. - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath  
  6. {  
  7.     static NSString *MyIdentifier = @"MyIdentifier";  
  8.   
  9.     UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:MyIdentifier];  
  10.   
  11.     if (cell == nil)  
  12.     {  
  13.         cell = [[[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault  
  14.                                        reuseIdentifier:MyIdentifier] autorelease];  
  15.     }  
  16.   
  17.     // Here we use the new provided setImageWithURL: method to load the web image  
  18.     [cell.imageView setImageWithURL:[NSURL URLWithString:@"http://www.domain.com/path/to/image.jpg"]  
  19.                    placeholderImage:[UIImage imageNamed:@"placeholder.png"]];  
  20.   
  21.     cell.textLabel.text = @"My Text";  
  22.     return cell;  
  23. }  

基本代碼：dom

[cpp] view plain copy print ?
  1. [imageView setImageWithURL:[NSURL URLWithString:@<a href="http://www.domain.com/path/image.jpg">http://www.domain.com/path/image.jpg</a>]];  

針對iOS4+目標平臺，還可使用以下塊語句：異步

[cpp] view plain copy print ?
  1. // Here we use the new provided setImageWithURL: method to load the web image  
  2. [cell.imageView setImageWithURL:[NSURL URLWithString:@"http://www.domain.com/path/to/image.jpg"]  
  3.                placeholderImage:[UIImage imageNamed:@"placeholder.png"]  
  4.                         success:^(UIImage *image) {... success code here ...}  
  5.                         failure:^(NSError *error) {... failure code here ...}];  

2.     使用SDWebImageManager類：能夠進行一些異步加載的工做。async

[cpp] view plain copy print ?
  1. SDWebImageManager *manager = [SDWebImageManager sharedManager];  
  2. UIImage *cachedImage = [manager imageWithURL:url]; // 將須要緩存的圖片加載進來  
  3. if (cachedImage) {  
  4.       // 若是Cache命中，則直接利用緩存的圖片進行有關操做  
  5.       // Use the cached image immediatly  
  6. } else {  
  7.       // 若是Cache沒有命中，則去下載指定網絡位置的圖片，而且給出一個委託方法  
  8.       // Start an async download  
  9.      [manager downloadWithURL:url delegate:self];  
  10. }  

固然你的類要實現SDWebImageManagerDelegate協議，而且要實現協議的webImageManager:didFinishWithImage:方法。

[cpp] view plain copy print ?
  1. // 當下載完成後，調用回調方法，使下載的圖片顯示  
  2. - (void)webImageManager:(SDWebImageManager *)imageManager didFinishWithImage:(UIImage *)image {  
  3.     // Do something with the downloaded image  
  4. }  

3.     獨立的異步圖像下載
可能會單獨用到異步圖片下載，則必定要用downloaderWithURL:delegate:來創建一個SDWebImageDownloader實例。

[cpp] view plain copy print ?
  1. downloader =[SDWebImageDownloader downloaderWithURL:url delegate:self];  

這樣SDWebImageDownloaderDelegate協議的方法imageDownloader:didFinishWithImage:被調用時下載會當即開始並完成。


4.     獨立的異步圖像緩存

SDImageCache類提供一個建立空緩存的實例，並用方法imageForKey:來尋找當前緩存。

[cpp] view plain copy print ?
  1. UIImage*myCachedImage = [[SDImageCache sharedImageCache] imageFromKey:myCacheKey];  

存儲一個圖像到緩存是使用方法storeImage: forKey:

[cpp] view plain copy print ?
  1. [[SDImageCachesharedImageCache] storeImage:myImage forKey:myCacheKey];  

默認狀況下，圖像將被存儲在內存緩存和磁盤緩存中。若是僅僅是想內存緩存中，要使用storeImage:forKey:toDisk:方法的第三個參數帶一負值
來替代。

 

 

 

 

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的類別擴展來實現異步加載替換圖片的工做。

主要用到的對象：
一、UIImageView (WebCache)類別，入口封裝，實現讀取圖片完成後的回調
二、SDWebImageManager，對圖片進行管理的中轉站，記錄那些圖片正在讀取。
向下層讀取Cache（調用SDImageCache），或者向網絡讀取對象（調用SDWebImageDownloader） 。
實現SDImageCache和SDWebImageDownloader的回調。
三、SDImageCache，根據URL的MD5摘要對圖片進行存儲和讀取（實現存在內存中或者存在硬盤上兩種實現）
實現圖片和內存清理工做。
四、SDWebImageDownloader，根據URL向網絡讀取數據（實現部分讀取和所有讀取後再通知回調兩種方式）

其餘類：
SDWebImageDecoder，異步對圖像進行了一次解壓⋯⋯
目前不明白爲何要作這麼道工序。（如今清楚了，功能解釋見下文）

有趣的點：
一、SDImageCache是怎麼作數據管理的?
SDImageCache分兩個部分，一個是內存層面的，一個是硬盤層面的。
內存層面的至關是個緩存器，以Key-Value的形式存儲圖片。當內存不夠的時候會清除全部緩存圖片。
用搜索文件系統的方式作管理，文件替換方式是以時間爲單位，剔除時間大於一週的圖片文件。
當SDWebImageManager向SDImageCache要資源時，先搜索內存層面的數據，若是有直接返回，沒有的話去訪問磁盤，將圖片從磁盤讀取出來，而後作Decoder，將圖片對象放到內存層面作備份，再返回調用層。

二、爲啥必須作Decoder?
經過這個博客：http://www.cocoanetics.com/2011/10/avoiding-image-decompression-sickness/
如今明白了，因爲UIImage的imageWithData函數是每次畫圖的時候纔將Data解壓成ARGB的圖像，
因此在每次畫圖的時候，會有一個解壓操做，這樣效率很低，可是隻有瞬時的內存需求。
爲了提升效率經過SDWebImageDecoder將包裝在Data下的資源解壓，而後畫在另一張圖片上，這樣這張新圖片就再也不須要重複解壓了。

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

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程