SDWebImage源码学习

前言

  简单做个介绍,SDWebImage:以我个人的理解,就是帮我们异步加载图片,并且缓存这些图片到内存及disk的一款非常棒的开源框架。其实除此之外,还有很多强大的功能供我们使用,我们如果能够熟练使用其API 就可以实现很多复杂的需求了。

  github最新下载地址:https://github.com/rs/SDWebImage

  下面,就开始学习下该框架。

正文

  由于我下载的是最新版的,一切就按照该版本的来整理学习。

先看下一个方法:

[_imageView2 sd_setImageWithURL:url2 placeholderImage:image2 options:SDWebImageRetryFailed progress:^(NSInteger receivedSize, NSInteger expectedSize) {
        NSLog(@"对下载进度做相关处理的事情");
    } completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {
        NSLog(@"图片加载完成后做的一些事情");
    }];

  这是最全的一个方法,看SDWebImage的源码也可以看到很多缩小版的方法也都是直接调用了该方法。其他方法就不做记录了

  关于参数:1.sd_setImageWithURL图片的url

       2.placeholderImage: 占位图片(图片没加载完成时显示的图片,也可以不选择)

       3.options: 提供的一种加载机制选择。默认值:SDWebImageRetryFailed 。详细看下。       

   //失败后重试
     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,

      4.progress: 看名字和参数应该可以了解该block的作用

      5.completed: 图片加载完成后的回调block,参数里面说一下SDImageCacheType,也是个枚举,通过该枚举我们可以了解到加载的图片是从哪里加载(缓存)来的,提供三种:SDImageCacheTypeNone 没有缓存类型,即网络下载来的

             SDImageCacheTypeDisk 由硬盘缓存而来

             SDImageCacheTypeMemory 由内存缓存而来

接下来我们来看下内部实现:

 一、在这步之前先学习个基于runtime机制的“关联”,因为他里面很多地方都用到了。

  1.建立关联:

    方法:objc_setAssociatedObject(id object, const void *key, id value, objc_AssociationPolicy policy)

      介绍下参数:object 源对象

            key 关键字 唯一静态变量key 注意:该参数是一个指针

            value 关联的对象

            policy 关联策略 :表明了相关的对象是通过赋值,保留引用还是复制的方式进行关联的;还有这种关联是原子的还是非原子的。

      我个人的理解就是这个方法的作用就是:将value对象通过key关键字以及policy关联策略和object关联起来。(那么此时value对象的生命周期就是依据关联策略和object对象相挂钩的。比如SDWebImage里面用到的一个关联策略OBJC_ASSOCIATION_RETAIN_NONATOMIC。其他不用关心,看到RETAIN,就应该知道此时就算我们release了value对象,如果object对象没有被release的话,我们依然可以访问的到value对象的。再进一步说,就是在object对象存在的时候,value对象一定存在。除非我们采用取消关联的操作。)

  2.获取相关联的对象

    方法:objc_getAssociatedObject(id object, const void *key)

      参数就不介绍,对应上面的关联方法就可以知道了。但是说明一点,该方法是有返回值的,返回值为value类型的对象。

  总结,先说下理论的东西。关联对象的存在是解决拓展中无法添加属性值而存在的,它以一个全局字典的形式存在,索引是你传递过来的key。以这种方式模拟出符合面向对象的数据与操作绑定的现象。其实我个人认为,之所以在这里用这个,是因为大多数的图片请求都是批量进行的,反复的调用请求方法,如果没有一个类似全局的manager来管理这些请求,势必会造成非常被动以及性能消耗的结果。所以作者在这里采用了这种方式,会把manager管理的当前operation给cancel掉,减少不必要的负荷。来提高框架的性能。

 二、SDWebImage内部实现过程

  1.入口:UIImageView+WebCache中先通过“关联”取消当前正在队列中的其他下载操作,然后显示placeholder占位图片。方法:

- (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options progress:(SDWebImageDownloaderProgressBlock)progressBlock completed:(SDWebImageCompletionBlock)completedBlock 

 

  2.SDWebImageManager通过传进来的url等参数进行图片请求操作。方法:

- (id <SDWebImageOperation>)downloadImageWithURL:(NSURL *)url options:(SDWebImageOptions)options progress:(SDWebImageDownloaderProgressBlock)progressBlock completed:(SDWebImageCompletionWithFinishedBlock)completedBlock

  3.先对传进来的url进行判断,如果url为空,或者是之前已经请求过失败的url并且option是SDWebImageRetryFailed(失败后重新请求)的话,就会直接回调失败的completedBlock(nil, error, SDImageCacheTypeNone, YES, url); 并返回error信息(NSURLErrorFileDoesNotExist)。代码:

 1    BOOL isFailedUrl = NO;
 2     @synchronized (self.failedURLs) {
 3         isFailedUrl = [self.failedURLs containsObject:url];
 4     }
 5     
 6     if (!url || (!(options & SDWebImageRetryFailed) && isFailedUrl)) {
 7         dispatch_main_sync_safe(^{
 8             NSError *error = [NSError errorWithDomain:NSURLErrorDomain code:NSURLErrorFileDoesNotExist userInfo:nil];
 9             completedBlock(nil, error, SDImageCacheTypeNone, YES, url);
10         });
11         return operation;
12     }

 

  4.通过urlKey在SDImageCache中先找看缓存里面图片是否已经下载。方法:

- (NSOperation *)queryDiskCacheForKey:(NSString *)key done:(SDWebImageQueryCompletedBlock)doneBlock

 

  5.会先在内存图片缓存中找,找到后回调doneBlock(image, SDImageCacheTypeMemory)到SDWebImageManager,SDWebImageManager再回调completedBlock(image, nil, cacheType, YES, url)到UIImageView+WebCache前端展示图片。代码:

1   UIImage *image = [self imageFromMemoryCacheForKey:key];
2   if (image) {
3      doneBlock(image, SDImageCacheTypeMemory);
4      return nil;
5   }

 

  6.如果在内存图片缓存中没有找到,生成NSOperation根据urlKey在硬盘中查找看图片是否已经缓存。如果从硬盘中读取到了图片,将图片添加到内存缓存中(如果空闲内存过小,会先清空内存缓存)。因为这一步是在 NSOperation 进行的操作,所以要回主线程进行结果回调doneBlock(diskImage, SDImageCacheTypeDisk)。然后SDWebImageManager再回调completedBlock(image, nil, cacheType, YES, url)到UIImageView+WebCache前端展示图片。代码:

 1     NSOperation *operation = [NSOperation new];
 2     dispatch_async(self.ioQueue, ^{
 3         if (operation.isCancelled) {
 4             return;
 5         }
 6 
 7         @autoreleasepool {
 8             UIImage *diskImage = [self diskImageForKey:key];
 9             if (diskImage) {
10                 NSUInteger cost = SDCacheCostForImage(diskImage);
11                 [self.memCache setObject:diskImage forKey:key cost:cost];
12             }
13 
14             dispatch_async(dispatch_get_main_queue(), ^{
15                 doneBlock(diskImage, SDImageCacheTypeDisk);
16             });
17         }
18     });

  7.如果内存和硬盘缓存都没有找到图片的话,就需要下载图片。调用SDWebImageDownloader的下载方法,到这一步才算是真正的下载。方法:

- (id <SDWebImageOperation>)downloadImageWithURL:(NSURL *)url options:(SDWebImageDownloaderOptions)options progress:(SDWebImageDownloaderProgressBlock)progressBlock completed:(SDWebImageDownloaderCompletedBlock)completedBlock

 

  8.关于下载,真的是蛮复杂的,以目前的能力好难看下去。以下内容摘自网络,以后能看明白了再补。

    共享或重新生成一个下载器 SDWebImageDownloader 开始下载图片。图片下载由 NSURLConnection 来做,实现相关 delegate 来判断图片下载中、下载完成和下载失败。connection:didReceiveData: 中利用 ImageIO 做了按图片下载进度加载效果。connectionDidFinishLoading: 数据下载完成后交给 SDWebImageDecoder 做图片解码处理。图片解码处理在一个 NSOperationQueue 完成,不会拖慢主线程 UI。如果有需要对下载的图片进行二次处理,最好也在这里完成,效率会好很多。在主线程 notifyDelegateOnMainThreadWithInfo: 宣告解码完成,imageDecoder:didFinishDecodingImage:userInfo: 回调给 SDWebImageDownloader。imageDownloader:didFinishWithImage: 回调给 SDWebImageManager 告知图片下载完成。通知所有的 downloadDelegates 下载完成,回调给需要的地方展示图片。将图片保存到 SDImageCache 中,内存缓存和硬盘缓存同时保存。写文件到硬盘也在以单独 NSInvocationOperation 完成,避免拖慢主线程。SDImageCache 在初始化的时候会注册一些消息通知,在内存警告或退到后台的时候清理内存图片缓存,应用结束的时候清理过期图片。SDWI 也提供了 UIButton+WebCache 和 MKAnnotationView+WebCache,方便使用。SDWebImagePrefetcher 可以预先下载图片,方便后续使用。

posted @ 2015-06-01 10:23  iOS_hevin  阅读(508)  评论(2编辑  收藏  举报