SDWebImageDownloader
这个核心类是负责SDWebImage的图片下载管理等,维护着一个下载队列的并发线程,生成一个session
处理下载的任务,管理下载任务(取消,下载等状态改变)。
初始化了
downloadQueue
的最大并发数为6
,下载操作超时时间为15.0
。-
设置了Http请求的头部,即表示优先接受
image/webp
的web格式图片,其次接受image/*
格式的图片,q
为权重比例。_HTTPHeaders = [@{@"Accept": @"image/webp,image/*;q=0.8"} mutableCopy];
-
来看核心的方法:生成一个异步的下载传参Url地址的
SDWebImageOperation
,即下载的“操作”。- (id <SDWebImageOperation>)downloadImageWithURL:(NSURL *)url options:(SDWebImageDownloaderOptions)options progress:(SDWebImageDownloaderProgressBlock)progressBlock completed:(SDWebImageDownloaderCompletedBlock)completedBlock
- 生成operation前还设置了Http的请求头
allHTTPHeaderFields
,如果开发者实现了SDWebImageDownloaderHeadersFilterBlock
,则使用,反之使用SDWebImage默认的Headers。 - 将下载任务加入队列前,设置
NSURLCredential
Http身份认证,贴一段认证过程:
NSURLCredential 身份认证 1. web服务器接收到来自客户端的请求 2. web服务并不直接返回数据,而是要求客户端提供认证信息,也就是说挑战是服务端向客户端发起的 2.1 要求客户端提供用户名与密码挑战 NSInternetPassword 2.2 要求客户端提供客户端证书 NSClientCertificate 2.3 要求客户端信任该服务器 3. 客户端回调执行,接收到需要提供认证信息,然后提供认证信息,并再次发送给web服务 4. web服务验证认证信息 4.1 认证成功,将最终的数据结果发送给客户端 4.2 认证失败,错误此次请求,返回错误码401
- 生成operation前还设置了Http的请求头
* 设置任务队列的queue优先级,NSOperationQueuePriority,级别越高,调用几率就越大。
* 看到了下面的后进先出的下载任务(`LIFO`)。之前一直给自己绕进去了,在下载队列中,如果设置了`SDWebImageDownloaderLIFOExecutionOrder`。则设置加入到队列的下载任务的依赖关系,最新加入的任务,添加为上一个任务的依赖。以此来实现`LIFO`,下图参考。
![不同queue的NSOperation之间创建依赖关系](http://upload-images.jianshu.io/upload_images/684103-17153cba7b3e35b2.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
4. 以下的方法要配合‘3’中的方法看,其作用是`确保了同一个url对应的图片不会重复下载`或`多个相同的URL只下载一次`,即不会生成重复的下载任务。
```
- (void)addProgressCallback:(SDWebImageDownloaderProgressBlock)progressBlock
completedBlock:(SDWebImageDownloaderCompletedBlock)completedBlock forURL:(NSURL *)url
createCallback:(SDWebImageNoParamsBlock)createCallback {
// 图片地址为空时,返回带未完成参赛的Block
if (url == nil) {
if (completedBlock != nil) {
completedBlock(nil, nil, nil, NO);
}
return;
}
// dispatch_barrier_sync,我称呼它为同步栅栏函数。
// 等待之前的处理完成,即图片完成下载,或者取消下载时,需要在URLCallbacks移除图片下载地址
// 为了防止资源竞争,保证线程安全
dispatch_barrier_sync(self.barrierQueue, ^{
BOOL first = NO;
// 判断url是否已在CallBack里
if (!self.URLCallbacks[url]) {
self.URLCallbacks[url] = [NSMutableArray new];
first = YES;
}
// Handle single download of simultaneous download request for the same URL
NSMutableArray *callbacksForURL = self.URLCallbacks[url];
NSMutableDictionary *callbacks = [NSMutableDictionary new];
if (progressBlock) callbacks[kProgressCallbackKey] = [progressBlock copy];
if (completedBlock) callbacks[kCompletedCallbackKey] = [completedBlock copy];
[callbacksForURL addObject:callbacks];
self.URLCallbacks[url] = callbacksForURL;
// 如果URL地址是第一次加入,则创建一个下载任务,反之不予处理。
if (first) {
createCallback();
}
});
}
```
在此方法实现中,可以学习下`dispatch_barrier_async (dispatch_queue_t queue, dispatch_block_t block )`故名思义就是栅栏函数。其作用是在并发队列中创建一个点(同步点)。当遇到Barrier时,如果是同步的`sync`,就等待前面的Blocks执行结束后再执行Barrier自己的Block,而后队列继续正常操作。
5. 我们再看看,具体的下载操作`operationClass`的一些回调处理。在下载完成了时,返回图片image、data、完成标志等,并移除待下载图片URL。取消下载则移除待下载图片URL。下载过程中的进度回调,则在`URLCallbacks`中取出key为对应待下载图片URL,再遍历取出其的进度block,之后传递出去。
6. 此外剩下的是`NSURLSessionDataDelegate`和`NSURLSessionTaskDelegate`即下载数据以及事务的一些代理处理,这里`SDWebImageDownloader`都把其分散到`NSOperation`的分类中处理,这就是接下来需要看的了。而作者这样做,感觉业务性更清晰,让人理解起来也比较明朗。