学习自这篇文章,感谢作者。
1、对外接口类 : AFHTTPSessionManager
包含初始化方法
- (instancetype)initWithBaseURL:(nullable NSURL *)url
等;
这个类只是提供对外接口方法,真正的初始化、网络请求都提交给父类 AFURLSessionManager 去做;
比如调用父类的方法创建 task,这个类仅仅是把 得到的 task resume;
这个类做了一件重要的事:把外面的使用者传进来的参数,编码成 request, 传给父类做网络请求;创建 request 用到一个类:AFHTTPRequestSerializer。
2、请求参数解析类 : AFHTTPRequestSerializer
对外关键方法:- requestWithMethod:URLString:parameters:error:
,该方法返回一个 NSMutableURLRequest 对象;
属性:比如 allowsCellularAccess
、timeoutInterval
,是和 NSMutableURLRequest 的属性名一致的属性,可以直接设置;而且该类用观察者模式监控这些属性的值变化
3、AF 请求核心类 : AFURLSessionManager
①对外接口子类 AFHTTPRequestSerializer 初始化触发了这个类的初始化方法:- (instancetype)initWithSessionConfiguration:(nullable NSURLSessionConfiguration *)configuration NS_DESIGNATED_INITIALIZER
;
这个初始化方法里用到一个重要的属性 mutableTaskDelegatesKeyedByTaskIdentifier
,这个属性是用来存储 url task 与 AFURLSessionManagerTaskDelegate
的 NSDictionary;在 AFNetworking 中,每一个 task 都会被匹配一个 AFURLSessionManagerTaskDelegate 来做 task 的 delegate 事件处理,设置一个 NSLock,用于保证属性 mutableTaskDelegatesKeyedByTaskIdentifier的线程安全。
该类的 NSOperationQueue 类型的属性 operationQueue
是 task 完成之后的回调所在的 queue,maxConcurrentOperationCount 设置为 1,表示该 queue 是串行的,即完成之后的 task 回调是一个接一个执行的;这么做的意义是:
另外该类还有遵循 AFURLResponseSerialization
协议的属性 responseSerializer
,用于各种响应转码,AFSecurityPolicy 类型的属性 securityPolicy,用于请求安全(ssl证书);AFNetworkReachabilityManager
类型的属性 reachabilityManager
,用于监控网络状态。
②被子类 AFHTTPSessionManager 调用以创建 task 的方法:- (NSURLSessionDataTask *)dataTaskWithRequest:uploadProgress:downloadProgress:completionHandler:
直接调用 iOS 系统的 NSURLSession 的 -dataTaskWithRequest: 方法创建 task;由于 iOS 8 以下会并发地创建多个 task 对象,没有做好同步,导致这些 task 的属性 taskIdentifiers
不唯一,故这边做了一个串行处理,即调用函数 url_session_manager_create_task_safely()
; 此同步函数内部实现为通过调用 dispatch_sync() 函数在 url_session_manager_creation_queue()
队列上同步部属任务;
正如初始化方法中提到的 mutableTaskDelegatesKeyedByTaskIdentifier 属性,创建 task 的方法给每一个 task 创建并对应一个 AFURLSessionManagerTaskDelegate
对象,这个代理对象为其对应的 task 做数据拼接及成功回调;创建代理对象的方法:-addDelegateForDataTask:uploadProgress:downloadProgress:completionHandler:
此方法将 AFURLSessionManagerTaskDelegate 与 AFURLSessionManager 建立联系,将各种回调 block 赋值给 AFURLSessionManagerTaskDelegate;同步(NSLock)地将 task.taskIdentifier 和 AFURLSessionManagerTaskDelegate 对象以 key-value 形式存储到 mutableTaskDelegatesKeyedByTaskIdentifier NSDictionary 属性中,并给 self (AFURLSessionManager) 添加 task 开始和暂停的通知 : AFNSURLSessionTaskDidResumeNotification
和 AFNSURLSessionTaskDidSuspendNotification
;
类似的创建 task 的方法还有多个,如创建下载 task -downloadTaskWithRequest:progress:destination:completionHandler
:
③至此 AFURLSessionManager 已经初始化完毕,task 已经被创建好,并关联了 AFURLSessionManagerTaskDelegate 对象用于回调,现在在 AFHTTPSessionManager 类中 task 可以开始网络请求了:[dataTask resume]
。 开启了网络请求之后,需要处理回调。回到 AFURLSessionManager 类,创建 NSURLSession 对象时,delegate <NSURLSessionDelegate>设置为 self,则
AFURLSessionManager 对象作为了所有 task 的 delegate。AFURLSessionManager 类实现了以下4个协议的方法:<NSURLSessionDelegate, NSURLSessionTaskDelegate, NSURLSessionDataDelegate, NSURLSessionDownloadDelegate>, 而将这些代理方法中的一部分转交给 AFURLSessionManagerTaskDelegate
处理,如 -URLSession:task:didCompleteWithError:
方法,即 task 执行完成的回调,或 -URLSession:dataTask:didReceiveData:
方法,即收到数据时的回调,或-URLSession:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite:
方法,即下载进度的回调。
AFURLSessionManager 提供了一些 block 类型的属性,如 sessionDidBecomeInvalid
,didFinishEventsForBackgroundURLSession
,downloadTaskDidWriteData
等,这些 block 如果被外部赋值,则会在 NSURLSessionDelegate,NSURLSessionTaskDelegate 等代理方法中被调用
4、task 的网络请求代理类 : AFURLSessionManagerTaskDelegate
如前所述,该类用作 task 网络请求的代理,并将请求处理结果回调给外部;如 -URLSession:task:didCompleteWithError:
方法是请求完成的回调方法。
5、响应数据解析类 : AFHTTPResponseSerializer
该类是用于解析响应的数据,遵循 AFURLResponseSerialization
协议,该类有几个子类,分别对应不同数据类型的解析,包括 AFJSONResponseSerializer,AFXMLParserResponseSerializer,AFImageResponseSerializer 等等。其中 AFJSONResponseSerializer 为 对外请求类 AFHTTPSessionManager 的解析类属性 responseSerializer 的默认类型,即 JSON 类型数据解析,可以自定义修改类型;
② AFURLResponseSerialization
协议只有一个方法 - responseObjectForResponse:data:error:
即解析数据的方法,每个子类均实现此方法,按不同方式解析数据;
③AFJSONResponseSerializer
解析方式关键还在于常用的 [NSJSONSerialization JSONObjectWithData:data options:readingOptions error:&serializationError]
方法,另外还做了一些处理。属性 removesKeysWithNullValues
表示是否要从解析结果 JSON 中移除 NSNull 的值,调用的是 AFJSONObjectByRemovingKeysWithNullValues()
函数,此函数为递归函数。属性 acceptableContentTypes
包含了可接受的数据 MIME Type,默认为这 3 种:@"application/json", @"text/json", @"text/javascript",若服务器返回 "text/html" 类型,则无法解析,直接报错,需要手动添加上这个类型。属性 acceptableStatusCodes
为可接受的响应 status,默认为 nil,即所有 status 都会解析,若设置了此属性,则仅属性内包含的 status会被解析,否则直接报错。