AFNetworking(一)從一次請求了解AFHTTPSessionManager

AFNetworking 的核心類是 AFHTTPSessionManager,負責各種 HTTP 請求的發起和處理,它繼承自 AFURLSessionManager,是各種請求的直接執行者。

1. AFHTTPSessionManager的初始化

初始化方法主要接收 baseURL 和 sessionConfiguration 兩個參數。

其中對于 baseURL,初始化方法進行了如下判斷

    if ([[url path] length] > 0 && ![[url absoluteString] hasSuffix:@"/"]) {
        url = [url URLByAppendingPathComponent:@""];
    }

這樣判斷的原因是,對于一個形如 "https://www.baidu.com/foo" 格式的 baseURL,如果末尾不帶正斜杠,則當調用 URLWithString:relativeToURL: 方法,對諸如 "text" 的 path 添加完整路徑時,會得到 ""https://www.baidu.com/text" 的結果,所以需要調用 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 執行,具體操作包含如下

- (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;

    // 默認的響應序列化器為 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,設置一遍 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 初始化方法里也指定了默認對象。

// 請求序列化器用 AFHTTPRequestSerializer,響應序列化器用 AFJSONResponseSerializer
    self.requestSerializer = [AFHTTPRequestSerializer serializer];
    self.responseSerializer = [AFJSONResponseSerializer serializer];

2 一次完整的請求與響應過程

這里以 GET 為例,發起一次 GET 請求的具體過程可以分為發起請求和處理響應兩步,下面詳細說明。

2.1 發起請求

AFHTTPSessionManager 支持創建 GET、HEAD、POST、PUT、PATCH、DELETE 等請求,其中 GET 請求支持以下方法發起

- (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;

最終調用到的方法都是第三個方法,在這個方法里 HTTPSessionManager 創建了一個 HTTP 類型的 dataTask,并發起請求。

- (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. 設置 request 屬性以及參數
    NSMutableURLRequest *request = [self.requestSerializer requestWithMethod:method URLString:[[NSURL URLWithString:URLString relativeToURL:self.baseURL] absoluteString] parameters:parameters error:&serializationError];
    // 2. 設置 header
    for (NSString *headerField in headers.keyEnumerator) {
        [request addValue:headers[headerField] forHTTPHeaderField:headerField];
    }
    // 3. 序列化失敗回調
    if (serializationError) {
        if (failure) {
            dispatch_async(self.completionQueue ?: dispatch_get_main_queue(), ^{
                failure(nil, serializationError);
            });
        }
        
        return nil;
    }
    
    // 4. 傳給 URLSessionManager 創建 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 設置 request 屬性以及參數

requestWithMethod:URLString:parameters:error: 方法主要做了創建和配置 Request 的工作,具體來說包括

  • 利用 url 創建 NSMutableURLRequest
  • 設置 HTTPMethod
  • 設置 request 的 allowsCellularAccess、cachePolicy、HTTPShouldHandleCookies、HTTPShouldUsePipelining、networkServiceType、timeoutInterval等屬性
  • 對參數編碼后加入到 url 或者 body 中

其中能設置的 request 具體作用如下

  • allowsCellularAccess 是否允許使用服務商蜂窩網絡
  • cachePolicy 緩存策略枚舉
    • NSURLRequestUseProtocolCachePolicy = 0 默認的緩存策略, 如果緩存不存在,直接從服務端獲取。如果緩存存在,會根據 response 中的 Cache-Control 字段判斷下一步操作,如: Cache-Control 字段為 must-revalidata, 則詢問服務端該數據是否有更新,無更新的話直接返回給用戶緩存數據,若已更新,則請求服務端
    • NSURLRequestReloadIgnoringLocalCacheData = 1 忽略本地緩存數據,直接請求服務端
    • NSURLRequestReloadIgnoringLocalAndRemoteCacheData = 4 未實現,忽略本地緩存,代理服務器以及其他中介,直接請求源服務端
    • NSURLRequestReloadIgnoringCacheData = NSURLRequestReloadIgnoringLocalCacheData 忽略本地緩存數據,直接請求服務端
    • NSURLRequestReturnCacheDataElseLoad = 2 有緩存就使用,不管其有效性(即忽略 Cache-Control 字段), 無則請求服務端
    • NSURLRequestReturnCacheDataDontLoad = 3 只加載本地緩存. 沒有就失敗(確定當前無網絡時使用)
    • NSURLRequestReloadRevalidatingCacheData = 5 未實現,緩存數據必須得得到服務端確認有效才使用
  • HTTPShouldHandleCookies 設置發送請求時是否發送cookie數據
  • HTTPShouldUsePipelining 設置請求時是否按順序收發 默認禁用 在某些服務器中設為YES可以提高網絡性能
  • networkServiceType 網絡請求的服務類型
    • NSURLNetworkServiceTypeDefault = 0 普通網絡傳輸,默認使用這個
    • NSURLNetworkServiceTypeVoIP = 1 網絡語音通信傳輸,只能在VoIP使用
    • NSURLNetworkServiceTypeVideo = 2 影像傳輸
    • NSURLNetworkServiceTypeBackground = 3 網絡后臺傳輸,優先級不高時可使用。對用戶不需要的網絡操作可使用
    • NSURLNetworkServiceTypeVoice = 4 語音傳輸
  • timeoutInterval 請求超時時間

具體到 AFNetworking 中,是利用了 KVO 特性,將一系列 set 方法手動觸發 KVO,然后對于觸發過設置方法的屬性,均加入到了mutableObservedChangedKeyPaths 集合中,創建 request 時會針對設置過的屬性,設置相對應的屬性

    for (NSString *keyPath in AFHTTPRequestSerializerObservedKeyPaths()) {
        // 只有設置過此屬性,才會觸發 KVO,mutableObservedChangedKeyPaths 這個 set 里才有此屬性
        if ([self.mutableObservedChangedKeyPaths containsObject:keyPath]) {
            [mutableRequest setValue:[self valueForKeyPath:keyPath] forKey:keyPath];
        }
    }

2.1.2 對參數編碼

編碼參數用到了 AFURLRequestSerialization 協議類的 requestBySerializingRequest:withParameters:error: 方法,而 HTTPSessionManager 用到的 AFHTTPRequestSerializer 則實現了此方法,主要做了幾件事

  • 沒有設置過相關必要的 header 字段,則設置成默認值
  • 編碼 query 參數
  • 針對 HTTPMethod,將參數放入到 url 或 body 里

首先是設置一些默認 header,目前包含以下兩個鍵值對

{
    "Accept-Language" = "en;q=1";
    "User-Agent" = "iOS Example/1.0 (iPhone; iOS 11.3; Scale/3.00)";
}

其次是編碼 query,AFNetworking 接受的字典類型的參數作為編碼 query 的數據,編碼過程如下

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 參數
                    query = AFQueryStringFromParameters(parameters);
                    break;
            }
        }
    }

可以看到這里提供了一個 block 參數 queryStringSerialization,它可以支持外部設置,從而將編碼序列化工作交給外部處理。AFNetworking 內部則使用了 AFQueryStringFromParameters 方法來編碼參數,下面是它的實現

NSString * AFQueryStringFromParameters(NSDictionary *parameters) {
    NSMutableArray *mutablePairs = [NSMutableArray array];
    for (AFQueryStringPair *pair in AFQueryStringPairsFromDictionary(parameters)) {
        // 將字典參數打平成一層AFQueryStringPair,進行url編碼后,放入數組
        [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) {
                // 字典類型的參數,需要轉為 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) {
            // 數組類型的參數,需要轉為 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 ]]) {
            // 集合類型的參數,直接取出元素添加到 query
            [mutableQueryStringComponents addObjectsFromArray:AFQueryStringPairsFromKeyAndValue(key, obj)];
        }
    } else {
        // 最終遍歷到字符串類型參數截止
        [mutableQueryStringComponents addObject:[[AFQueryStringPair alloc] initWithField:key value:value]];
    }

    return mutableQueryStringComponents;
}

通過深度優先遍歷,將字典內所有元素均轉化為 AFQueryStringPair 對象后,每個對象調用自身的 URLEncodedStringValue 方法,實現編碼

- (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 首先將系統提供的 URLQueryAllowedCharacterSet 集合中的 #[] 三個字符去除了,意味著這三個字符也需要參與編碼。然后以每 50 個字符為一個單元,調用 stringByAddingPercentEncodingWithAllowedCharacters 方法進行編碼處理。

為了避免對完整的 emoji 進行錯誤的截斷,這里還用到了 rangeOfComposedCharacterSequencesForRange 方法獲取完整的子字符串,而不是 substringToIndex 方法獲取字符串。

編碼后的字符,通過 & 字符連接起來后,就將被加入到 request 中,其中對于 GET、HEAD、DELETE 方法,也就是 HTTPMethodsEncodingParametersInURI 屬性包含的方法,需要將參數補到 url 末尾,而對于其他方法,則直接加入到 body 中

    if ([self.HTTPMethodsEncodingParametersInURI containsObject:[[request HTTPMethod] uppercaseString]]) {
        if (query && query.length > 0) {
            // url 有 query 和無 query 時需要區別處理
            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 沒設置 Content-Type 時,設置為默認的 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 設置 header

設置 header 就是遍歷傳入的 headers 字典,加入到 request 的 headerField 中即可。

2.1.4 序列化失敗回調

對于序列化過程中出現的錯誤,實際上就是 queryStringSerialization 外部編碼出現的錯誤可以走 failure 回調,結束此次請求。

2.1.5 傳給 URLSessionManager 創建 dataTask

URLSessionManager 持有了創建 dataTask 所需的 NSURLSession 對象,因此需要最后由 URLSessionManager 創建對應的 task,它所做的工作如下

    __block NSURLSessionDataTask *dataTask = nil;
    url_session_manager_create_task_safely(^{
        // 利用 request 創建一個 dataTask
        dataTask = [self.session dataTaskWithRequest:request];
    });

    [self addDelegateForDataTask:dataTask uploadProgress:uploadProgressBlock downloadProgress:downloadProgressBlock completionHandler:completionHandler];

    return dataTask;

除了創建 task 以外,URLSessionManager 需要對每一個 task 設置它的代理對象,具體在 addDelegateForDataTask 方法里,這個方法的實現如下

    // 創建代理對象
    AFURLSessionManagerTaskDelegate *delegate = [[AFURLSessionManagerTaskDelegate alloc] initWithTask:dataTask];
    delegate.manager = self;
    // 傳入回調
    delegate.completionHandler = completionHandler;

    dataTask.taskDescription = self.taskDescriptionForSessionTasks;
    // 將 task 與其代理對象的鍵值對加入到 mutableTaskDelegatesKeyedByTaskIdentifier
    // 并監聽 task 啟動和掛起通知
    [self setDelegate:delegate forTask:dataTask];

    // 設置進度回調
    delegate.uploadProgressBlock = uploadProgressBlock;
    delegate.downloadProgressBlock = downloadProgressBlock;

可以看到 URLSessionManager 對象其實并未細致到每一個 task 進行控制和處理,更多是對 task 的匯聚和管理,具體的回調、更新、異常處理都在每一個 task 對應的代理對象中實現。

2.2 處理響應

AFNetworking 3.0 內部使用的網絡 API 是 URLSession,它有一系列的回調方法,涵蓋 SSL 建立、發送數據、收到響應行、收到響應實體、異常處理和結束請求等關鍵過程,具體又分為以下幾個協議類

  • NSURLSessionDelegate : session-level 的代理方法
  • NSURLSessionTaskDelegate : task-level 面向 all 的代理方法
  • NSURLSessionDataDelegate : task-level 面向 data 和 upload 的代理方法
  • NSURLSessionDownloadDelegate : task-level 面向 download 的代理方法
  • NSURLSessionStreamDelegate : task-level 面向 stream 的代理方法

2.2.1 接收數據

GET 請求主要關注 NSURLSessionDataDelegate 方法,當收到數據時,系統會回調 URLSessionManager 的 URLSession:dataTask:didReceiveData: 方法,原因是初始化 URLSessionManager 時,session 的代理對象設置的就是 URLSessionManager。

這個方法的實現很簡單,主要做了以下工作

  • 回調此事件給 task 的代理對象
  • 回調 dataTaskDidReceiveData block

具體如下

{
    // 查找 task 對應的 delegate
    AFURLSessionManagerTaskDelegate *delegate = [self delegateForTask:dataTask];
    // 回調給代理對象同名方法
    [delegate URLSession:session dataTask:dataTask didReceiveData:data];

    // manager 類統一回調
    if (self.dataTaskDidReceiveData) {
        self.dataTaskDidReceiveData(session, dataTask, data);
    }
}

而對于每一個 task 的代理對象 AFURLSessionManagerTaskDelegate 類,也要實現一個同名方法,這個方法具體做的事情是將收到的數據匯聚到一個 NSData 中

{
    self.downloadProgress.totalUnitCount = dataTask.countOfBytesExpectedToReceive;
    self.downloadProgress.completedUnitCount = dataTask.countOfBytesReceived;

    [self.mutableData appendData:data];
}

2.2.2 完成響應

這里就有兩個問題了,其一是每一個 task 總會結束,結束后它的代理對象也就沒有意義需要銷毀,其二是,數據何時才能結束添加并最終回調給調用者。其實這些都在 NSURLSessionTaskDelegate 協議的 URLSession:task:didCompleteWithError: 中,仍然像上面一樣,首先系統會回調到 URLSessionManager 中,在這里 Manager 找到 task 的代理對象,調用它的同名方法

{
    // 獲取代理對象
    AFURLSessionManagerTaskDelegate *delegate = [self delegateForTask:task];

    // delegate may be nil when completing a task in the background
    if (delegate) {
        // 回調同名方法
        [delegate URLSession:session task:task didCompleteWithError:error];

        // 從 mutableTaskDelegatesKeyedByTaskIdentifier 移除task的代理對象,同時銷毀對 task 的監聽
        [self removeDelegateForTask:task];
    }

    // 統一回調
    if (self.taskDidComplete) {
        self.taskDidComplete(session, task, error);
    }
}

而在 AFURLSessionManagerTaskDelegate 的同名方法里則完成了數據的解析、序列化和回調,主要來說有以下工作

  • 對系統回調返回的 error 走異常處理,此時 responseObject 為 nil
  • 對響應中的二進制數據進行序列化操作,默認通過 AFJSONResponseSerializer 進行序列化
  • 回調到網絡請求方

2.2.3 序列化操作

這里主要看一下序列化 response 的操作,AFHTTPSessionManager 默認使用的序列化類是 AFJSONResponseSerializer,除此之外還有 AFHTTPResponseSerializer、AFXMLParserResponseSerializer、AFXMLDocumentResponseSerializer、AFPropertyListResponseSerializer、AFImageResponseSerializer 等序列化器。

下面分析幾個主要的序列化器的內部邏輯。

2.2.3.1 AFJSONResponseSerializer

序列化的核心方法是 responseObjectForResponse:data:error: ,這個方法由 AFURLResponseSerialization 協議類定義,AFJSONResponseSerializer 的實現做了如下工作

  • 驗證合法性
  • 調用 NSJSONSerialization 轉化為 JSON 對象
  • 去除值為 NSNULL 的情況(可選)

驗證合法性這一步,AFJSONResponseSerializer 用到了它的父類 AFHTTPResponseSerializer 定義的 validateResponse:data:error: 方法,這個方法主要檢查

  • MIMEType 是否在 AFHTTPResponseSerializer 定義的 acceptableContentTypes 中,不同的序列化器包含了不同的 MTMEType,對于 AFJSONResponseSerializer,包含以下類型application/json、text/json、text/javascript
  • 狀態碼在 acceptableStatusCodes 中,即 200-299

驗證合法性結束后就調用 NSJSONSerialization 的 + (nullable id)JSONObjectWithData:(NSData *)data options:(NSJSONReadingOptions)opt error:(NSError **)error; 方法,將數據轉為 JSON 對象,可能是字典或者數組。如果外部設置了 removesKeysWithNullValues,即代表需要將 value 為 NSNULL 的鍵值對去除,這一步操作在 AFJSONObjectByRemovingKeysWithNullValues 方法中實現。

2.2.3.2 AFHTTPResponseSerializer

作為父類,AFHTTPResponseSerializer 的序列化操作僅僅檢查了合法性就直接返回數據了

- (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,它的序列化過程主要調用如下方法

[[NSXMLParser alloc] initWithData:data];
2.2.3.4 AFXMLDocumentResponseSerializer

AFXMLDocumentResponseSerializer 接受 "application/xml" 及 "text/xml" 類型的 MIMEType,它的序列化過程主要調用如下方法

    NSError *serializationError = nil;
    NSXMLDocument *document = [[NSXMLDocument alloc] initWithData:data options:self.options error:&serializationError];
2.2.3.5 AFPropertyListResponseSerializer

AFPropertyListResponseSerializer 接受 "application/x-plist" 類型的 MIMEType,它的序列化過程主要調用如下方法

    NSError *serializationError = nil;
    
    id responseObject = [NSPropertyListSerialization propertyListWithData:data options:self.readOptions format:NULL error:&serializationError];
2.2.3.6 AFImageResponseSerializer

AFImageResponseSerializer 定義了許多與圖片相關 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" 等等。

圖片序列化的過程如果細分會很復雜,這里簡單概括一下如下

  • 驗證合法性
  • 是否自動解碼,需要自動解碼則通過 CGContextDrawImage 解碼圖片
  • 返回圖片
2.2.3.7 AFCompoundResponseSerializer

AFCompoundResponseSerializer 是一個混合序列化器,它接受一系列的序列化器,當收到 response 時,一個一個去嘗試能否解析出最終結果,如果都無法解析,則會調用到 AFHTTPResponseSerializer 的默認實現。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,505評論 6 533
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,556評論 3 418
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,463評論 0 376
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,009評論 1 312
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,778評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,218評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,281評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,436評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,969評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,795評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,993評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,537評論 5 359
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,229評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,659評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,917評論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,687評論 3 392
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,990評論 2 374

推薦閱讀更多精彩內容

  • 我們先看一下AFNetworking.h文件都給了我們什么方法 #import <Foundation/Found...
    瀟巖閱讀 637評論 0 1
  • http://liuxing.info/2017/06/30/Spring%20AMQP%E4%B8%AD%E6%...
    sherlock_6981閱讀 15,966評論 2 11
  • Swift1> Swift和OC的區別1.1> Swift沒有地址/指針的概念1.2> 泛型1.3> 類型嚴謹 對...
    cosWriter閱讀 11,121評論 1 32
  • NSURLSession AFNHTTPSessionManager AFHTTPSessionManager i...
    向著陽光奔跑的小孩閱讀 1,572評論 0 2
  • 發現 關注 消息 iOS 第三方庫、插件、知名博客總結 作者大灰狼的小綿羊哥哥關注 2017.06.26 09:4...
    肇東周閱讀 12,151評論 4 61