2016年8月2日
SDWebImage框架
1 框架的类图
2 简单的用法
2.1 给UIImageView设置图片（有 内存缓存+磁盘缓存 ）
//1 设置图片的URL
NSURL *url = [NSURL URLWithString:@"http://img4.duitang.com/uploads/blog/201310/18/20131018213446_smUw4.thumb.700_0.jpeg"];
//2 直接使用UIImageView+WebCache.h的分类
[self.imageView sd_setImageWithURL:url placeholderImage:[UIImage imageNamed:@"egopv_error_placeholder"] options:0 progress:^(NSInteger receivedSize, NSInteger expectedSize) {
//下载进度
} completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {
switch (cacheType) {
case SDImageCacheTypeNone:
NSLog(@"缓存中没有--直接下载的");
break;
case SDImageCacheTypeDisk:
NSLog(@"磁盘缓存--直接从磁盘中获取的，未再次下载");
break;
case SDImageCacheTypeMemory:
NSLog(@"内存缓存--直接从内存中获取的，未再次下载");
break;
}
}];
2.2 直接下载图片（有 内存缓存+图片缓存）--SDWebImageManager
//1 获取图片下载地址
NSURL *url = [NSURL URLWithString:@"http://img4.duitang.com/uploads/blog/201310/18/20131018213446_smUw4.thumb.700_0.jpeg"];
//2 获取当前的管理器--单例
SDWebImageManager *manager = [SDWebImageManager sharedManager];
//3 下载图片
[manager downloadImageWithURL:url options:0 progress:^(NSInteger receivedSize, NSInteger expectedSize) {
//下载进度
} completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) {
//当前线程是主线程，可以刷新UI
self.imageView.image = image;
}];
2.3 直接下载图片（没有缓存处理）---SDWebImageDownloader
<b style="color:red">
注意：下载完毕后，是不会回到主线程的，需要我们自己回到主线程刷新UI
</b>
//1 获取图片下载地址
NSURL *url = [NSURL URLWithString:@"http://img4.duitang.com/uploads/blog/201310/18/20131018213446_smUw4.thumb.700_0.jpeg"];
//2 获取当前的下载器--单例
SDWebImageDownloader *downloader = [SDWebImageDownloader sharedDownloader];
//3 下载图片
[downloader downloadImageWithURL:url options:0 progress:^(NSInteger receivedSize, NSInteger expectedSize) {
} completed:^(UIImage *image, NSData *data, NSError *error, BOOL finished) {
//注意，当前的线程是子线程，不能刷新UI，需要回到主线程刷新
NSLog(@"%@",[NSThread currentThread]);
//回主线程
[[NSOperationQueue mainQueue]addOperationWithBlock:^{
self.imageView.image = image;
}];
}];
2.4 GIF图片的播放
内部原理：是讲gif图片读到内存，然后计算图片的帧数，然后将这些图片帧转换成图片后加入到图片数组中，通过UIImage的类方法animationImage来得到一个可动画的图片即可
//需要导入UIImage+Gif的分类
//直接导入gif图片
UIImage *image = [UIImage sd_animatedGIFNamed:@"xhr"];
self.imageView.image = image;
2.5 外部内存警告处理--我们自己处理
当系统接收到内存警告的时候，我们需要将所有的任务取消并清空缓存。所以，我们需要在AppDelegate.m的applicationDidReceiveMemoryWarning的方法中进行取消任务、清空缓存的操作。
AppDelegate.m文件
-(void)applicationDidReceiveMemoryWarning:(UIApplication *)application
{
//1 清空缓存
[[[SDWebImageManager sharedManager] imageCache] clearMemory];
//2 暂停任务
[[SDWebImageManager sharedManager] cancelAll]
}
<b style="color:red">
注意:clean和clear的区别？（清空缓存的时候）
（1）clean，包含了cleanDisk、cleanMemory方法。他首先会将已经过期(默认过期时间为7天)的文件删除，然后将剩下的文件计算总大小，与预设的缓存最大字节进行比对，如果超过最大限制，会继续删除（删除规则是：按照时间先后顺序进行删除）。
（2）clear,包含clearDisk、clearMemory方法。直接全部清除。
</b>
3 框架内部结构详解
3.1 下载操作最大并发数（maxConcurrentOpeationCount）
开下载线程，一般会在类SDWebImageDownloader和SDWebImageDownloaderOperation中进行，所以，查看最大并发数也需要在这两个类中查找。
SDWebImageDownloader.m
-(id)init
{
//其他代码省略....
//设置最大并发数，默认是6条
_downloadQueue.maxConcurrentOperationCount = 6;
//其他代码省略....
}
3.2 下载队列中，默认的执行方式(executionOrder,执行顺序)
同上，仍然是在SDWebImageDownloader中
SDWebImageDownloader.m
-(id)init
{
//设置执行的顺序
_executionOrder = SDWebImageDownloaderFIFOExecutionOrder;
}
3.3 缓存文件的文件名
框架在缓存的时候，为了存储时尽可能隐藏图片信息，它的文件名是图片的URL进行MD5加密得到的。
<b style="color:orange">
tips: MacOS终端可以集成了MD5加密功能。输入命令：echo "待加密字符串" | md5
chenhuadeMacBook-Pro:~ chmn$ echo "hello world" | md5
</b>
3.4 框架内部对于系统内存告警的处理
框架内存也会接受系统的内存告警事件，并进行响应的操作。可以在SDImageCache中看到。它的实现思路是：通过注册系统内存告警的通知进行的。
[[NSNotificationCenter defaultCenter] addObserver:self
selector:@selector(clearMemory)
name:UIApplicationDidReceiveMemoryWarningNotification
object:nil];
[[NSNotificationCenter defaultCenter] addObserver:self
selector:@selector(cleanDisk)
name:UIApplicationWillTerminateNotification
object:nil];
[[NSNotificationCenter defaultCenter] addObserver:self
selector:@selector(backgroundCleanDisk)
name:UIApplicationDidEnterBackgroundNotification
object:nil];
3.5 缓存的处理方式
我们自己写的简单多图下载程序中，缓存都是使用的可变字典，将图片的url和image进行对应。但是在框架中，它使用的NSCache（其实也类似字典）。
3.6 如何判断图片的类型
框架在下载文件，在保存文件的时候，需要知道文件的类型(jpg/jpeg/png/gif...)。因为同类型的图片转换成二进制(或十六进制)后，第一个字节是相同的，所以，框架是通过第一个字节去判断的。
NSData+ImageContentType.m
+ (NSString *)sd_contentTypeForImageData:(NSData *)data {
uint8_t c;
[data getBytes:&c length:1];
switch (c) {
case 0xFF:
return @"image/jpeg";
case 0x89:
return @"image/png";
case 0x47:
return @"image/gif";
case 0x49:
case 0x4D:
return @"image/tiff";
case 0x52:
// R as RIFF for WEBP
if ([data length] < 12) {
return nil;
}
NSString *testString = [[NSString alloc] initWithData:[data subdataWithRange:NSMakeRange(0, 12)] encoding:NSASCIIStringEncoding];
if ([testString hasPrefix:@"RIFF"] && [testString hasSuffix:@"WEBP"]) {
return @"image/webp";
}
return nil;
}
return nil;
}
3.7 框架内部是如何下载图片的
是发送网络请求，之前的版本是NSURLConnnection，目前是NSURLSession
3.8 默认的请求超时时间
可以在SDWebImageDownloader.m文件查看，默认是的超时时间是15秒
SDWebImageDownloader.m
-(id)init
{
_downloadTimeout = 15.0;
}
3.9 缓存的默认有效期
默认的缓存有效期是7天，可以在SDImageCache类中找到
static const NSInteger kDefaultCacheMaxCacheAge = 60 * 60 * 24 * 7; // 1 week