美文网首页程序员
SDWebImage 4.3.2版本源码解释

SDWebImage 4.3.2版本源码解释

作者: LotusLee | 来源:发表于2018-05-17 00:09 被阅读0次

    文章结构

    • 主要类结构
    • 下载过程
    • 取消下载
    • 缓存处理

    主要类结构

    先来看一张我自己整理的类结构图,该图只是用于理解运行过程对象之间的持有关系,如下:


    核心类.png

    SDWebImageManager是一个单例,主要属性:
    imageCache:持有缓存处理的一个单例。
    imageDownloader:持有下载任务的一个单例。
    failedURLs数组:下载失败过的url会被添加进该数组中。
    runningOperations数组:下载的任务信息包含在该数组中,该数组包含的元素是SDWebImageCombinedOperation类的对象。

    SDWebImageCombinedOperation类中的主要属性:
    cancel:任务是否被取消
    downloadToken:包含在SDWebImageCombinedOperation这一层中可以获取的下载任务信息,如果需要在SDWebImageCombinedOperation这一层操作下载任务,则需要通过属性downloadToken操作。
    cacheOperation:封装了一个查询缓存的任务。

    SDWebImageDownloadToken类中主要属性:
    downloadOperation:这个才是真正的下载任务,是一个NSOperation类的一个自定义的子类,可以控制下载任务是否完成、是否在执行、取消下载等。
    downloadOperationCancelToken:该对象是一个字典,包含下载进度block和完成下载block的回调,前提是我们调用的时候有定义下载进度和完成下载回调。

    SDImageCache类是一个缓存处理类。

    SDWebImageDownloader是一个单例,主要属性:
    downloadQueue:下载队列,所有的下载任务都放到该队列中执行。
    URLOperations:用于保存在队列中的任务,下载完成就把完成的任务移除。

    下载过程

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

    当我们调用类似以上这些接口加载网络图片时候,内部分为几个步骤去完成添加一个网络请求任务到队列中。

    1. 调用UIView+WebCache分类中的方法
    - (void)sd_internalSetImageWithURL:(nullable NSURL *)url
                      placeholderImage:(nullable UIImage *)placeholder
                               options:(SDWebImageOptions)options
                          operationKey:(nullable NSString *)operationKey
                         setImageBlock:(nullable SDSetImageBlock)setImageBlock
                              progress:(nullable SDWebImageDownloaderProgressBlock)progressBlock
                             completed:(nullable SDExternalCompletionBlock)completedBlock
                               context:(nullable NSDictionary<NSString *, id> *)context
    

    具体实现我就不贴出来了,篇幅太长了,之后的方法讲解中只是讲解主要功能,一律不贴代码实现,相应的代码我会上传到github,对主要的方法里面都有注释。在该方法在红首先会取消掉上次的下载任务,原因是防止tableviewCell复用时候防止数据混乱。然后调用SDWebImageManager的下载方法

    - (id <SDWebImageOperation>)loadImageWithURL:(nullable NSURL *)url
                                         options:(SDWebImageOptions)options
                                        progress:(nullable SDWebImageDownloaderProgressBlock)progressBlock
                                       completed:(nullable SDInternalCompletionBlock)completedBlock
    

    该方法会返回一个SDWebImageCombinedOperation对象,然后在UIView+WebCache分类中通过运行时方法维护一个NSMapTable对象,该NSMapTable就存着这个返回的SDWebImageCombinedOperation对象,注意这里初始化NSMapTable时代码如下

    [[NSMapTable alloc] initWithKeyOptions:NSPointerFunctionsStrongMemory valueOptions:NSPointerFunctionsWeakMemory capacity:0];
    

    该NSMapTable对值并不持有,SDWebImageCombinedOperation对象会被SDWebImageManager的runningOperations数组持有,当该任务下载完成后,会从该数组中移除,然后NSMapTable中的相应对象就会被释放。在UIView+WebCache分类中持有SDWebImageCombinedOperation对象只是为了取消下载任务,后续会在取消下载中讲解。

    1. 调用SDWebImageManager的下载方法
    - (id <SDWebImageOperation>)loadImageWithURL:(nullable NSURL *)url
                                         options:(SDWebImageOptions)options
                                        progress:(nullable SDWebImageDownloaderProgressBlock)progressBlock
                                       completed:(nullable SDInternalCompletionBlock)completedBlock
    

    该方法主要是检查url的合法性、检查url是否已经在下载失败数组failedURLs中,如果url不合法或者url是一个下载失败过的url且没有添加SDWebImageRetryFailed标记,则立刻返回完成回调,附带有相关error信息。
    如果以上步骤没问题,则会把SDWebImageCombinedOperation对象放进SDWebImageManager的runningOperations数组中,检查该url是否有缓存,如果有则回调完成,如果没有缓存,则调用 SDWebImageDownloader单例开辟下载任务。

    1. 调用SDImageCache的检查缓存方法
    - (nullable NSOperation *)queryCacheOperationForKey:(nullable NSString *)key options:(SDImageCacheOptions)options done:(nullable SDCacheQueryCompletedBlock)doneBlock
    

    缓存检查是开辟子线程去处理的,防止阻塞UI,也可以通过标记SDImageCacheQueryDiskSync进行同步缓存检查,不过默认是异步的,该方法的主要实现过程会在缓存处理里说明。

    1. 调用SDWebImageDownloader的下载方法
    - (nullable SDWebImageDownloadToken *)downloadImageWithURL:(nullable NSURL *)url
                                                       options:(SDWebImageDownloaderOptions)options
                                                      progress:(nullable SDWebImageDownloaderProgressBlock)progressBlock
                                                     completed:(nullable SDWebImageDownloaderCompletedBlock)completedBlock 
    

    该方法会调用另外一个方法

    - (nullable SDWebImageDownloadToken *)addProgressCallback:(SDWebImageDownloaderProgressBlock)progressBlock
                                               completedBlock:(SDWebImageDownloaderCompletedBlock)completedBlock
                                                       forURL:(nullable NSURL *)url
                                               createCallback:(SDWebImageDownloaderOperation *(^)(void))createCallback
    

    初始化完成一个SDWebImageDownloadToken对象,可以回到文章前面的主要类查看该对象和其他类之间的关系。
    在该方法中生成真正的下载任务对象,即SDWebImageDownloaderOperation对象,并把该下载任务对象保存在SDWebImageDownloader的URLOperations属性中,URLOperations是一个字典维护在下载队列中的任务,完成下载后,会把对应的任务从该 数组中移除。所以在请求一个下载任务时候,会通过URLOperations字典检查某任务是否已经在 下载队列中,如果不在就添加一个任务,防止对同一个任务重复请求。

    1. 调用SDWebImageDownloaderOperation的注册回调方法
    - (nullable id)addHandlersForProgress:(nullable SDWebImageDownloaderProgressBlock)progressBlock
                                completed:(nullable SDWebImageDownloaderCompletedBlock)completedBlock 
    

    该方法就是为了让SDWebImageDownloaderOperation对象持有下载进度progressBlock和完成下载completedBlock回调。

    取消下载

    每次对控件加载网络图片时候,第一步就是取消之前的下载任务。

    1. 调用UIView+WebCache分类里的取消方法
    - (void)sd_cancelImageLoadOperationWithKey:(nullable NSString *)key 
    

    在该分类里维护的NSMapTable中查找是否存在下载任务(在文章开头有说明该层次的下载信息存放在SDWebImageCombinedOperation对象中,且遵循SDWebImageOperation协议),有的话就进行下一步。

    1. 调用SDWebImageCombinedOperation对象实现的SDWebImageOperation协议,该协议就是一个cancel方法,如下:
    @protocol SDWebImageOperation <NSObject>
    - (void)cancel;
    @end
    

    在该方法中把SDWebImageCombinedOperation中的属性cancel置为YES、取消查询缓存任务、通过自己持有的SDWebImageManager对象调用下载对象SDWebImageDownloader的取消下载任务、把SDWebImageCombinedOperation对象从runningOperations数组中移除。

    1. 调用SDWebImageDownloader的取消方法
    - (void)cancel:(nullable SDWebImageDownloadToken *)token;
    

    在该方法里会调用SDWebImageDownloaderOperation对象的方法

    - (BOOL)cancel:(nullable id)token 
    

    该方法传入的其实是一个字典(存放着下载进度和完成下载回调,如果有的话), 然后把任务从URLOperations字典中移除

    1. 调用SDWebImageDownloaderOperation的取消方法
    - (BOOL)cancel:(nullable id)token
    

    该方法会把回调从自己的callbackBlocks属性中移除,最重要的是把SDWebImageDownloaderOperation对象的executing置为NO,finished置为YES。真正的取消下载,才是SDWebImageDownloaderOperation对象中的实现,以上3步只是把取消指令传达给SDWebImageDownloaderOperation对象而已。
    类与类之间的消息传递,尽量不越过两个类,层层递进,思路非常清晰,是不是感觉作者设计得很巧妙啊-_-。

    缓存处理

    SDImageCacheConfig该类负责缓存的各种属性设置,如缓存多长时间、是否内存缓存、是否对图片解压等,默认缓存一个星期。
    SDImageCache缓存的处理类,主要方法如下:

    1. 查询缓存
    - (nullable NSOperation *)queryCacheOperationForKey:(nullable NSString *)key 
                                                     options:(SDImageCacheOptions)options 
                                                         done:(nullable SDCacheQueryCompletedBlock)doneBlock
    

    根据key查询内存缓存,如果存在且不执行磁盘缓存则立即返回缓存对象;否则创建一个NSOperation对象执行磁盘缓存查找。如果内存缓存不存在而磁盘缓存存在,则把图片数据缓存到内存缓存。执行磁盘缓存查找时候是异步的,如果标记SDImageCacheQueryDiskSync,则同步查询 磁盘缓存,这样会影响性能。

    1. 保存缓存
    - (void)storeImage:(nullable UIImage *)image
             imageData:(nullable NSData *)imageData
                forKey:(nullable NSString *)key
                toDisk:(BOOL)toDisk
            completion:(nullable SDWebImageNoParamsBlock)completionBlock
    

    如果允许内存缓存则,先把图片缓存到内存缓存,再异步保存到磁盘

    1. 注册通知执行磁盘缓存处理
      SDImageCache在初始化时候回注册两个通知,一个应用即将退出通知,一个进入后台通知
    // Subscribe to app events
            [[NSNotificationCenter defaultCenter] addObserver:self
                                                     selector:@selector(deleteOldFiles)
                                                         name:UIApplicationWillTerminateNotification
                                                       object:nil];
    
            [[NSNotificationCenter defaultCenter] addObserver:self
                                                     selector:@selector(backgroundDeleteOldFiles)
                                                         name:UIApplicationDidEnterBackgroundNotification
                                                       object:nil];
    

    这两个通知最终执行的都是下面这个方法

    - (void)deleteOldFilesWithCompletionBlock:(nullable SDWebImageNoParamsBlock)completionBlock 
    

    先删除最后改动日期超过一个星期的文件,如果删除后文件总大小还是比允许缓存的最大值大, 那就继续删除直到文件总大小为允许缓存的最大值的一半。

    1. 注册通知执行内存缓存处理
    [[NSNotificationCenter defaultCenter] addObserver:self
                                                     selector:@selector(didReceiveMemoryWarning:)
                                                         name:UIApplicationDidReceiveMemoryWarningNotification
                                                       object:nil];
    

    当收到内存警告通知时,会把内存缓存全部清理掉。

    最后,我把SDWebImage里添加过 注释的类标注如下:


    注释类.png

    我已经上传到github

    期待:如果有误,或者解释不清楚,可以给我留言,谢谢你的垂阅!

    相关文章

      网友评论

        本文标题:SDWebImage 4.3.2版本源码解释

        本文链接:https://www.haomeiwen.com/subject/qhgpdftx.html