类结构
今天主要对 AFNetworking 的初始化过程进行整理,首先看一下文件结构图,这里除 UIKit 部分一共包括6个类:AFHTTPSessionManager
,AFURLSessionManager
,AFSecurityPolicy
,AFURLRequestSerialization
,AFURLResponseSerialization
和AFNetworkReachabilityManager
。
-
AFHTTPSessionManager:
继承于AFURLSessionManager
,通常在项目中直接使用AFHTTPSessionManager
类,负责处理网络请求和响应。 -
AFURLSessionManager:
AFNetworking 的核心类,初始化NSURLSession
等对象并实现了相关协议。 -
AFSecurityPolicy:
负责身份验证 -
AFURLRequestSerialization:
负责序列化请求 -
AFURLResponseSerialization:
负责序列化响应 -
AFNetworkReachabilityManager:
负责检测网络连接状态
初始化
我们在初始化的地方设置断点,通过调用栈可以一步步观察到
AFHTTPSessionManager
对象的初始化过程。正如之前所提 AFHTTPSessionManager
继承自 AFURLSessionManager
,可以知道 initWithSessionConfiguration:
就是核心初始化方法。接下来我们看一下这个方法里面做了哪些事:
- (instancetype)initWithSessionConfiguration:(NSURLSessionConfiguration *)configuration {
self = [super init];
if (!self) {
return nil;
}
// 初始化NSURLSessionConfiguration对象
if (!configuration) {
configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
}
self.sessionConfiguration = configuration;
// 初始化操作队列,并设置最大并发数为1
self.operationQueue = [[NSOperationQueue alloc] init];
self.operationQueue.maxConcurrentOperationCount = 1;
// 使用NSURLSessionConfiguration对象和队列对象初始化NSURLSession对象,并设置代理
self.session = [NSURLSession sessionWithConfiguration:self.sessionConfiguration delegate:self delegateQueue:self.operationQueue];
// 初始化响应序列器,默认响应JSON数据
self.responseSerializer = [AFJSONResponseSerializer serializer];
// 初始化AFSecurityPolicy对象,负责证书安全认证
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;
// 设置代理
[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;
}
说明
NSURLSessionConfiguration
NSURLSessionConfiguration
对象定义了使用 NSURLSession
对象上传和下载数据时要使用的行为和策略。在上传或下载数据时,创建配置对象总是您必须采取的第一步。您可以使用该对象来配置超时值、缓存策略、连接需求和其他类型的信息,这些信息是您打算与 NSURLSession
对象一起使用的。
在使用 NSURLSessionConfiguration
对象初始化会话对象之前,适当地配置 NSURLSessionConfiguration
对象是非常重要的。会话对象复制您提供的配置设置并使用这些设置来配置会话。一旦配置好,会话对象就会忽略对 NSURLSessionConfiguration
对象所做的任何更改。如果需要修改传输策略,则必须更新会话配置对象并使用它创建新的 NSURLSession
对象。
AFJSONResponseSerializer
AFJSONResponseSerializer
是 AFHTTPResponseSerializer
的子类,用来验证和解码 JSON 响应。默认情况下,AFJSONResponseSerializer
接受以下 MIME 类型,其中包括官方标准 application/json
以及其他常用类型:
application/json
text/json
text/javascript
在RFC 7159 - 8.1节中,它指出JSON文本需要用UTF-8、UTF-16或UTF-32编码,默认编码是UTF-8。NSJSONSerialization
提供了对规范中列出的所有编码的支持,并推荐使用UTF-8来提高效率。使用不支持的编码将导致序列化错误。有关详细信息,请参阅“NSJSONSerialization”文档。
总结
在该初始化方法中,它做了这么几件事:
(1)初始化会话配置(session configuration)默认为 defaultSessionConfiguration
(2)初始化队列,设置队列的最大并发数为1
(3)初始化会话(session),并将 session 的代理对象设置为 self(也就是当前 AFURLSessionManager
对象),并将代理队列设置为(2)中创建的队列。
(4)初始化响应序列化
(5)初始化安全认证
(6)初始化网络状态监控
(7)初始化保存 NSURLSessionDataTask
的字典(很重要)
(8)初始化线程锁(很重要)
(9)最后一大坨代码是为已经存在的 task 设置 delegate(也很重要)