AFNetworking 的核心類是 AFHTTPSessionManager截珍，負(fù)責(zé)各種 HTTP 請求的發(fā)起和處理，它繼承自 AFURLSessionManager珊泳，是各種請求的直接執(zhí)行者焕盟。
1. AFHTTPSessionManager的初始化
初始化方法主要接收 baseURL 和 sessionConfiguration 兩個參數(shù)夜畴。
其中對于 baseURL，初始化方法進(jìn)行了如下判斷
if ([[url path] length] > 0 && ![[url absoluteString] hasSuffix:@"/"]) {
url = [url URLByAppendingPathComponent:@""];
}
這樣判斷的原因是址貌，對于一個形如 "https://www.baidu.com/foo" 格式的 baseURL铐拐，如果末尾不帶正斜杠，則當(dāng)調(diào)用 URLWithString:relativeToURL: 方法练对，對諸如 "text" 的 path 添加完整路徑時遍蟋，會得到 ""https://www.baidu.com/text" 的結(jié)果，所以需要調(diào)用 URLByAppendingPathComponent螟凭，這個方法的說明講到了如果原始 url 非空字符串且末尾不帶正斜杠虚青，而新的 url 開頭也不帶正斜杠，則方法會在中間插入正斜杠赂摆。
If the original URL does not end with a forward slash and pathComponent does not begin with a forward slash, a forward slash is inserted between the two parts of the returned URL, unless the original URL is the empty string.
對于 configuration挟憔，AFHTTPSessionManager 交給了父類 AFURLSessionManager 執(zhí)行，具體操作包含如下
- (instancetype)initWithSessionConfiguration:(NSURLSessionConfiguration *)configuration {
self = [super init];
if (!self) {
return nil;
}
if (!configuration) {
configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
}
self.sessionConfiguration = configuration;
// 初始化操作隊列烟号，并設(shè)置為串行隊列
self.operationQueue = [[NSOperationQueue alloc] init];
self.operationQueue.maxConcurrentOperationCount = 1;
// 默認(rèn)的響應(yīng)序列化器為 JSON 序列化器
self.responseSerializer = [AFJSONResponseSerializer serializer];
// 初始化 SSL 所需的 securityPolicy
self.securityPolicy = [AFSecurityPolicy defaultPolicy];
#if !TARGET_OS_WATCH
self.reachabilityManager = [AFNetworkReachabilityManager sharedManager];
#endif
// task 的 id 作為 key绊谭，代理對象作為 value
self.mutableTaskDelegatesKeyedByTaskIdentifier = [[NSMutableDictionary alloc] init];
self.lock = [[NSLock alloc] init];
self.lock.name = AFURLSessionManagerLockName;
__weak typeof(self) weakSelf = self;
// 獲取所有的 task，設(shè)置一遍 delegate
[self.session getTasksWithCompletionHandler:^(NSArray *dataTasks, NSArray *uploadTasks, NSArray *downloadTasks) {
__strong typeof(weakSelf) strongSelf = weakSelf;
for (NSURLSessionDataTask *task in dataTasks) {
[strongSelf addDelegateForDataTask:task uploadProgress:nil downloadProgress:nil completionHandler:nil];
}
for (NSURLSessionUploadTask *uploadTask in uploadTasks) {
[strongSelf addDelegateForUploadTask:uploadTask progress:nil completionHandler:nil];
}
for (NSURLSessionDownloadTask *downloadTask in downloadTasks) {
[strongSelf addDelegateForDownloadTask:downloadTask progress:nil destination:nil completionHandler:nil];
}
}];
return self;
}
對于序列化器汪拥，AFHTTPSessionManager 初始化方法里也指定了默認(rèn)對象达传。
// 請求序列化器用 AFHTTPRequestSerializer，響應(yīng)序列化器用 AFJSONResponseSerializer
self.requestSerializer = [AFHTTPRequestSerializer serializer];
self.responseSerializer = [AFJSONResponseSerializer serializer];
2 一次完整的請求與響應(yīng)過程
這里以 GET 為例迫筑，發(fā)起一次 GET 請求的具體過程可以分為發(fā)起請求和處理響應(yīng)兩步宪赶，下面詳細(xì)說明。
2.1 發(fā)起請求
AFHTTPSessionManager 支持創(chuàng)建 GET脯燃、HEAD搂妻、POST、PUT辕棚、PATCH欲主、DELETE 等請求邓厕，其中 GET 請求支持以下方法發(fā)起
- (nullable NSURLSessionDataTask *)GET:(NSString *)URLString
parameters:(nullable id)parameters
success:(nullable void (^)(NSURLSessionDataTask *task, id _Nullable responseObject))success
failure:(nullable void (^)(NSURLSessionDataTask * _Nullable task, NSError *error))failure DEPRECATED_ATTRIBUTE;
- (nullable NSURLSessionDataTask *)GET:(NSString *)URLString
parameters:(nullable id)parameters
progress:(nullable void (^)(NSProgress *downloadProgress))downloadProgress
success:(nullable void (^)(NSURLSessionDataTask *task, id _Nullable responseObject))success
failure:(nullable void (^)(NSURLSessionDataTask * _Nullable task, NSError *error))failure DEPRECATED_ATTRIBUTE;
- (nullable NSURLSessionDataTask *)GET:(NSString *)URLString
parameters:(nullable id)parameters
headers:(nullable NSDictionary <NSString *, NSString *> *)headers
progress:(nullable void (^)(NSProgress *downloadProgress))downloadProgress
success:(nullable void (^)(NSURLSessionDataTask *task, id _Nullable responseObject))success
failure:(nullable void (^)(NSURLSessionDataTask * _Nullable task, NSError *error))failure;
最終調(diào)用到的方法都是第三個方法，在這個方法里 HTTPSessionManager 創(chuàng)建了一個 HTTP 類型的 dataTask扁瓢，并發(fā)起請求详恼。
- (NSURLSessionDataTask *)GET:(NSString *)URLString
parameters:(id)parameters
headers:(nullable NSDictionary <NSString *, NSString *> *)headers
progress:(void (^)(NSProgress * _Nonnull))downloadProgress
success:(void (^)(NSURLSessionDataTask * _Nonnull, id _Nullable))success
failure:(void (^)(NSURLSessionDataTask * _Nullable, NSError * _Nonnull))failure
{
NSURLSessionDataTask *dataTask = [self dataTaskWithHTTPMethod:@"GET"
URLString:URLString
parameters:parameters
headers:headers
uploadProgress:nil
downloadProgress:downloadProgress
success:success
failure:failure];
[dataTask resume];
return dataTask;
}
而在 dataTaskWithHTTPMethod 方法里，則做了以下事情
- (NSURLSessionDataTask *)dataTaskWithHTTPMethod:(NSString *)method
URLString:(NSString *)URLString
parameters:(id)parameters
headers:(NSDictionary <NSString *, NSString *> *)headers
uploadProgress:(nullable void (^)(NSProgress *uploadProgress)) uploadProgress
downloadProgress:(nullable void (^)(NSProgress *downloadProgress)) downloadProgress
success:(void (^)(NSURLSessionDataTask *, id))success
failure:(void (^)(NSURLSessionDataTask *, NSError *))failure
{
NSError *serializationError = nil;
// 1. 設(shè)置 request 屬性以及參數(shù)
NSMutableURLRequest *request = [self.requestSerializer requestWithMethod:method URLString:[[NSURL URLWithString:URLString relativeToURL:self.baseURL] absoluteString] parameters:parameters error:&serializationError];
// 2. 設(shè)置 header
for (NSString *headerField in headers.keyEnumerator) {
[request addValue:headers[headerField] forHTTPHeaderField:headerField];
}
// 3. 序列化失敗回調(diào)
if (serializationError) {
if (failure) {
dispatch_async(self.completionQueue ?: dispatch_get_main_queue(), ^{
failure(nil, serializationError);
});
}
return nil;
}
// 4. 傳給 URLSessionManager 創(chuàng)建 dataTask
__block NSURLSessionDataTask *dataTask = nil;
dataTask = [self dataTaskWithRequest:request
uploadProgress:uploadProgress
downloadProgress:downloadProgress
completionHandler:^(NSURLResponse * __unused response, id responseObject, NSError *error) {
if (error) {
if (failure) {
failure(dataTask, error);
}
} else {
if (success) {
success(dataTask, responseObject);
}
}
}];
return dataTask;
}
2.1.1 設(shè)置 request 屬性以及參數(shù)
requestWithMethod:URLString:parameters:error: 方法主要做了創(chuàng)建和配置 Request 的工作引几，具體來說包括
- 利用 url 創(chuàng)建 NSMutableURLRequest
- 設(shè)置 HTTPMethod
- 設(shè)置 request 的 allowsCellularAccess昧互、cachePolicy、HTTPShouldHandleCookies伟桅、HTTPShouldUsePipelining敞掘、networkServiceType、timeoutInterval等屬性
- 對參數(shù)編碼后加入到 url 或者 body 中
其中能設(shè)置的 request 具體作用如下
- allowsCellularAccess 是否允許使用服務(wù)商蜂窩網(wǎng)絡(luò)
- cachePolicy 緩存策略枚舉
- NSURLRequestUseProtocolCachePolicy = 0 默認(rèn)的緩存策略贿讹， 如果緩存不存在渐逃，直接從服務(wù)端獲取。如果緩存存在民褂，會根據(jù) response 中的 Cache-Control 字段判斷下一步操作茄菊，如: Cache-Control 字段為 must-revalidata, 則詢問服務(wù)端該數(shù)據(jù)是否有更新，無更新的話直接返回給用戶緩存數(shù)據(jù)赊堪，若已更新面殖，則請求服務(wù)端
- NSURLRequestReloadIgnoringLocalCacheData = 1 忽略本地緩存數(shù)據(jù)，直接請求服務(wù)端
- NSURLRequestReloadIgnoringLocalAndRemoteCacheData = 4 未實現(xiàn)哭廉，忽略本地緩存脊僚，代理服務(wù)器以及其他中介，直接請求源服務(wù)端
- NSURLRequestReloadIgnoringCacheData = NSURLRequestReloadIgnoringLocalCacheData 忽略本地緩存數(shù)據(jù)遵绰，直接請求服務(wù)端
- NSURLRequestReturnCacheDataElseLoad = 2 有緩存就使用辽幌，不管其有效性(即忽略 Cache-Control 字段), 無則請求服務(wù)端
- NSURLRequestReturnCacheDataDontLoad = 3 只加載本地緩存. 沒有就失敗(確定當(dāng)前無網(wǎng)絡(luò)時使用)
- NSURLRequestReloadRevalidatingCacheData = 5 未實現(xiàn)，緩存數(shù)據(jù)必須得得到服務(wù)端確認(rèn)有效才使用
- HTTPShouldHandleCookies 設(shè)置發(fā)送請求時是否發(fā)送cookie數(shù)據(jù)
- HTTPShouldUsePipelining 設(shè)置請求時是否按順序收發(fā) 默認(rèn)禁用 在某些服務(wù)器中設(shè)為YES可以提高網(wǎng)絡(luò)性能
- networkServiceType 網(wǎng)絡(luò)請求的服務(wù)類型
- NSURLNetworkServiceTypeDefault = 0 普通網(wǎng)絡(luò)傳輸椿访，默認(rèn)使用這個
- NSURLNetworkServiceTypeVoIP = 1 網(wǎng)絡(luò)語音通信傳輸乌企，只能在VoIP使用
- NSURLNetworkServiceTypeVideo = 2 影像傳輸
- NSURLNetworkServiceTypeBackground = 3 網(wǎng)絡(luò)后臺傳輸，優(yōu)先級不高時可使用成玫。對用戶不需要的網(wǎng)絡(luò)操作可使用
- NSURLNetworkServiceTypeVoice = 4 語音傳輸
- timeoutInterval 請求超時時間
具體到 AFNetworking 中加酵，是利用了 KVO 特性，將一系列 set 方法手動觸發(fā) KVO哭当，然后對于觸發(fā)過設(shè)置方法的屬性猪腕，均加入到了mutableObservedChangedKeyPaths 集合中，創(chuàng)建 request 時會針對設(shè)置過的屬性钦勘，設(shè)置相對應(yīng)的屬性
for (NSString *keyPath in AFHTTPRequestSerializerObservedKeyPaths()) {
// 只有設(shè)置過此屬性陋葡，才會觸發(fā) KVO，mutableObservedChangedKeyPaths 這個 set 里才有此屬性
if ([self.mutableObservedChangedKeyPaths containsObject:keyPath]) {
[mutableRequest setValue:[self valueForKeyPath:keyPath] forKey:keyPath];
}
}
2.1.2 對參數(shù)編碼
編碼參數(shù)用到了 AFURLRequestSerialization 協(xié)議類的 requestBySerializingRequest:withParameters:error: 方法彻采，而 HTTPSessionManager 用到的 AFHTTPRequestSerializer 則實現(xiàn)了此方法脖岛，主要做了幾件事
- 沒有設(shè)置過相關(guān)必要的 header 字段朵栖，則設(shè)置成默認(rèn)值
- 編碼 query 參數(shù)
- 針對 HTTPMethod，將參數(shù)放入到 url 或 body 里
首先是設(shè)置一些默認(rèn) header柴梆，目前包含以下兩個鍵值對
{
"Accept-Language" = "en;q=1";
"User-Agent" = "iOS Example/1.0 (iPhone; iOS 11.3; Scale/3.00)";
}
其次是編碼 query，AFNetworking 接受的字典類型的參數(shù)作為編碼 query 的數(shù)據(jù)终惑，編碼過程如下
NSString *query = nil;
if (parameters) {
if (self.queryStringSerialization) {
NSError *serializationError;
query = self.queryStringSerialization(request, parameters, &serializationError);
if (serializationError) {
if (error) {
*error = serializationError;
}
return nil;
}
} else {
switch (self.queryStringSerializationStyle) {
case AFHTTPRequestQueryStringDefaultStyle:
// 序列化 query 參數(shù)
query = AFQueryStringFromParameters(parameters);
break;
}
}
}
可以看到這里提供了一個 block 參數(shù) queryStringSerialization绍在，它可以支持外部設(shè)置，從而將編碼序列化工作交給外部處理雹有。AFNetworking 內(nèi)部則使用了 AFQueryStringFromParameters 方法來編碼參數(shù)偿渡，下面是它的實現(xiàn)
NSString * AFQueryStringFromParameters(NSDictionary *parameters) {
NSMutableArray *mutablePairs = [NSMutableArray array];
for (AFQueryStringPair *pair in AFQueryStringPairsFromDictionary(parameters)) {
// 將字典參數(shù)打平成一層AFQueryStringPair，進(jìn)行url編碼后霸奕，放入數(shù)組
[mutablePairs addObject:[pair URLEncodedStringValue]];
}
return [mutablePairs componentsJoinedByString:@"&"];
}
NSArray * AFQueryStringPairsFromDictionary(NSDictionary *dictionary) {
return AFQueryStringPairsFromKeyAndValue(nil, dictionary);
}
NSArray * AFQueryStringPairsFromKeyAndValue(NSString *key, id value) {
NSMutableArray *mutableQueryStringComponents = [NSMutableArray array];
// 按照 description 正序排序
NSSortDescriptor *sortDescriptor = [NSSortDescriptor sortDescriptorWithKey:@"description" ascending:YES selector:@selector(compare:)];
if ([value isKindOfClass:[NSDictionary class]]) {
NSDictionary *dictionary = value;
// Sort dictionary keys to ensure consistent ordering in query string, which is important when deserializing potentially ambiguous sequences, such as an array of dictionaries
for (id nestedKey in [dictionary.allKeys sortedArrayUsingDescriptors:@[ sortDescriptor ]]) {
id nestedValue = dictionary[nestedKey];
if (nestedValue) {
// 字典類型的參數(shù)溜宽，需要轉(zhuǎn)為 dicName[key] = value 形式
[mutableQueryStringComponents addObjectsFromArray:AFQueryStringPairsFromKeyAndValue((key ? [NSString stringWithFormat:@"%@[%@]", key, nestedKey] : nestedKey), nestedValue)];
}
}
} else if ([value isKindOfClass:[NSArray class]]) {
NSArray *array = value;
for (id nestedValue in array) {
// 數(shù)組類型的參數(shù)，需要轉(zhuǎn)為 arrayName[] = value 形式
[mutableQueryStringComponents addObjectsFromArray:AFQueryStringPairsFromKeyAndValue([NSString stringWithFormat:@"%@[]", key], nestedValue)];
}
} else if ([value isKindOfClass:[NSSet class]]) {
NSSet *set = value;
for (id obj in [set sortedArrayUsingDescriptors:@[ sortDescriptor ]]) {
// 集合類型的參數(shù)质帅，直接取出元素添加到 query
[mutableQueryStringComponents addObjectsFromArray:AFQueryStringPairsFromKeyAndValue(key, obj)];
}
} else {
// 最終遍歷到字符串類型參數(shù)截止
[mutableQueryStringComponents addObject:[[AFQueryStringPair alloc] initWithField:key value:value]];
}
return mutableQueryStringComponents;
}
通過深度優(yōu)先遍歷适揉，將字典內(nèi)所有元素均轉(zhuǎn)化為 AFQueryStringPair 對象后，每個對象調(diào)用自身的 URLEncodedStringValue 方法煤惩，實現(xiàn)編碼
- (NSString *)URLEncodedStringValue {
if (!self.value || [self.value isEqual:[NSNull null]]) {
return AFPercentEscapedStringFromString([self.field description]);
} else {
return [NSString stringWithFormat:@"%@=%@", AFPercentEscapedStringFromString([self.field description]), AFPercentEscapedStringFromString([self.value description])];
}
}
而這里具體編碼工作是由 AFPercentEscapedStringFromString 方法完成嫉嘀，在這個方法里，AFNetworking 首先將系統(tǒng)提供的 URLQueryAllowedCharacterSet 集合中的 #[] 三個字符去除了魄揉，意味著這三個字符也需要參與編碼剪侮。然后以每 50 個字符為一個單元，調(diào)用 stringByAddingPercentEncodingWithAllowedCharacters 方法進(jìn)行編碼處理洛退。
為了避免對完整的 emoji 進(jìn)行錯誤的截斷瓣俯，這里還用到了 rangeOfComposedCharacterSequencesForRange 方法獲取完整的子字符串，而不是 substringToIndex 方法獲取字符串兵怯。
編碼后的字符彩匕，通過 & 字符連接起來后，就將被加入到 request 中摇零，其中對于 GET推掸、HEAD、DELETE 方法驻仅，也就是 HTTPMethodsEncodingParametersInURI 屬性包含的方法谅畅，需要將參數(shù)補(bǔ)到 url 末尾，而對于其他方法噪服，則直接加入到 body 中
if ([self.HTTPMethodsEncodingParametersInURI containsObject:[[request HTTPMethod] uppercaseString]]) {
if (query && query.length > 0) {
// url 有 query 和無 query 時需要區(qū)別處理
mutableRequest.URL = [NSURL URLWithString:[[mutableRequest.URL absoluteString] stringByAppendingFormat:mutableRequest.URL.query ? @"&%@" : @"?%@", query]];
}
} else {
// #2864: an empty string is a valid x-www-form-urlencoded payload
if (!query) {
query = @"";
}
// request 沒設(shè)置 Content-Type 時毡泻，設(shè)置為默認(rèn)的 application/x-www-form-urlencoded
if (![mutableRequest valueForHTTPHeaderField:@"Content-Type"]) {
[mutableRequest setValue:@"application/x-www-form-urlencoded" forHTTPHeaderField:@"Content-Type"];
}
[mutableRequest setHTTPBody:[query dataUsingEncoding:self.stringEncoding]];
}
2.1.3 設(shè)置 header
設(shè)置 header 就是遍歷傳入的 headers 字典，加入到 request 的 headerField 中即可粘优。
2.1.4 序列化失敗回調(diào)
對于序列化過程中出現(xiàn)的錯誤仇味，實際上就是 queryStringSerialization 外部編碼出現(xiàn)的錯誤可以走 failure 回調(diào)呻顽，結(jié)束此次請求。
2.1.5 傳給 URLSessionManager 創(chuàng)建 dataTask
URLSessionManager 持有了創(chuàng)建 dataTask 所需的 NSURLSession 對象丹墨，因此需要最后由 URLSessionManager 創(chuàng)建對應(yīng)的 task廊遍，它所做的工作如下
__block NSURLSessionDataTask *dataTask = nil;
url_session_manager_create_task_safely(^{
// 利用 request 創(chuàng)建一個 dataTask
dataTask = [self.session dataTaskWithRequest:request];
});
[self addDelegateForDataTask:dataTask uploadProgress:uploadProgressBlock downloadProgress:downloadProgressBlock completionHandler:completionHandler];
return dataTask;
除了創(chuàng)建 task 以外，URLSessionManager 需要對每一個 task 設(shè)置它的代理對象贩挣，具體在 addDelegateForDataTask 方法里喉前，這個方法的實現(xiàn)如下
// 創(chuàng)建代理對象
AFURLSessionManagerTaskDelegate *delegate = [[AFURLSessionManagerTaskDelegate alloc] initWithTask:dataTask];
delegate.manager = self;
// 傳入回調(diào)
delegate.completionHandler = completionHandler;
dataTask.taskDescription = self.taskDescriptionForSessionTasks;
// 將 task 與其代理對象的鍵值對加入到 mutableTaskDelegatesKeyedByTaskIdentifier
// 并監(jiān)聽 task 啟動和掛起通知
[self setDelegate:delegate forTask:dataTask];
// 設(shè)置進(jìn)度回調(diào)
delegate.uploadProgressBlock = uploadProgressBlock;
delegate.downloadProgressBlock = downloadProgressBlock;
可以看到 URLSessionManager 對象其實并未細(xì)致到每一個 task 進(jìn)行控制和處理，更多是對 task 的匯聚和管理王财，具體的回調(diào)卵迂、更新、異常處理都在每一個 task 對應(yīng)的代理對象中實現(xiàn)绒净。
2.2 處理響應(yīng)
AFNetworking 3.0 內(nèi)部使用的網(wǎng)絡(luò) API 是 URLSession见咒，它有一系列的回調(diào)方法，涵蓋 SSL 建立挂疆、發(fā)送數(shù)據(jù)改览、收到響應(yīng)行、收到響應(yīng)實體囱嫩、異常處理和結(jié)束請求等關(guān)鍵過程恃疯，具體又分為以下幾個協(xié)議類
- NSURLSessionDelegate : session-level 的代理方法
- NSURLSessionTaskDelegate : task-level 面向 all 的代理方法
- NSURLSessionDataDelegate : task-level 面向 data 和 upload 的代理方法
- NSURLSessionDownloadDelegate : task-level 面向 download 的代理方法
- NSURLSessionStreamDelegate : task-level 面向 stream 的代理方法
2.2.1 接收數(shù)據(jù)
GET 請求主要關(guān)注 NSURLSessionDataDelegate 方法，當(dāng)收到數(shù)據(jù)時墨闲，系統(tǒng)會回調(diào) URLSessionManager 的 URLSession:dataTask:didReceiveData: 方法今妄，原因是初始化 URLSessionManager 時，session 的代理對象設(shè)置的就是 URLSessionManager鸳碧。
這個方法的實現(xiàn)很簡單盾鳞，主要做了以下工作
- 回調(diào)此事件給 task 的代理對象
- 回調(diào) dataTaskDidReceiveData block
具體如下
{
// 查找 task 對應(yīng)的 delegate
AFURLSessionManagerTaskDelegate *delegate = [self delegateForTask:dataTask];
// 回調(diào)給代理對象同名方法
[delegate URLSession:session dataTask:dataTask didReceiveData:data];
// manager 類統(tǒng)一回調(diào)
if (self.dataTaskDidReceiveData) {
self.dataTaskDidReceiveData(session, dataTask, data);
}
}
而對于每一個 task 的代理對象 AFURLSessionManagerTaskDelegate 類，也要實現(xiàn)一個同名方法瞻离，這個方法具體做的事情是將收到的數(shù)據(jù)匯聚到一個 NSData 中
{
self.downloadProgress.totalUnitCount = dataTask.countOfBytesExpectedToReceive;
self.downloadProgress.completedUnitCount = dataTask.countOfBytesReceived;
[self.mutableData appendData:data];
}
2.2.2 完成響應(yīng)
這里就有兩個問題了腾仅，其一是每一個 task 總會結(jié)束，結(jié)束后它的代理對象也就沒有意義需要銷毀套利，其二是推励，數(shù)據(jù)何時才能結(jié)束添加并最終回調(diào)給調(diào)用者。其實這些都在 NSURLSessionTaskDelegate 協(xié)議的 URLSession:task:didCompleteWithError: 中肉迫，仍然像上面一樣验辞，首先系統(tǒng)會回調(diào)到 URLSessionManager 中，在這里 Manager 找到 task 的代理對象喊衫，調(diào)用它的同名方法
{
// 獲取代理對象
AFURLSessionManagerTaskDelegate *delegate = [self delegateForTask:task];
// delegate may be nil when completing a task in the background
if (delegate) {
// 回調(diào)同名方法
[delegate URLSession:session task:task didCompleteWithError:error];
// 從 mutableTaskDelegatesKeyedByTaskIdentifier 移除task的代理對象跌造，同時銷毀對 task 的監(jiān)聽
[self removeDelegateForTask:task];
}
// 統(tǒng)一回調(diào)
if (self.taskDidComplete) {
self.taskDidComplete(session, task, error);
}
}
而在 AFURLSessionManagerTaskDelegate 的同名方法里則完成了數(shù)據(jù)的解析、序列化和回調(diào)族购，主要來說有以下工作
- 對系統(tǒng)回調(diào)返回的 error 走異常處理壳贪，此時 responseObject 為 nil
- 對響應(yīng)中的二進(jìn)制數(shù)據(jù)進(jìn)行序列化操作陵珍，默認(rèn)通過 AFJSONResponseSerializer 進(jìn)行序列化
- 回調(diào)到網(wǎng)絡(luò)請求方
2.2.3 序列化操作
這里主要看一下序列化 response 的操作，AFHTTPSessionManager 默認(rèn)使用的序列化類是 AFJSONResponseSerializer违施，除此之外還有 AFHTTPResponseSerializer互纯、AFXMLParserResponseSerializer、AFXMLDocumentResponseSerializer醉拓、AFPropertyListResponseSerializer伟姐、AFImageResponseSerializer 等序列化器。
下面分析幾個主要的序列化器的內(nèi)部邏輯亿卤。
2.2.3.1 AFJSONResponseSerializer
序列化的核心方法是 responseObjectForResponse:data:error: ，這個方法由 AFURLResponseSerialization 協(xié)議類定義鹿霸，AFJSONResponseSerializer 的實現(xiàn)做了如下工作
- 驗證合法性
- 調(diào)用 NSJSONSerialization 轉(zhuǎn)化為 JSON 對象
- 去除值為 NSNULL 的情況（可選）
驗證合法性這一步排吴，AFJSONResponseSerializer 用到了它的父類 AFHTTPResponseSerializer 定義的 validateResponse:data:error: 方法，這個方法主要檢查
- MIMEType 是否在 AFHTTPResponseSerializer 定義的 acceptableContentTypes 中懦鼠，不同的序列化器包含了不同的 MTMEType钻哩，對于 AFJSONResponseSerializer，包含以下類型application/json肛冶、text/json街氢、text/javascript
- 狀態(tài)碼在 acceptableStatusCodes 中，即 200-299
驗證合法性結(jié)束后就調(diào)用 NSJSONSerialization 的 + (nullable id)JSONObjectWithData:(NSData *)data options:(NSJSONReadingOptions)opt error:(NSError **)error; 方法睦袖，將數(shù)據(jù)轉(zhuǎn)為 JSON 對象珊肃，可能是字典或者數(shù)組。如果外部設(shè)置了 removesKeysWithNullValues馅笙，即代表需要將 value 為 NSNULL 的鍵值對去除伦乔，這一步操作在 AFJSONObjectByRemovingKeysWithNullValues 方法中實現(xiàn)。
2.2.3.2 AFHTTPResponseSerializer
作為父類董习，AFHTTPResponseSerializer 的序列化操作僅僅檢查了合法性就直接返回數(shù)據(jù)了
- (id)responseObjectForResponse:(NSURLResponse *)response
data:(NSData *)data
error:(NSError *__autoreleasing *)error
{
[self validateResponse:(NSHTTPURLResponse *)response data:data error:error];
return data;
}
同時烈和，它的 acceptableContentTypes 為 nil。
2.2.3.3 AFXMLParserResponseSerializer
AFXMLParserResponseSerializer 接受 "application/xml" 及 "text/xml" 類型的 MIMEType皿淋，它的序列化過程主要調(diào)用如下方法
[[NSXMLParser alloc] initWithData:data];
2.2.3.4 AFXMLDocumentResponseSerializer
AFXMLDocumentResponseSerializer 接受 "application/xml" 及 "text/xml" 類型的 MIMEType招刹，它的序列化過程主要調(diào)用如下方法
NSError *serializationError = nil;
NSXMLDocument *document = [[NSXMLDocument alloc] initWithData:data options:self.options error:&serializationError];
2.2.3.5 AFPropertyListResponseSerializer
AFPropertyListResponseSerializer 接受 "application/x-plist" 類型的 MIMEType，它的序列化過程主要調(diào)用如下方法
NSError *serializationError = nil;
id responseObject = [NSPropertyListSerialization propertyListWithData:data options:self.readOptions format:NULL error:&serializationError];
2.2.3.6 AFImageResponseSerializer
AFImageResponseSerializer 定義了許多與圖片相關(guān) MIMEType窝趣，包括 "image/tiff", "image/jpeg", "image/gif", "image/png", "image/ico", "image/x-icon", "image/bmp", "image/x-bmp", "image/x-xbitmap", "image/x-win-bitmap" 等等疯暑。
圖片序列化的過程如果細(xì)分會很復(fù)雜，這里簡單概括一下如下
- 驗證合法性
- 是否自動解碼高帖，需要自動解碼則通過 CGContextDrawImage 解碼圖片
- 返回圖片
2.2.3.7 AFCompoundResponseSerializer
AFCompoundResponseSerializer 是一個混合序列化器缰儿，它接受一系列的序列化器，當(dāng)收到 response 時散址，一個一個去嘗試能否解析出最終結(jié)果乖阵，如果都無法解析宣赔，則會調(diào)用到 AFHTTPResponseSerializer 的默認(rèn)實現(xiàn)。
