SDWebImage 图片下载缓存框架 常用方法及原理

常见面试题：
SDWebImage的最大并发数是多少？_downloadQueue.maxConcurrentOperationCount = 6;
SDWebImages是如何识别图片的？NSData+ImageContentType.m中，根据图片文件十六进制数据的第一个字节判断



图片的十六进制第一个字节.png

SDWebImage 缓存图片命名规则？为了防止名称重复，对其进行 md5 运算
默认下载的超时时长是多少？15秒
默认缓存的时间？一周_maxCacheAge = kDefaultCacheMaxCacheAge;static const NSInteger kDefaultCacheMaxCacheAge = 60 * 60 * 24 * 7; // 1 week
SDWebImage用什么类型缓存图片？NSCacheSDImageCache内处理内存警告，以通知的方式，clearMemory
cleanDisk的执行过程i. 先遍历所有的缓存文件，记录过期的文件，计算缓存文件的总大小ii. 删除过期的文件iii. 判断maxCacheSize的值是否>0，如果大于0再判断缓存的文件总大小是否大于maxCacheSizeiv.如果缓存文件的总大小超过maxCacheSize，删除最早的文件注意：.jpg、.gif等文件需要把扩展名填上，png不需要

一、下载缓存

- (NSURL *)sd_imageURL;

2、下载网络图片并缓存

1.- (void)sd_setImageWithURL:(NSURL *)url;
2.- (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder;
3.- (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options;
4.下载图片的线程执行完后回调
- (void)sd_setImageWithURL:(NSURL *)url completed: (SDWebImageCompletionBlock)completedBlock;
5.- (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder completed:(SDWebImageCompletionBlock)completedBlock;

6.- (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options completed:(SDWebImageCompletionBlock)completedBlock;

7.下载图片并获取图片下载进度 progressBlock
- (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options progress:(SDWebImageDownloaderProgressBlock)progressBlock completed:(SDWebImageCompletionBlock)completedBlock;

例子：下载图片并且打印图片的下载进度

NSURL *url = [NSURL URLWithString:@"http://picview01.baomihua.com/photos/20120624/m_14_634761470842343750_15728444.jpg"]; 
[self.imageView sd_setImageWithURL:url placeholderImage:nil options:0 progress:^(NSInteger receivedSize, NSInteger expectedSize) {
//乘1.0是为了转换成float类型
float progress = receivedSize * 1.0 / expectedSize;
NSLog(@"下载进度 %f",progress);
} completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {
NSLog(@"完成");
}];

8.先从本地缓存中查找请求的图片，如果有先用本地图片占位，再从服务器请求下载图片

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

9.下载一组动画图片，并自动播放动画（arrayOfURLs为一组图片的地址数组）
- (void)sd_setAnimationImagesWithURLs:(NSArray *)arrayOfURLs;
10.取消当前下载

- (void)sd_cancelCurrentAnimationImagesLoad;
12.设置是否显示活的指示器以及样式
注意：必须在请求下载图片之前给UIImageView设置！不然无法显示！

- (void)setShowActivityIndicatorView:(BOOL)show;

- (void)setIndicatorStyle:(UIActivityIndicatorViewStyle)style;

二、 UIButton的类扩展
#import "UIButton+WebCache.h"

1.获取当前按钮图片的地址
- (NSURL *)sd_currentImageURL;
2.获取指定状态下按钮图片地址
- (NSURL *)sd_imageURLForState:(UIControlState)state;
3.设置不同UIControlState状态下的按钮图片
- (void)sd_setImageWithURL:(NSURL *)url forState:(UIControlState)state;
- (void)sd_setImageWithURL:(NSURL *)url forState:(UIControlState)state placeholderImage:(UIImage *)placeholder;
- (void)sd_setImageWithURL:(NSURL *)url forState:(UIControlState)state placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options;

- (void)sd_setImageWithURL:(NSURL *)url forState:(UIControlState)state completed:(SDWebImageCompletionBlock)completedBlock;

- (void)sd_setImageWithURL:(NSURL *)url forState:(UIControlState)state placeholderImage:(UIImage *)placeholder completed:(SDWebImageCompletionBlock)completedBlock;

- (void)sd_setImageWithURL:(NSURL *)url forState:(UIControlState)state placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options completed:(SDWebImageCompletionBlock)completedBlock;

1.设置不同状态的按钮背景图片
- (void)sd_setBackgroundImageWithURL:(NSURL *)url forState:(UIControlState)state;

- (void)sd_setBackgroundImageWithURL:(NSURL *)url forState:(UIControlState)state placeholderImage:(UIImage *)placeholder;
- (void)sd_setBackgroundImageWithURL:(NSURL *)url forState:(UIControlState)state placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options;

- (void)sd_setBackgroundImageWithURL:(NSURL *)url forState:(UIControlState)state completed:(SDWebImageCompletionBlock)completedBlock;

- (void)sd_setBackgroundImageWithURL:(NSURL *)url forState:(UIControlState)state placeholderImage:(UIImage *)placeholder completed:(SDWebImageCompletionBlock)completedBlock;

- (void)sd_setBackgroundImageWithURL:(NSURL *)url forState:(UIControlState)state placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options completed:(SDWebImageCompletionBlock)completedBlock;

5.取消当前指定状态按钮图片下载
- (void)sd_cancelImageLoadForState:(UIControlState)state;

6.取消当前指定状态按钮背景图片下载
- (void)sd_cancelBackgroundImageLoadForState:(UIControlState)state;
三、参数介绍
options 枚举：
1.SDWebImageRetryFailed 失败后重试， 默认如果下载失败,这个url会被加入黑名单并且不会尝试再次下载,设置这个枚举会阻止把失败的url加入黑名单，不断尝试重新下载
2.SDWebImageLowPriority 延迟下载， 默认情况下,图片会在交互发生的时候下载(例如你滑动tableview的时候),这个枚举会禁止这个特性,导致的结果就是在scrollview减速的时候才会开始下载(也就是你滑动的时候scrollview不下载,你手从屏幕上移走,scrollview开始减速的时候才会开始下载图片)
3.SDWebImageCacheMemoryOnly 只在内存缓存
4.SDWebImageProgressiveDownload 渐进式下载,显示的图像是逐步在下载
5.SDWebImageRefreshCached 刷新缓存，有时本地图片更新后与服务器没有同步一致时可以使用（例如更新头像），专门处理相同url，但不同image的情况的
原因：默认情况下，SDWebImage会忽略Header中的缓存设置，将图片以url为key进行保存，url与图片是一一对应关系。所以请求同一个url时，SDWebImage会从缓存中取得图片。一般的情况下用此方法可以满足我们的应用要求，但是如果你请求同一个url，而这张图片在服务器端更新了，本地客户端再次请求时还是会返回缓存中的旧图片，例如加载头像类经常更新的图片时，就会出现头像不能更新的问题，由于url与图片一一对应，一种解决的办法是改变部分url地址方式实现更新，不过这种方法操作起来很复杂， 另一种将第三个参数设置为SDWebImageRefreshCached就可以实现图片更新操作了。
6.SDWebImageContinueInBackground 启动后台下载，app进入后台后继续下载
7.SDWebImageHandleCookies 处理存储在NSHTTPCookieStore中的cookie

NSMutableURLRequest.HTTPShouldHandleCookies = YES;

8.SDWebImageAllowInvalidSSLCertificates 允许使用无效的SSL证书，主要用于测试目的，在正式环境中慎用
9.SDWebImageHighPriority 优先下载
10.SDWebImageDelayPlaceholder 等待下载完成后再显示占位图片，延迟显示占位图片
11.SDWebImageTransformAnimatedImage 改变动画形象
12.SDWebImageAvoidAutoSetImage 下载完成后手动设置图片，默认是下载完成后自动放到ImageView上

SDWebImageCompletionBlock
typedef void(^SDWebImageCompletionBlock)(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL);
参数：（1）请求的图片
（2）请求图片为空的错误
（3） SDImageCacheType 缓存类型，下次是从网上获取还是从本地获取， 枚举：SDImageCacheTypeNone 永不缓存，但是从网上下载SDImageCacheTypeDisk 只缓存到磁盘上SDImageCacheTypeMemory 只缓存到内存中
（4）图片的网络地址
SDWebImageDownloaderProgressBlock
typedef void(^SDWebImageDownloaderProgressBlock)(NSInteger receivedSize, NSInteger expectedSize);progress 参数：receivedSize 接收到的字节数expectedSize 期望下载的字节数//乘1.0是为了转换成float类型float progress = receivedSize * 1.0 / expectedSize;
四、本地缓存
#import"SDImageCache.h"
介绍：很多时候我们可能拍照得到的一张图片要多个地方使用，那么我们就希望可以把这张图片放到缓存里面，然后每次用这张图片的时候就去通过特定的方式取即可。
属性：
1.是否压缩图片
@property (assign, nonatomic) BOOL shouldDecompressImages;
2.是否禁用iCloud，默认YES
@property (assign, nonatomic) BOOL shouldDisableiCloud;
3.是否缓存到内存，默认YES
@property (assign, nonatomic) BOOL shouldCacheImagesInMemory;
4.最大缓存成本，针对内存
@property (assign, nonatomic) NSUInteger maxMemoryCost;
5.最大缓存个数，针对内存
@property (assign, nonatomic) NSUInteger maxMemoryCountLimit;
6.最大缓存时间，单位：秒，针对磁盘缓存，默认是一周，自动把一星期以前缓存的图片删除掉
@property (assign, nonatomic) NSInteger maxCacheAge;
7.最大缓存大小，单位字节，针对磁盘，默认无限制0，需要自己设置
@property (assign, nonatomic) NSUInteger maxCacheSize;

2、创建缓存空间
1.在沙盒的cache目录下创建一个指定名字的缓存空间（文件夹）
- (id)initWithNamespace:(NSString *)ns;
2.在磁盘指定目录（directory）下创建一个指定名字的缓存空间
- (id)initWithNamespace:(NSString *)ns diskCacheDirectory:(NSString *)directory;
3.添加一个只读的缓存路径
- (void)addReadOnlyCachePath:(NSString *)path;

3、缓存图片到内存和磁盘上
1.往内存和磁盘上存储一个图片（key参数是唯一的，用来取出图片，一般是图片的绝对路径）
- (void)storeImage:(UIImage *)image forKey:(NSString *)key;
例子：
SDImageCache *imageCache = [SDImageCache sharedImageCache];
[imageCache storeImage:image forKey:@"myphoto" toDisk:YES];
2.缓存一个图片到内存，并设置是否缓存到磁盘上
- (void)storeImage:(UIImage *)image forKey:(NSString *)key toDisk:(BOOL)toDisk;
3.缓存的基础方法，缓存一个图片到内存，并设置是否缓存到磁盘上（recalculate 是否重新计算图片的data ， imageData 图片的data）
- (void)storeImage:(UIImage *)image recalculateFromImage:(BOOL)recalculate imageData:(NSData *)imageData forKey:(NSString *)key toDisk:(BOOL)toDisk;
4、异步在磁盘上查找指定key图片的缓存，完成后回调block
- (NSOperation *)queryDiskCacheForKey:(NSString *)key done:(SDWebImageQueryCompletedBlock)doneBlock;

5、从内存、磁盘获取指定key的图片
- (UIImage *)imageFromMemoryCacheForKey:(NSString *)key;
- (UIImage *)imageFromDiskCacheForKey:(NSString *)key;

6、删除指定key的图片（fromDisk 是否删除磁盘缓存，completion删除结束后回调无参block）
- (void)removeImageForKey:(NSString *)key;
- (void)removeImageForKey:(NSString *)key withCompletion:(SDWebImageNoParamsBlock)completion;
- (void)removeImageForKey:(NSString *)key fromDisk:(BOOL)fromDisk;
- (void)removeImageForKey:(NSString *)key fromDisk:(BOOL)fromDisk withCompletion:(SDWebImageNoParamsBlock)completion;

7、清除所有缓存
1.清除所有内存图片缓存
- (void)clearMemory;
2.清除所有磁盘缓存图片时回调一个block
- (void)clearDiskOnCompletion:(SDWebImageNoParamsBlock)completion;
3.清除所有磁盘缓存
- (void)clearDisk;
4.从磁盘删除所有过期的图片时立即调用
- (void)cleanDiskWithCompletionBlock:(SDWebImageNoParamsBlock)completionBlock;
5.删除所有磁盘上过期的缓存图片
- (void)cleanDisk;

8、获取缓存大小、缓存个数
1.获取磁盘缓存大小
- (NSUInteger)getSize;
2.获取磁盘上缓存图片的个数
- (NSUInteger)getDiskCount;
3.异步计算磁盘缓存的大小
- (void)calculateSizeWithCompletionBlock:(SDWebImageCalculateSizeBlock)completionBlock;

9、从磁盘查找缓存图片
1.异步从磁盘中查找指定key的图片缓存，查找完成后回调这个block（该block永远在主线程执行）
- (void)diskImageExistsWithKey:(NSString*)key completion:(SDWebImageCheckCacheCompletionBlock)completionBlock;
2.检查磁盘中是否存在指定key的图片缓存
- (BOOL)diskImageExistsWithKey:(NSString *)key;
3.通过图片的key获取其缓存路径（path：缓存路径的根路径）
- (NSString*)cachePathForKey:(NSString*)key inPath:(NSString*)path;
4.从默认缓存路径下获取指定key图片的路径
- (NSString *)defaultCachePathForKey:(NSString *)key;

五、播放gif
#import "UIImage+GIF.h"

1.播放指定名字gif图片
+ (UIImage *)sd_animatedGIFNamed:(NSString *)name;
2.用指定gif的data播放
+ (UIImage *)sd_animatedGIFWithData:(NSData *)data;
3.设置gif图片尺寸
- (UIImage *)sd_animatedImageByScalingAndCroppingToSize:(CGSize)size;

六、SDWebImage 实现原理

先讲下大体架构：最外层是一个SDWebImageManager单例工具类管理另外两个单例类，一个是作下载处理的SDWebImageDownloader，它管理多个下载操作SDWebImageDownloaderOperation，一个作缓存处理的SDImageCache。

大体执行过程：当我们需要下载图片时，先让SDImageCache从缓存中找，如果找不到就异步从硬盘中读取图片，如果读取到就将图片缓存到内存并回调给SDWebImageManager，如果找不到就让SDWebImageDownloader 执行下载操作，在 SDWebImageDownloaderOperation 单个图片的下载操作中利用 NSURLConnection 执行下载，实现代理监听下载进度等，下载完成后交给SDWebImageDecoder 图片异步解码，完成后回调给SDWebImageDownloader，再回调给SDWebImageManager，再让SDImageCache去执行内存和磁盘（异步）的缓存操作。

具体过程：

1.UIImageView+WebCache: setImageWithURL:placeholderImage:options: 先显示 placeholderImage ，同时由SDWebImageManager 根据 URL 来在本地查找图片。
2.SDWebImageManager: downloadWithURL:delegate:options:userInfo: SDWebImageManager是将UIImageView+WebCache同SDImageCache链接起来的类， SDImageCache： queryDiskCacheForKey:delegate:userInfo:用来从缓存根据CacheKey查找图片是否已经在缓存中
3.如果内存中已经有图片缓存， SDWebImageManager会回调SDImageCacheDelegate : imageCache:didFindImage:forKey:userInfo:
而 UIImageView+WebCache 则回调SDWebImageManagerDelegate: webImageManager:didFinishWithImage:来显示图片。
4.如果内存中没有图片缓存，那么生成 NSInvocationOperation 添加到队列，从硬盘查找图片是否已被下载缓存。
根据 URLKey 在硬盘缓存目录下尝试读取图片文件。这一步是在 NSOperation 进行的操作，所以回主线程进行结果回调
notifyDelegate:
5.如果上一操作从硬盘读取到了图片，将图片添加到内存缓存中（如果空闲内存过小，会先清空内存缓存）。SDImageCacheDelegate 回调 imageCache:didFindImage:forKey:userInfo:进而回调展示图片。
6.如果从硬盘缓存目录读取不到图片，说明所有缓存都不存在该图片，需要下载图片，回调
imageCache:didNotFindImageForKey:userInfo:
共享或重新生成一个下载器 SDWebImageDownloader 开始下载图片。
图片下载由 NSURLConnection 来做，实现相关 delegate 来判断图片下载中、下载完成和下载失败。
connection:didReceiveData: 中利用 ImageIO 做了按图片下载进度加载效果。
connectionDidFinishLoading: 数据下载完成后交给 SDWebImageDecoder 做图片解码处理。
图片解码处理在一个 NSOperationQueue 完成，不会拖慢主线程 UI。
7.如果有需要对下载的图片进行二次处理，最好也在这里完成，效率会好很多。
在主线程 notifyDelegateOnMainThreadWithInfo: 宣告解码完成，imageDecoder:didFinishDecodingImage:userInfo: 回调给 SDWebImageDownloader。
imageDownloader:didFinishWithImage: 回调给 SDWebImageManager 告知图片下载完成。
通知所有的 downloadDelegates 下载完成，回调给需要的地方展示图片。
将图片保存到 SDImageCache 中，内存缓存和硬盘缓存同时保存。
写文件到硬盘在单独 NSInvocationOperation 中完成，避免拖慢主线程。
8.如果是在iOS上运行，SDImageCache 在初始化的时候会注册notification 到 UIApplicationDidReceiveMemoryWarningNotification 以及 UIApplicationWillTerminateNotification,在内存警告的时候清理内存图片缓存，应用结束的时候清理过期图片。
SDWebImagePrefetcher 可以预先下载图片，方便后续使用。

转载

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 211,884评论 6赞 492
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 90,347评论 3赞 385
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 157,435评论 0赞 348
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 56,509评论 1赞 284
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 65,611评论 6赞 386
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 49,837评论 1赞 290
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,987评论 3赞 408
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 37,730评论 0赞 267
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 44,194评论 1赞 303
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,525评论 2赞 327
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,664评论 1赞 340
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 34,334评论 4赞 330
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,944评论 3赞 313
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,764评论 0赞 21
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,997评论 1赞 266
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 46,389评论 2赞 360
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 43,554评论 2赞 349

推荐阅读更多精彩内容