iOS

2016年8月2日

SDWebImage框架

1 框架的类图

image

2 简单的用法

2.1 给UIImageView设置图片（有 内存缓存+磁盘缓存 ）

//1 设置图片的URLNSURL *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

//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方法。直接全部清除。

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

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