上一篇整理了AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];，這一篇整理AFN的重頭戲：請(qǐng)求。從[manager POST:parameters:progress:success:failure:]開(kāi)始梳理。

AFHTTPSessionManager 部分

日常開(kāi)發(fā)中請(qǐng)求主要就是GET和POST兩種

GET 和 POST 的聲明

GET聲明

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

POST聲明

- (nullable NSURLSessionDataTask *)POST:(NSString *)URLString
                             parameters:(nullable id)parameters
                               progress:(nullable void (^)(NSProgress *uploadProgress))uploadProgress
                                success:(nullable void (^)(NSURLSessionDataTask *task, id _Nullable responseObject))success
                                failure:(nullable void (^)(NSURLSessionDataTask * _Nullable task, NSError *error))failure;

GET 和 POST 的實(shí)現(xiàn)

GET實(shí)現(xiàn)

- (NSURLSessionDataTask *)GET:(NSString *)URLString
                   parameters:(id)parameters
                     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
                                                   uploadProgress:nil
                                                 downloadProgress:downloadProgress
                                                          success:success
                                                          failure:failure];

    [dataTask resume];

    return dataTask;
}

POST實(shí)現(xiàn)

- (NSURLSessionDataTask *)POST:(NSString *)URLString
                    parameters:(id)parameters
                      progress:(void (^)(NSProgress * _Nonnull))uploadProgress
                       success:(void (^)(NSURLSessionDataTask * _Nonnull, id _Nullable))success
                       failure:(void (^)(NSURLSessionDataTask * _Nullable, NSError * _Nonnull))failure
{
    NSURLSessionDataTask *dataTask = [self dataTaskWithHTTPMethod:@"POST" URLString:URLString parameters:parameters uploadProgress:uploadProgress downloadProgress:nil success:success failure:failure];

    [dataTask resume];

    return dataTask;
}

分解說(shuō)明

1. 首先要理解，AFHTTPSessionManager類的GET和POST方法內(nèi)部實(shí)現(xiàn)的核心是：調(diào)用dataTaskWithHTTPMethod:URLString:parameters:uploadProgress:downloadProgress:success:failure:方法來(lái)獲取NSURLSessionDataTask。
2. 這個(gè)NSURLSessionDataTask才是真正可以發(fā)起網(wǎng)絡(luò)請(qǐng)求的類。而開(kāi)啟請(qǐng)求的真正方法是resume，當(dāng)NSURLSessionDataTask調(diào)用了resume，網(wǎng)絡(luò)請(qǐng)求才發(fā)起。

?

GET、POST 核心方法dataTaskWithHTTPMethod:URLString:parameters:uploadProgress:downloadProgress:success:failure:

dataTaskWithHTTPMethod...的實(shí)現(xiàn)

第一部分解析

一句話描述 : 第一部分做的事情就是創(chuàng)建一個(gè)NSMutableURLRequest。

NSError *serializationError = nil;
NSMutableURLRequest *request = [self.requestSerializer requestWithMethod:method URLString:[[NSURL URLWithString:URLString relativeToURL:self.baseURL] absoluteString] parameters:parameters error:&serializationError];
if (serializationError) {
    if (failure) {
        dispatch_async(self.completionQueue ?: dispatch_get_main_queue(), ^{
            failure(nil, serializationError);
        });
    }

    return nil;
}

先說(shuō)整體邏輯

1. 第一部分創(chuàng)建的NSMutableURLRequest是要提供給第二部分使用。
2. 這個(gè)NSMutableURLRequest不是AFHTTPSessionManager類自己創(chuàng)建的，是通過(guò)自己的屬性requestSerializer調(diào)用requestWithMethod:URLString:parameters:error:方法創(chuàng)建的。如果NSMutableURLRequest創(chuàng)建失敗，則直接回調(diào)給開(kāi)發(fā)者網(wǎng)絡(luò)請(qǐng)求失敗。

分解說(shuō)明：

1. 屬性requestSerializer：requestSerializer是AFHTTPSessionManager類自己獨(dú)有的屬性，父類AFHTTPRequestSerializer沒(méi)有這個(gè)屬性。requestSerializer在AFHTTPSessionManager初始化的時(shí)候已經(jīng)默認(rèn)進(jìn)行了初始化，開(kāi)發(fā)者也可以隨時(shí)修改此屬性。初始化詳情可以參考AFNetworking主線梳理（一）中的介紹。

2. 參數(shù)completionQueue：失敗回調(diào)的隊(duì)列默認(rèn)是主隊(duì)列，如果設(shè)置了completionQueue，則走設(shè)置的隊(duì)列。completionQueue是AFHTTPSessionManager父類AFURLSessionManager的屬性，需要開(kāi)發(fā)者來(lái)設(shè)置。

?
接下來(lái)，解析requestWithMethod:URLString:parameters:error:，需要跳轉(zhuǎn)到AFHTTPRequestSerializer 部分（往下翻）。
?

第二部分解析

一句話描述：
通過(guò)調(diào)用dataTaskWithRequest:uploadProgress:downloadProgress:completionHandler:方法來(lái)創(chuàng)建一個(gè)NSURLSessionDataTask實(shí)例對(duì)象。

__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);
        }
    }
}];

?
分解說(shuō)明

1. NSURLSessionDataTask就是前面說(shuō)的GET和POST方法核心實(shí)現(xiàn)所需要的task。
2. dataTaskWithRequest:uploadProgress:downloadProgress:completionHandler:方法所需要的參數(shù)request就是第一部分創(chuàng)建的NSMutableURLRequest實(shí)例。
3. AFHTTPSessionManager自己并沒(méi)有實(shí)現(xiàn)dataTaskWithRequest:uploadProgress:downloadProgress:completionHandler:方法，是它的父類AFURLSessionManager實(shí)現(xiàn)了這個(gè)方法。

?
接下來(lái)，解析dataTaskWithRequest:uploadProgress:downloadProgress:completionHandler:方法，跳轉(zhuǎn)到AFURLSessionManager 部分（使勁往下翻）。
?

AFHTTPRequestSerializer 部分

接續(xù) GET、POST 核心方法dataTaskWithHTTPMethod 方法第一部分，AFHTTPRequestSerializer的requestWithMethod:URLString:parameters:error:方法最終目的是創(chuàng)建一個(gè)NSMutableURLRequest實(shí)例并返回。

requestWithMethod:URLString:parameters:error: 方法解析

以下簡(jiǎn)稱：requestWithMethod方法。

requestWithMethod...方法的實(shí)現(xiàn)

requestWithMethod方法整體邏輯：

1. 使用傳入的參數(shù)URLString創(chuàng)建一個(gè)NSURL *url
2. 使用url創(chuàng)建一個(gè)NSMutableURLRequest *mutableRequest
3. 將傳入的參數(shù) method 保存到 mutableRequest 的 HTTPMethod 屬性中
4. 第一部分：簡(jiǎn)單講就是在配置NSMutableURLRequest的各種參數(shù)。
5. 第二部分：簡(jiǎn)單講其實(shí)也是在配置NSMutableURLRequest的各種參數(shù)。
6. NSMutableURLRequest配置完成后，返回其實(shí)例mutableRequest。

第一部分

整體邏輯：

1. AFHTTPRequestSerializerObservedKeyPaths()函數(shù)會(huì)創(chuàng)建并返回一個(gè)數(shù)組，數(shù)組中有6個(gè)屬性名的字符串（keyPath）。
2. for in 遍歷這個(gè)數(shù)組，取出每一個(gè)屬性名的字符串（keyPath）。
3. 判斷self.mutableObservedChangedKeyPaths（一個(gè)NSMutableSet）中是否包含keyPath，如果包含這個(gè)keyPath，則把AFHTTPRequestSerializer自己這個(gè)屬性的值賦值給mutableRequest。
   

分解說(shuō)明：

1. AFHTTPRequestSerializer有6個(gè)特定的屬性，分別是：

   1. @property (nonatomic, assign) BOOL allowsCellularAccess;
   2. @property (nonatomic, assign) NSURLRequestCachePolicy cachePolicy;
   3. @property (nonatomic, assign) BOOL HTTPShouldHandleCookies;
   4. @property (nonatomic, assign) BOOL HTTPShouldUsePipelining;
   5. @property (nonatomic, assign) NSURLRequestNetworkServiceType networkServiceType;
   6. @property (nonatomic, assign) NSTimeInterval timeoutInterval;

2. 這6個(gè)屬性開(kāi)發(fā)者可以讀寫(xiě)，而這6個(gè)屬性與NSMutableURLRequest的屬性一一對(duì)應(yīng)，換句話說(shuō)AFHTTPRequestSerializer的6個(gè)屬性最終目的是開(kāi)發(fā)者設(shè)置具體值，然后傳遞給NSMutableURLRequest，只不過(guò)開(kāi)發(fā)者從設(shè)置值到mutableRequest接收到值的過(guò)程略顯復(fù)雜。

3. 在AFHTTPRequestSerializer的init方法中依次對(duì)6個(gè)屬性添加了鍵值觀察（KVO）。
   init方法片段：

- (instancetype)init {
    self = [super init];
    if (!self) {
        return nil;
    }

    ...省略...
    
    for (NSString *keyPath in AFHTTPRequestSerializerObservedKeyPaths()) {
        if ([self respondsToSelector:NSSelectorFromString(keyPath)]) {
            [self addObserver:self forKeyPath:keyPath options:NSKeyValueObservingOptionNew context:AFHTTPRequestSerializerObserverContext];
        }
    }

    return self;
}

?

4. AFHTTPRequestSerializer重寫(xiě)了每一個(gè)屬性的setter，成員變量Ivar賦值前后加了KVO的willChangeValueForKey和didChangeValueForKey來(lái)手動(dòng)觸發(fā)KVO。
   AFHTTPRequestSerializer的6個(gè)屬性的setter實(shí)現(xiàn)方式完全一致，這里只貼兩個(gè)屬性的setter源碼：

- (void)setAllowsCellularAccess:(BOOL)allowsCellularAccess {
    [self willChangeValueForKey:NSStringFromSelector(@selector(allowsCellularAccess))];
    _allowsCellularAccess = allowsCellularAccess;
    [self didChangeValueForKey:NSStringFromSelector(@selector(allowsCellularAccess))];
}

- (void)setCachePolicy:(NSURLRequestCachePolicy)cachePolicy {
    [self willChangeValueForKey:NSStringFromSelector(@selector(cachePolicy))];
    _cachePolicy = cachePolicy;
    [self didChangeValueForKey:NSStringFromSelector(@selector(cachePolicy))];
}

等等......

?

5. AFHTTPRequestSerializerObservedKeyPaths()函數(shù)：
   下的源碼就是AFHTTPRequestSerializerObservedKeyPaths()函數(shù)的實(shí)現(xiàn)，其實(shí)很簡(jiǎn)單，只是創(chuàng)建了一個(gè)單例數(shù)組，數(shù)組中是這個(gè)6個(gè)屬性的getter由selector轉(zhuǎn)成的string。

static NSArray * AFHTTPRequestSerializerObservedKeyPaths() {
    static NSArray *_AFHTTPRequestSerializerObservedKeyPaths = nil;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        _AFHTTPRequestSerializerObservedKeyPaths = @[NSStringFromSelector(@selector(allowsCellularAccess)), NSStringFromSelector(@selector(cachePolicy)), NSStringFromSelector(@selector(HTTPShouldHandleCookies)), NSStringFromSelector(@selector(HTTPShouldUsePipelining)), NSStringFromSelector(@selector(networkServiceType)), NSStringFromSelector(@selector(timeoutInterval))];
    });

    return _AFHTTPRequestSerializerObservedKeyPaths;
}

?

6. self.mutableObservedChangedKeyPaths 解析
   1. self.mutableObservedChangedKeyPaths是什么？
      • 答：AFHTTPRequestSerializer的一個(gè)屬性。用來(lái)保存被開(kāi)發(fā)者賦值的6個(gè)屬性中的一個(gè)或多個(gè)（也可以沒(méi)有）。

      @property (readwrite, nonatomic, strong) NSMutableSet *mutableObservedChangedKeyPaths;
      

   2. self.mutableObservedChangedKeyPaths是在什么地方被初始化的？
      • 答：是在AFHTTPRequestSerializer的init方法中被初始化的。

      self.mutableObservedChangedKeyPaths = [NSMutableSet set];
      

   3. 案例Demo中并沒(méi)有調(diào)用AFHTTPRequestSerializer的init方法，AFHTTPRequestSerializer的init方法是什么時(shí)候調(diào)用的？
      • 答：完整的調(diào)用順序是：[AFHTTPSessionManager manager] => [AFHTTPRequestSerializer serializer] => [[self alloc] init]。這里self是指AFHTTPRequestSerializer。
   4. self.mutableObservedChangedKeyPaths在什么時(shí)候添加的元素？
      • 答：繼續(xù)往下看。

?
第一部分總結(jié)：

AFHTTPRequestSerializer早在初始化的時(shí)候就對(duì)6個(gè)屬性依次添加了鍵值觀察（KVO）。如果我們?cè)谡{(diào)用 AFHTTPSessionManager 的 GET 方法或者 POST 方法之前對(duì)這6個(gè)屬性賦了值，就會(huì)調(diào)用屬性的setter，接著會(huì)觸發(fā)KVO的通知，來(lái)到KVO的observeValueForKeyPath:ofObject:change:context:回調(diào)方法。

#pragma mark - NSKeyValueObserving

+ (BOOL)automaticallyNotifiesObserversForKey:(NSString *)key {
    if ([AFHTTPRequestSerializerObservedKeyPaths() containsObject:key]) {
        return NO;
    }

    return [super automaticallyNotifiesObserversForKey:key];
}

- (void)observeValueForKeyPath:(NSString *)keyPath
                      ofObject:(__unused id)object
                        change:(NSDictionary *)change
                       context:(void *)context
{
    if (context == AFHTTPRequestSerializerObserverContext) {
        if ([change[NSKeyValueChangeNewKey] isEqual:[NSNull null]]) {
            [self.mutableObservedChangedKeyPaths removeObject:keyPath];
        } else {
            [self.mutableObservedChangedKeyPaths addObject:keyPath];
        }
    }
}

在KVO的observeValueForKeyPath:ofObject:change:context:回調(diào)方法中，根據(jù)值是否為空，來(lái)操作self.mutableObservedChangedKeyPaths是添加該keyPath還是移除。

我們假定開(kāi)發(fā)者在調(diào)用GET或POST方法請(qǐng)求前設(shè)置了timeoutInterval屬性：

1. 走timeoutInterval屬性的setter
2. 觸發(fā)KVO的通知，來(lái)到KVO的observeValueForKeyPath:ofObject:change:context:回調(diào)方法
3. timeoutInterval屬性被添加到了mutableObservedChangedKeyPaths集合中
4. 接下來(lái)就是調(diào)用AFHTTPSessionManager的 GET 或 POST 方法發(fā)起請(qǐng)求
5. 然后就會(huì)來(lái)到此處（requestWithMethod:URLString:parameters:error:方法的第一部分，就是現(xiàn)在在解析的這里）
6. 接著把timeoutInterval賦值給NSMutableURLRequest。

以上就是第一部分做的全部事情。

?
一些補(bǔ)充：

• automaticallyNotifiesObserversForKey:函數(shù)用來(lái)根據(jù)條件阻止KVO發(fā)出通知，系統(tǒng)提供的方法，AFN只是進(jìn)行了重寫(xiě)。
• 集合(set)自帶去重的功能，所以當(dāng)6個(gè)屬性被多次賦值時(shí)，也就是多次觸發(fā)observeValueForKeyPath，mutableObservedChangedKeyPaths集合（set）中不會(huì)出現(xiàn)多個(gè)同樣的keyPath。

為什么AFN要手動(dòng)觸發(fā)KVO，而不是自動(dòng)觸發(fā)KVO ？

答：AFN的早期版本也使用KVO觀察這6個(gè)屬性，有人發(fā)現(xiàn)在單元測(cè)試中會(huì)出現(xiàn)崩潰，所以后來(lái)增加了automaticallyNotifiesObserversForKey方法來(lái)阻止這6個(gè)屬性通過(guò)KVO自動(dòng)發(fā)送通知。但是很快人們發(fā)現(xiàn)這樣做，這6個(gè)屬性使用開(kāi)始出現(xiàn)問(wèn)題，會(huì)有設(shè)置后無(wú)效的情況。于是作者又改了回去，刪了automaticallyNotifiesObserversForKey方法，但是問(wèn)題又繞回原地了。因此為了能在單元測(cè)試中正常使用，并且這6個(gè)屬性的使用不能受到影響，即正常可以使用KVO，于是增加了6個(gè)屬性的setter，在setter里面手動(dòng)觸發(fā)KVO。

?

第二部分 （高能預(yù)警）

一句話描述：
根據(jù)請(qǐng)求方法（GET、POST）的不同，將Parameters按照每種方法的要求組裝到NSMutableURLRequest的實(shí)例mutableRequest中去。即GET方法是將參數(shù)處理后拼接到URL中，POST方法是將參數(shù)處理后設(shè)置到請(qǐng)求體中。

第二部分核心方法：requestBySerializingRequest:withParameters:error:

- (NSURLRequest *)requestBySerializingRequest:(NSURLRequest *)request
                               withParameters:(id)parameters
                                        error:(NSError *__autoreleasing *)error
{
    NSParameterAssert(request);

    NSMutableURLRequest *mutableRequest = [request mutableCopy];
    
    // 這部分起個(gè)名：self.HTTPRequestHeaders部分
    [self.HTTPRequestHeaders enumerateKeysAndObjectsUsingBlock:^(id field, id value, BOOL * __unused stop) {
        if (![request valueForHTTPHeaderField:field]) {
            [mutableRequest setValue:value forHTTPHeaderField:field];
        }
    }];

    // 這部分起個(gè)名：處理傳入的parameters部分
    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 = AFQueryStringFromParameters(parameters);
                    break;
            }
        }
    }

    // 這部分起個(gè)名：使用query裝配mutableRequest部分
    if ([self.HTTPMethodsEncodingParametersInURI containsObject:[[request HTTPMethod] uppercaseString]]) {
        if (query && query.length > 0) {
            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 = @"";
        }
        if (![mutableRequest valueForHTTPHeaderField:@"Content-Type"]) {
            [mutableRequest setValue:@"application/x-www-form-urlencoded" forHTTPHeaderField:@"Content-Type"];
        }
        [mutableRequest setHTTPBody:[query dataUsingEncoding:self.stringEncoding]];
    }

    return mutableRequest;
}

?
在源碼的注釋中為了方便敘述我給劃分成了3個(gè)部分，分別是：

1. self.HTTPRequestHeaders部分
2. 處理傳入的parameters部分
3. 使用query裝配mutableRequest部分

按照代碼順序，逐步解析：

self.HTTPRequestHeaders部分

[self.HTTPRequestHeaders enumerateKeysAndObjectsUsingBlock:^(id field, id value, BOOL * __unused stop) {
    if (![request valueForHTTPHeaderField:field]) {
        [mutableRequest setValue:value forHTTPHeaderField:field];
    }
}];

一句話描述：
遍歷self.HTTPRequestHeaders，如果我們創(chuàng)建的新 NSURLRequest *request 中沒(méi)有開(kāi)發(fā)者指定(init中也指定了默認(rèn))的請(qǐng)求頭字段和值，那么把沒(méi)有的這部分開(kāi)發(fā)者指定的的請(qǐng)求頭字段和值保存一份到request中。

整體邏輯

1. 遍歷self.HTTPRequestHeaders
   • self.HTTPRequestHeaders只有初始化時(shí)AFN默認(rèn)添加的Accept-Language、User-Agent兩個(gè)鍵值對(duì)。
2. 如果我們創(chuàng)建的新 NSURLRequest *request 中開(kāi)發(fā)者指定了Accept-Language和User-Agent以外的請(qǐng)求頭鍵值對(duì)，那么把這些Accept-Language與User-Agent以外的請(qǐng)求頭鍵值對(duì)保存一份到request中。

分解說(shuō)明

1. self.HTTPRequestHeaders 的聲明在 AFHTTPRequestSerializer.h：

   @property (readonly, nonatomic, strong) NSDictionary <NSString *, NSString *> *HTTPRequestHeaders;
   

2. self.HTTPRequestHeaders 的取值方法，即getter：

   - (NSDictionary *)HTTPRequestHeaders {
       NSDictionary __block *value;
       dispatch_sync(self.requestHeaderModificationQueue, ^{
           value = [NSDictionary dictionaryWithDictionary:self.mutableHTTPRequestHeaders];
       });
       return value;
   }
   

   getter解析：

   • self.HTTPRequestHeaders 的值完全來(lái)自于 self.mutableHTTPRequestHeaders
   • requestHeaderModificationQueue 在 AFHTTPRequestSerializer 的 init 方法中初始化，是一個(gè)并發(fā)隊(duì)列。具體請(qǐng)參考AFNetworking主線梳理（一）AFHTTPRequestSerializer 部分。

   self.requestHeaderModificationQueue = dispatch_queue_create("requestHeaderModificationQueue",  DISPATCH_QUEUE_CONCURRENT);
   

3. self.mutableHTTPRequestHeaders

   • self.mutableHTTPRequestHeaders 的聲明在 AFHTTPRequestSerializer.m：

   @property (readwrite, nonatomic, strong) NSMutableDictionary *mutableHTTPRequestHeaders;
   

   • self.mutableHTTPRequestHeaders 在 AFHTTPRequestSerializer 的 init 方法中初始化

   self.mutableHTTPRequestHeaders = [NSMutableDictionary dictionary];
   

   • self.mutableHTTPRequestHeaders 如何被賦值？
     • self.mutableHTTPRequestHeaders 是在 setValue:forHTTPHeaderField: 方法中間接賦值的。
     • requestHeaderModificationQueue 在 AFHTTPRequestSerializer 的 init 方法中初始化，和前面第2小點(diǎn)的"self.HTTPRequestHeaders取值方法"用的是同一個(gè)并發(fā)隊(duì)列。具體請(qǐng)參考AFNetworking主線梳理（一）AFHTTPRequestSerializer 部分。

4. 那么 self.mutableHTTPRequestHeaders 是什么時(shí)候被賦上默認(rèn)值的呢？
   • 答：在 AFHTTPRequestSerializer的init 方法中，分兩次給 self.mutableHTTPRequestHeaders 賦了默認(rèn)值，分別是：Accept-Language、User-Agent。具體請(qǐng)參考AFNetworking主線梳理（一）AFHTTPRequestSerializer 部分。
     ?

至此，“第二部分 （高能預(yù)警）” => “self.HTTPRequestHeaders部分”的使命完成。

問(wèn)：開(kāi)發(fā)者如何給request指定請(qǐng)求頭的字段和值呢？
答：通過(guò) AFHTTPRequestSerializer 的 setValue:forHTTPHeaderField: 方法。

處理傳入的parameters部分

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

一句話描述：“處理傳入的parameters部分” 就是將parameters按照規(guī)則拼接成query string。

假定開(kāi)發(fā)者傳入的parameters為字典{"key1" : "value1", "key2" : "value2"}，那么query = "key1=value1&key2=value2"。

接下來(lái)我們看看parameters是如何被拼接成query的。

“處理傳入的parameters部分” 按照 if else被自然分割成兩部分，先看 if 這部分。

if 分支整體邏輯：

1. 如果 self.queryStringSerialization（一個(gè)block）存在，即開(kāi)發(fā)者實(shí)現(xiàn)了這個(gè)block，則執(zhí)行 if 分支內(nèi)的語(yǔ)句。
2. 把 request、parameters 以及 *error 傳遞給self.queryStringSerialization這個(gè)block，由block處理完成后，返回query。

分解說(shuō)明：

1. self.queryStringSerialization 是一個(gè)block，需要開(kāi)發(fā)者實(shí)現(xiàn)，聲明以及賦值方法 API 如下

// AFURLRequestSerialization.h
- (void)setQueryStringSerializationWithBlock:(nullable NSString * (^)(NSURLRequest *request, id parameters, NSError * __autoreleasing *error))block;

// AFURLRequestSerialization.m
typedef NSString * (^AFQueryStringSerializationBlock)(NSURLRequest *request, id parameters, NSError *__autoreleasing *error);

@property (readwrite, nonatomic, copy) AFQueryStringSerializationBlock queryStringSerialization;

- (void)setQueryStringSerializationWithBlock:(NSString *(^)(NSURLRequest *, id, NSError *__autoreleasing *))block {
    self.queryStringSerialization = block;
}

2. self.queryStringSerialization 是什么時(shí)候、什么地方被實(shí)現(xiàn)的？
   答：沒(méi)有默認(rèn)的初始化，需要開(kāi)發(fā)者去實(shí)現(xiàn)此block。如果開(kāi)發(fā)者沒(méi)有實(shí)現(xiàn)這個(gè)block，就不會(huì)走 if 分支。

3. self.queryStringSerialization 的作用
   答：這個(gè)block的意義所在，是當(dāng)開(kāi)發(fā)者如果需要自定義 query string 的拼接規(guī)則，則用block傳過(guò)來(lái)的request、parameters 以及 error 自行拼接一個(gè) query string 并返回。

4. NSError *__autoreleasing *error 干啥的？
   答案：如果開(kāi)發(fā)者在拼接 query string 過(guò)程中出現(xiàn)錯(cuò)誤，想要拋出Error，就可以利用這個(gè)指針的指針來(lái)直接傳遞error。

?
else 分支整體邏輯：

可以說(shuō) else 分支直接可以看成 query = AFQueryStringFromParameters(parameters); 這一句代碼最為合適。

如果開(kāi)發(fā)者沒(méi)有使用（實(shí)現(xiàn)）self.queryStringSerialization，則會(huì)走 else分支，else分支也是最普通、最常用的分支。

分解說(shuō)明：

1. 雖然 else 分支是一整個(gè)switch控制的，但是AFHTTPRequestQueryStringSerializationStyle枚舉值只有一個(gè)而且還是 0 （NSUInteger）。也就是說(shuō)開(kāi)發(fā)者設(shè)置這個(gè)Style也好不設(shè)置也好，最終都會(huì)走switch的第一個(gè)case分支，目前AFN的版本中你沒(méi)得選。

typedef NS_ENUM(NSUInteger, AFHTTPRequestQueryStringSerializationStyle) {
    AFHTTPRequestQueryStringDefaultStyle = 0,
};

2. self.queryStringSerializationStyle 是一個(gè)枚舉值，需要開(kāi)發(fā)者指定，聲明以及賦值方法 API 如下

// AFURLRequestSerialization.h
- (void)setQueryStringSerializationWithStyle:(AFHTTPRequestQueryStringSerializationStyle)style;

// AFURLRequestSerialization.m
@property (readwrite, nonatomic, assign) AFHTTPRequestQueryStringSerializationStyle queryStringSerializationStyle;

- (void)setQueryStringSerializationWithStyle:(AFHTTPRequestQueryStringSerializationStyle)style {
    self.queryStringSerializationStyle = style;
    self.queryStringSerialization = nil;
}

?
重點(diǎn)?。。?/strong>
else 分支的核心函數(shù) AFQueryStringFromParameters()

NSString * AFQueryStringFromParameters(NSDictionary *parameters) {
    NSMutableArray *mutablePairs = [NSMutableArray array];
    for (AFQueryStringPair *pair in AFQueryStringPairsFromDictionary(parameters)) {
        [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];
    // 升序排序
    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) {
                [mutableQueryStringComponents addObjectsFromArray:AFQueryStringPairsFromKeyAndValue((key ? [NSString stringWithFormat:@"%@[%@]", key, nestedKey] : nestedKey), nestedValue)];
            }
        }
    } else if ([value isKindOfClass:[NSArray class]]) {
        NSArray *array = value;
        for (id nestedValue in array) {
            [mutableQueryStringComponents addObjectsFromArray:AFQueryStringPairsFromKeyAndValue([NSString stringWithFormat:@"%@[]", key], nestedValue)];
        }
    } else if ([value isKindOfClass:[NSSet class]]) {
        NSSet *set = value;
        for (id obj in [set sortedArrayUsingDescriptors:@[ sortDescriptor ]]) {
            [mutableQueryStringComponents addObjectsFromArray:AFQueryStringPairsFromKeyAndValue(key, obj)];
        }
    } else { // 這個(gè)分支才是主要分支
        [mutableQueryStringComponents addObject:[[AFQueryStringPair alloc] initWithField:key value:value]];
    }

    return mutableQueryStringComponents;
}

if ([self.HTTPMethodsEncodingParametersInURI containsObject:[[request HTTPMethod] uppercaseString]]) {
    if (query && query.length > 0) {
        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 = @"";
    }
    if (![mutableRequest valueForHTTPHeaderField:@"Content-Type"]) {
        [mutableRequest setValue:@"application/x-www-form-urlencoded" forHTTPHeaderField:@"Content-Type"];
    }
    [mutableRequest setHTTPBody:[query dataUsingEncoding:self.stringEncoding]];
}

// AFURLRequestSerialization.h
@property (nonatomic, strong) NSSet <NSString *> *HTTPMethodsEncodingParametersInURI;

// AFURLRequestSerialization.m => init 方法

self.HTTPMethodsEncodingParametersInURI = [NSSet setWithObjects:@"GET", @"HEAD", @"DELETE", nil];

self.stringEncoding = NSUTF8StringEncoding;

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

    __block NSURLSessionDataTask *dataTask = nil;
    url_session_manager_create_task_safely(^{
        dataTask = [self.session dataTaskWithRequest:request];
    });

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

    return dataTask;
}

#pragma mark -

@interface AFQueryStringPair : NSObject
@property (readwrite, nonatomic, strong) id field;
@property (readwrite, nonatomic, strong) id value;

- (instancetype)initWithField:(id)field value:(id)value;

- (NSString *)URLEncodedStringValue;
@end

@implementation AFQueryStringPair

- (instancetype)initWithField:(id)field value:(id)value {
    self = [super init];
    if (!self) {
        return nil;
    }

    self.field = field;
    self.value = value;

    return self;
}

- (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])];
    }
}

@end