前言
在AFNetworking源码阅读1中,我们已经阅读完了AFHTTPSessionManager
类。本篇我们阅读其父类AFURLSessionManager
。该类是整个框架的核心。
源码:AFURLSessionManager
先来看看头文件AFURLSessionManager.h
该类代码太长,我们从头至尾一段一段看。先看头部的属性部分:
@interface AFURLSessionManager : NSObject <NSURLSessionDelegate, NSURLSessionTaskDelegate, NSURLSessionDataDelegate, NSURLSessionDownloadDelegate, NSSecureCoding, NSCopying>
// The managed session.
@property (readonly, nonatomic, strong) NSURLSession *session;
// The operation queue on which delegate callbacks are run.
@property (readonly, nonatomic, strong) NSOperationQueue *operationQueue; // 代理回调所运行的操作队列
@property (nonatomic, strong) id <AFURLResponseSerialization> responseSerializer;
@property (nonatomic, strong) AFSecurityPolicy *securityPolicy; // 安全策略
@property (readwrite, nonatomic, strong) AFNetworkReachabilityManager *reachabilityManager;
// The data, upload, and download tasks currently run by the managed session.
@property (readonly, nonatomic, strong) NSArray <NSURLSessionTask *> *tasks;
@property (readonly, nonatomic, strong) NSArray <NSURLSessionDataTask *> *dataTasks;
@property (readonly, nonatomic, strong) NSArray <NSURLSessionUploadTask *> *uploadTasks;
@property (readonly, nonatomic, strong) NSArray <NSURLSessionDownloadTask *> *downloadTasks;
// The dispatch queue for `completionBlock`. If `NULL` (default), the main queue is used.
@property (nonatomic, strong, nullable) dispatch_queue_t completionQueue;
// The dispatch group for `completionBlock`. If `NULL` (default), a private dispatch group is used.
@property (nonatomic, strong, nullable) dispatch_group_t completionGroup;
@property (nonatomic, assign) BOOL attemptsToRecreateUploadTasksForBackgroundSessions;
第一个属性session
就是该类所管理的session;operationQueue
是代理回调所运行的操作队列;responseSerializer
是解析网络返回数据的序列化器,它是实现了AFURLResponseSerialization
协议的任意类型;securityPolicy
有关网络安全连接的安全策略,这个后面还要继续研究;reachabilityManager
是检测网络状态的检测器,后面也会继续研究;tasks
代表管理的session此时正在运行的data task,upload task,download task们;completionQueue
为completionBlock
的dispatch queue,而completionGroup
为completionBlock
的dispatch group。
属性看完,该轮到初始化方法了:
#pragma mark - init method
- (instancetype)initWithSessionConfiguration:(nullable NSURLSessionConfiguration *)configuration NS_DESIGNATED_INITIALIZER;
- (void)invalidateSessionCancelingTasks:(BOOL)cancelPendingTasks; // 选择性地取消挂起的task
可以看到,第一个方法为初始化方法,第二个方法为选择性的取消挂起的session task,只需要传入某个挂起的task为参数,便可取消该task。
这里需要多说一句的是初始化方法后面有个标识符:NS_DESIGNATED_INITIALIZER
,它代表什么意思呢?它呀,意为“被设计的初始化器”,“被指定的初始化方法”。
详情请查看:iOS: 聊聊 Designated Initializer(指定初始化函数)
正确使用NS_DESIGNATED_INITIALIZER
接下来到了核心方法部分了:
#pragma mark - create task from request
- (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request
completionHandler:(nullable void (^)(NSURLResponse *response, id _Nullable responseObject, NSError * _Nullable error))completionHandler DEPRECATED_ATTRIBUTE;
- (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request
uploadProgress:(nullable void (^)(NSProgress *uploadProgress))uploadProgressBlock
downloadProgress:(nullable void (^)(NSProgress *downloadProgress))downloadProgressBlock
completionHandler:(nullable void (^)(NSURLResponse *response, id _Nullable responseObject, NSError * _Nullable error))completionHandler;
// 为一个本地文件通过构成一个特定request,从而创建uploadTask
- (NSURLSessionUploadTask *)uploadTaskWithRequest:(NSURLRequest *)request
fromFile:(NSURL *)fileURL
progress:(nullable void (^)(NSProgress *uploadProgress))uploadProgressBlock
completionHandler:(nullable void (^)(NSURLResponse *response, id _Nullable responseObject, NSError * _Nullable error))completionHandler;
可以看到以session task类型的不同,提供了不同的方法,并且同一类型的session task下也可能提供多个不同场景的方法。(篇幅有限,部分方法省略)
多说一句:DEPRECATED_ATTRIBUTE
标识符的意思是慢慢弃用的属性或接口,如果我们使用了,在xcode中就会出现警告⚠️信息。
接下来是这两个方法:
#pragma mark - get progress for task
- (nullable NSProgress *)uploadProgressForTask:(NSURLSessionTask *)task;
- (nullable NSProgress *)downloadProgressForTask:(NSURLSessionTask *)task;
这两个方法看名字就可以明白其意义:获得某个task的进度。
再接着就是session delegate callback的setter方法了,它们是和session以及session task的代理方法是一一对应的。在这里不作说明,等到阅读到代理方法时就明白了。
接下来就是最后一部分代码:
FOUNDATION_EXPORT NSString * const AFNetworkingTaskDidResumeNotification; // Posted when a task resumes.
FOUNDATION_EXPORT NSString * const AFNetworkingTaskDidCompleteNotification; // Posted when a task finishes executing
FOUNDATION_EXPORT NSString * const AFNetworkingTaskDidSuspendNotification; // Posted when a task suspends its execution.
FOUNDATION_EXPORT NSString * const AFURLSessionDidInvalidateNotification; // Posted when a session is invalidated.
FOUNDATION_EXPORT NSString * const AFURLSessionDownloadTaskDidFailToMoveFileNotification; // Posted when a session download task encountered an error when moving the temporary download file to a specified destination.
FOUNDATION_EXPORT NSString * const AFNetworkingTaskDidCompleteResponseDataKey;
FOUNDATION_EXPORT NSString * const AFNetworkingTaskDidCompleteSerializedResponseKey;
FOUNDATION_EXPORT NSString * const AFNetworkingTaskDidCompleteResponseSerializerKey;
FOUNDATION_EXPORT NSString * const AFNetworkingTaskDidCompleteAssetPathKey;
FOUNDATION_EXPORT NSString * const AFNetworkingTaskDidCompleteErrorKey;
上面的代码,声明了一些用于通知的全局常量。说起全局常量的使用方法:先在.h文件中用** extern声明此全局常量,然后在.m文件中定义该全局常量。《52个有效方法》笔记1——熟悉Objective-C。但在这里声明时并没有用extern**,而是用了
FOUNDATION_EXPORT
,关于它的解释见:FOUNDATION_EXPORT 或#define 或 extern
现在开始看AFURLSessionManager.m
:
代码太长太长,我们一段一段来分析。先来看看Extension部分:
@interface AFURLSessionManager ()
@property (readwrite, nonatomic, strong) NSURLSessionConfiguration *sessionConfiguration;
@property (readwrite, nonatomic, strong) NSOperationQueue *operationQueue;
@property (readwrite, nonatomic, strong) NSURLSession *session;
@property (readwrite, nonatomic, strong) NSMutableDictionary *mutableTaskDelegatesKeyedByTaskIdentifier;
@property (readonly, nonatomic, copy) NSString *taskDescriptionForSessionTasks;
@property (readwrite, nonatomic, strong) NSLock *lock;
@property (readwrite, nonatomic, copy) AFURLSessionDidBecomeInvalidBlock sessionDidBecomeInvalid;
@property (readwrite, nonatomic, copy) AFURLSessionDidReceiveAuthenticationChallengeBlock sessionDidReceiveAuthenticationChallenge;
@property (readwrite, nonatomic, copy) AFURLSessionDidFinishEventsForBackgroundURLSessionBlock didFinishEventsForBackgroundURLSession;
@property (readwrite, nonatomic, copy) AFURLSessionTaskWillPerformHTTPRedirectionBlock taskWillPerformHTTPRedirection;
@property (readwrite, nonatomic, copy) AFURLSessionTaskDidReceiveAuthenticationChallengeBlock taskDidReceiveAuthenticationChallenge;
@property (readwrite, nonatomic, copy) AFURLSessionTaskNeedNewBodyStreamBlock taskNeedNewBodyStream;
@property (readwrite, nonatomic, copy) AFURLSessionTaskDidSendBodyDataBlock taskDidSendBodyData;
@property (readwrite, nonatomic, copy) AFURLSessionTaskDidCompleteBlock taskDidComplete;
@property (readwrite, nonatomic, copy) AFURLSessionDataTaskDidReceiveResponseBlock dataTaskDidReceiveResponse;
@property (readwrite, nonatomic, copy) AFURLSessionDataTaskDidBecomeDownloadTaskBlock dataTaskDidBecomeDownloadTask;
@property (readwrite, nonatomic, copy) AFURLSessionDataTaskDidReceiveDataBlock dataTaskDidReceiveData;
@property (readwrite, nonatomic, copy) AFURLSessionDataTaskWillCacheResponseBlock dataTaskWillCacheResponse;
@property (readwrite, nonatomic, copy) AFURLSessionDownloadTaskDidFinishDownloadingBlock downloadTaskDidFinishDownloading;
@property (readwrite, nonatomic, copy) AFURLSessionDownloadTaskDidWriteDataBlock downloadTaskDidWriteData;
@property (readwrite, nonatomic, copy) AFURLSessionDownloadTaskDidResumeBlock downloadTaskDidResume;
@end
这里又定义了一个readwrite的session
作为私有属性。而在头文件中定义的session
属性是readonly
的。这么做更安全,在内部我们可对该属性进行读写操作,而暴露给外部时,使用者只能read。
mutableTaskDelegatesKeyedByTaskIdentifier
属性是个可变字典。该属性有大用处,以taskIdentifier作为key,以task delegate为value,将task和其delegate一对一绑定,后面还需细说。
然后后面均为回调block的属性。
然后我们看看初始化方法:
- (instancetype)init {
return [self initWithSessionConfiguration:nil];
}
- (instancetype)initWithSessionConfiguration:(NSURLSessionConfiguration *)configuration {
self = [super init];
if (!self) {
return nil;
}
if (!configuration) {
configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
}
/*
初始化各个属性
*/
self.sessionConfiguration = configuration;
self.operationQueue = [[NSOperationQueue alloc] init];
self.operationQueue.maxConcurrentOperationCount = 1;
self.session = [NSURLSession sessionWithConfiguration:self.sessionConfiguration delegate:self delegateQueue:self.operationQueue];
self.responseSerializer = [AFJSONResponseSerializer serializer]; // 默认的反序列化类型是AFJSONResponseSerializer
self.securityPolicy = [AFSecurityPolicy defaultPolicy];
#if !TARGET_OS_WATCH
self.reachabilityManager = [AFNetworkReachabilityManager sharedManager];
#endif
self.mutableTaskDelegatesKeyedByTaskIdentifier = [[NSMutableDictionary alloc] init];
self.lock = [[NSLock alloc] init];
self.lock.name = AFURLSessionManagerLockName;
// 遍历所管理的session的task,给每个task设置一个delegate
[self.session getTasksWithCompletionHandler:^(NSArray *dataTasks, NSArray *uploadTasks, NSArray *downloadTasks) {
for (NSURLSessionDataTask *task in dataTasks) {
[self addDelegateForDataTask:task uploadProgress:nil downloadProgress:nil completionHandler:nil];
}
for (NSURLSessionUploadTask *uploadTask in uploadTasks) {
[self addDelegateForUploadTask:uploadTask progress:nil completionHandler:nil];
}
for (NSURLSessionDownloadTask *downloadTask in downloadTasks) {
[self addDelegateForDownloadTask:downloadTask progress:nil destination:nil completionHandler:nil];
}
}];
return self;
}
- (void)dealloc {
[[NSNotificationCenter defaultCenter] removeObserver:self];
}
在初始化方法中可以看到。首先,若初始化时传入的参数configuration
为nil,则默认初始化为defaultSessionConfiguration
;然后就是初始化各个属性了,session
属性是通过NSURLSession
的类方法sessionWithConfiguration:delegate:delegateQueue:
方法来初始化的,设delegate为self。当时阅读代码时,始终有个疑问:本类实现了四个协议,第一个为session的协议,是在这里设置delegate为self了。后面三个协议我始终找不到在哪设置session task的delegate为self的地方,觉得很疑惑,这没地方设置过代理,为什么实现了代理方法?代理方法怎么会执行呢?后面我从网上才看到,只要设置了session的delegate,那也等同于设置该session创建的session task的代理。还因这个问题找了半天代码...
初始化方法的最后遍历了所管理的session的task,给每个task设置了一个delegate。关于设置delegate这个方法的实现细节,我们暂且等到下文详解。但这里我也有个疑惑:这里是初始化方法,session
才刚刚被初始化,该session应当还没有对应的session task啊,为何要遍历其session task?会有吗?这个问题百思不得其解,希望哪位大兄弟看到能解惑...
然后我们看这个类最重要的方法:
- (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request
completionHandler:(void (^)(NSURLResponse *response, id responseObject, NSError *error))completionHandler
{
return [self dataTaskWithRequest:request uploadProgress:nil downloadProgress:nil completionHandler:completionHandler];
}
- (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request
uploadProgress:(nullable void (^)(NSProgress *uploadProgress)) uploadProgressBlock
downloadProgress:(nullable void (^)(NSProgress *downloadProgress)) downloadProgressBlock
completionHandler:(nullable void (^)(NSURLResponse *response, id _Nullable responseObject, NSError * _Nullable error))completionHandler {
// 1.调用NSURLSession的实例方法dataTaskWithRequest生成dataTask
__block NSURLSessionDataTask *dataTask = nil;
url_session_manager_create_task_safely(^{
dataTask = [self.session dataTaskWithRequest:request];
});
// 2.为该dataTask设置delegate,将dataTask与delegate一一绑定
[self addDelegateForDataTask:dataTask uploadProgress:uploadProgressBlock downloadProgress:downloadProgressBlock completionHandler:completionHandler];
return dataTask;
}
看到这个方法名,我们大概能猜到该方法内部的实现步骤:因为参数为request,返回值时dataTask,那很可能是完成了由request生成dataTask的动作。但是应该还不仅仅是这样,因为该方法还有block回调,block回调的内容是怎么来的呢?
好了,一看代码果然和我们猜的差不多。这里面主要有两个步骤:
1.调用NSURLSession的实例方法dataTaskWithRequest:
生成dataTask。
url_session_manager_create_task_safely
是为了修复某个bug,我们在此不必纠结。
2.为该dataTask设置delegate,将dataTask与delegate一一绑定。并且通过block传递出来该请求任务的一些进度、数据、错误信息等。
我们看看第二个步骤的方法实现:
- (void)addDelegateForDataTask:(NSURLSessionDataTask *)dataTask
uploadProgress:(nullable void (^)(NSProgress *uploadProgress)) uploadProgressBlock
downloadProgress:(nullable void (^)(NSProgress *downloadProgress)) downloadProgressBlock
completionHandler:(void (^)(NSURLResponse *response, id responseObject, NSError *error))completionHandler
{
/*
创建一个AFURLSessionManagerTaskDelegate代理类的对象,并为几个属性赋值。然后调用setDelegate:forTask:将其和dataTask绑定
*/
AFURLSessionManagerTaskDelegate *delegate = [[AFURLSessionManagerTaskDelegate alloc] init];
delegate.manager = self;
delegate.completionHandler = completionHandler;
dataTask.taskDescription = self.taskDescriptionForSessionTasks;
[self setDelegate:delegate forTask:dataTask]; // 将delegate和task绑定的核心
delegate.uploadProgressBlock = uploadProgressBlock;
delegate.downloadProgressBlock = downloadProgressBlock;
}
可以看到,里面创建了一个AFURLSessionManagerTaskDelegate
代理类的对象,并为几个属性赋值(主要为block回调属性)。然后调用setDelegate:forTask:
将此delegate
实例对象和该task
绑定。但实现此功能的是setDelegate:forTask:
方法。
- (void)setDelegate:(AFURLSessionManagerTaskDelegate *)delegate
forTask:(NSURLSessionTask *)task
{
NSParameterAssert(task);
NSParameterAssert(delegate);
[self.lock lock];
// 将task和代理类绑定,task的taskIdentifier作为字典的key,delegate作为字典的value
self.mutableTaskDelegatesKeyedByTaskIdentifier[@(task.taskIdentifier)] = delegate;
[delegate setupProgressForTask:task]; // 该方法主要是设置两个NSProgress类型的变量uploadProgress和downloadProgress的属性
[self addNotificationObserverForTask:task]; // 给该task添加两个KVO事件
[self.lock unlock];
}
该方法内部有三个步骤:
1.将task的taskIdentifier作为键,将delegate作为值,赋给可变字典mutableTaskDelegatesKeyedByTaskIdentifier
。完成delegate和task的一对一绑定;
2.调用delegate的setupProgressForTask:
方法。由task设置delegate对象的uploadProgress
和downloadProgress
属性的属性值。
3.给该task添加两个观察(启动和暂停)。
关于步骤一,相当于对mutableTaskDelegatesKeyedByTaskIdentifier
可变字典的set操作,当然还有与此对应的get操作,获得某task对应的delegate。
- (AFURLSessionManagerTaskDelegate *)delegateForTask:(NSURLSessionTask *)task {
NSParameterAssert(task);
AFURLSessionManagerTaskDelegate *delegate = nil;
[self.lock lock];
delegate = self.mutableTaskDelegatesKeyedByTaskIdentifier[@(task.taskIdentifier)];
[self.lock unlock];
return delegate;
}
该类中有多处用到了get操作,比如:
移除某个task对应的delegate。首先通过delegateForTask:
方法获得此delegate,然后移除此task的进度观察,移除启动和暂停的观察,并最终从字典中删除此task。
- (void)removeDelegateForTask:(NSURLSessionTask *)task {
NSParameterAssert(task);
AFURLSessionManagerTaskDelegate *delegate = [self delegateForTask:task];
[self.lock lock];
[delegate cleanUpProgressForTask:task];
[self removeNotificationObserverForTask:task];
[self.mutableTaskDelegatesKeyedByTaskIdentifier removeObjectForKey:@(task.taskIdentifier)];
[self.lock unlock];
}
又比如:
** 获得该task的上传或下载进度。**
- (NSProgress *)uploadProgressForTask:(NSURLSessionTask *)task {
return [[self delegateForTask:task] uploadProgress];
}
- (NSProgress *)downloadProgressForTask:(NSURLSessionTask *)task {
return [[self delegateForTask:task] downloadProgress];
}
再比如,我们待会会讲到的,在该类实现的代理方法里,有时还需要调用在其代理类AFURLSessionManagerTaskDelegate
中实现的代理方法。此时就需要调用delegateForTask:
方法得到相应的delegate。
关于步骤三的实现详情:
- (void)addNotificationObserverForTask:(NSURLSessionTask *)task {
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(taskDidResume:) name:AFNSURLSessionTaskDidResumeNotification object:task];
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(taskDidSuspend:) name:AFNSURLSessionTaskDidSuspendNotification object:task];
}
为task添加启动和暂停的通知,当该task启动时就执行taskDidResume:
方法,当该task暂停时就执行taskDidSuspend:
方法。
- (NSString *)taskDescriptionForSessionTasks {
return [NSString stringWithFormat:@"%p", self];
}
- (void)taskDidResume:(NSNotification *)notification {
NSURLSessionTask *task = notification.object;
if ([task respondsToSelector:@selector(taskDescription)]) {
if ([task.taskDescription isEqualToString:self.taskDescriptionForSessionTasks]) {
dispatch_async(dispatch_get_main_queue(), ^{
[[NSNotificationCenter defaultCenter] postNotificationName:AFNetworkingTaskDidResumeNotification object:task];
});
}
}
}
taskDidResume:
和taskDidSuspend:
两个方法的代码是什么意思,没明白...不应该是在某个地方发出了通知,然后在这观察到了,然后就会执行这两个方法吗?那为什么,在这俩方法里还post notification?💔
更新:taskDidResume:
和taskDidSuspend:
分别是AFNSURLSessionTaskDidSuspendNotification
和AFNSURLSessionTaskDidSuspendNotification
的回调方法,我们上面说其意分别代表为task启动和暂停。为了确认,我们在代码中找找post出这俩通知的地方。
- (void)af_resume {
NSAssert([self respondsToSelector:@selector(state)], @"Does not respond to state");
NSURLSessionTaskState state = [self state];
[self af_resume];
if (state != NSURLSessionTaskStateRunning) {
[[NSNotificationCenter defaultCenter] postNotificationName:AFNSURLSessionTaskDidResumeNotification object:self];
}
}
- (void)af_suspend {
NSAssert([self respondsToSelector:@selector(state)], @"Does not respond to state");
NSURLSessionTaskState state = [self state];
[self af_suspend];
if (state != NSURLSessionTaskStateSuspended) {
[[NSNotificationCenter defaultCenter] postNotificationName:AFNSURLSessionTaskDidSuspendNotification object:self];
}
}
af_resume
和af_suspend
是什么方法呢?我们预期它应该是在该task执行resume
和suspend
方法后便立即post通知的。我们寻根溯源,继续找af_resume
和af_suspend
俩方法是在哪触发的:
+ (void)swizzleResumeAndSuspendMethodForClass:(Class)theClass {
Method afResumeMethod = class_getInstanceMethod(self, @selector(af_resume));
Method afSuspendMethod = class_getInstanceMethod(self, @selector(af_suspend));
if (af_addMethod(theClass, @selector(af_resume), afResumeMethod)) {
af_swizzleSelector(theClass, @selector(resume), @selector(af_resume));
}
if (af_addMethod(theClass, @selector(af_suspend), afSuspendMethod)) {
af_swizzleSelector(theClass, @selector(suspend), @selector(af_suspend));
}
}
可以看到那俩方法大量基本出现在swizzleResumeAndSuspendMethodForClass:
这个方法中,继续找寻根溯源,原来这个方法是在_AFURLSessionTaskSwizzling
这个类的load
方法中调用的。_AFURLSessionTaskSwizzling
这个类干了什么,我们研究研究。
说到这我们得说说
Method Swizzing
,我在这篇文中已经说过:《52个有效方法》笔记3——探究runtime摘录如下:
OC对象都有一个isa指针,该指针指向一个方法调度表,它存储着该对象的方法。并且,它的形式是键值对,key为SEL,value为IMP。
既然如此,那我们可以在SEL和IMP的映射上做文章。也就是说我可以人为地改变SEL和IMP之间的映射关系。
这样做有什么意义吗?嗯,意义很大。我们可以把原有的类和我们自定义类的映射对调,那这样,即使我们在代码里调用的是原有类的方法,但暗地里却神不知鬼不觉地在执行我们自定义的方法。哈哈,说得有些玄乎了。
其实,在实践中Method Swizzing可以完成AOP或者对原有类的拓展。
在本例中,就将原始的resume
和suspend
俩方法的实现IMP
调包了,调成了_AFURLSessionTaskSwizzling
这个类自己实现的af_resume
和af_suspend
。而在af_resume
和af_suspend
俩方法里,我们分别post出了相应的通知。如以一来,即便是程序是在调用原始的resume
方法,但程序实际上却神不知鬼不觉地执行了af_resume
,发送了通知出来。
另外之前看这块代码时觉得蒙圈的一个地方是把````taskDidResume:和
taskDidSuspend:俩方法里发送的通知名字看错了😅。在这俩回调方法里post出的是
AFNetworkingTaskDidResumeNotification和
AFNetworkingTaskDidSuspendNotification通知,主要是用于通知UI层的。并不是
AFNSURLSessionTaskDidResumeNotification和
AFNSURLSessionTaskDidSuspendNotification``通知,当时太蒙圈了,怎么在观察到通知的回调里再次发出通知😅。
现在,我们来看看在该类中实现的代理方法。在该类中实现了4个协议的代理方法。
有关这些代理方法的含义及具体实现的讲解这篇文章讲解的很详细,在此我不再写了:
AFNetworking源码阅读(三)
但是还是有几个点需要说明一下。
首先,就是我们可以看到在这些代理方法的实现里,很多都会先判断有无与代理方法对应的自定义的block回调(这个我们在前面讲头文件时提到过,那些block都是与代理方法对应的)。若有,则调用自定义的block,在定义的block回调里做相应的处理。
说起自定义的block回调。若按我平时的写法习惯,我一般都是直接在头文件中定义为公开属性。这样在.m文件里直接调用就行。但是这里的源码却不是,它没有在头文件中定义为公开的属性,而是在.m的Extension中定义为私有属性,在.h头文件中以定义的setXXX方法的形式暴露其接口,然后又在.m文件的方法体中赋给了私有block属性。这和直接在头文件定义为block属性其实应该是等效的,之所以这么写,难道是这样更安全?
其次,在阅读源码时我一直困惑于一个问题:
既然在创建session时,设self
,即AFURLSessionManager
为其代理,那为什么还要再来个AFURLSessionManagerTaskDelegate
类,在这个代理类中将部分代理方法再实现一遍?
而且这个代理类是和AFURLSessionManager
类写在一个文件里的,刚开始读时没注意到,阅读时有种剪不断理还乱的感觉。所以这个问题一直困惑不解,所以我百度了又百度,终于看到别人的一篇文章有解释这个问题。摘录如下:
AFNetWorking(3.0)源码分析(二)——AFURLSessionManager
AFURLSessionManager 与 AFURLSessionManagerTaskDelegate 的分工
到这里我们可以想一想,既然NSURLSession的delegate是AFURLSessionManager对象,那么为什么不在AFURLSessionManager中处理所有的事件回调,搞出来一个AFURLSessionManagerTaskDelegate干什么?
我们知道,NSURLSession的回调有很多,而当我们启动一个task,真正想要获取的信息是什么呢?就是网络请求最终所返回的数据(我所进行的网络操作成功或是失败,服务器为我返回的数据)呗! 其它的回调,什么认证质询,task需要新的body stream,什么request即将重定向, 统统都是浮云,都是为了我们能够最终获取到服务器返回的数据所服务的。
另外我们也想要知道我们的网络请求的进度。
总结为两点:
- 获取最终返回数据
- 获知当前请求的进度
于是,AFNetWorking 便在纷繁复杂的回调处理中,特意抽象出AFURLSessionManagerTaskDelegate,用于应付网络返回数据的处理(包括保存中间值,序列化返回值,错误处理)和网络请求进度。
这样做可以使代码结构更分明,逻辑更清晰。
真是谢谢这位博主。说起来其实就是分工,将我们最终感兴趣的东西(服务器返回的数据,进度,错误信息等)抽离在代理类中。
结尾
本篇将AFURLSessionManager
类说得差不多了,好累,洗洗睡。明天写下一篇,整理整理AFURLSessionManagerTaskDelegate
类。