前言

AFURLRequestSerialization主要實(shí)現(xiàn)了根據(jù)不同情況和參數(shù)初始化NSURLRequest對象的功能携栋。只有AFHTTPSessionManager有requestSerialization，默認(rèn)是AFHTTPRequestSerializer對象。尤其是我們使用MultipartForm請求的時(shí)候，可以使用它幫我們完成繁雜的請求頭拼接過程，這個(gè)是最值得推薦的罩驻。

在閱讀源碼之前，一定要對multipart/form-data非常熟悉护赊，不然會有很多地方看不懂惠遏。具體可以看AFNetWorking源碼之AFHTTPSessionManager關(guān)于它的那部分。

AFURLRequestSerialization的api分析

AFURLRequestSerialization包含了四個(gè)部分：

全局方法:AFPercentEscapedStringFromString和AFQueryStringFromParameters骏啰。

協(xié)議AFURLRequestSerialization提供了一個(gè)序列化parameters參數(shù)的方法节吮。我們可以把參數(shù)轉(zhuǎn)換為查詢字符串、HTTP請求體判耕、設(shè)置恰當(dāng)?shù)恼埱箢^等透绩。

AFHTTPRequestSerializer繼承自AFURLRequestSerialization協(xié)議。提供了查詢字符串/URL格式的參數(shù)序列化壁熄、默認(rèn)請求頭處理帚豪。同時(shí)以提供HTTP狀態(tài)碼和返回?cái)?shù)據(jù)的驗(yàn)證等工作。

_ AFMultipartFormData協(xié)議草丧。主要用于添加multipart/form-data請求的Content-Disposition: file; filename=#{generated filename}; name=#{name}" 和 Content-Type: #{generated mimeType}的請求體域狸臣。

類型AFJSONRequestSerializer和AFPropertyListRequestSerializer。主要針對JSON和Plist類型的序列化優(yōu)化昌执。

AFPercentEscapedStringFromString返回一個(gè)字符串的百分號編碼格式的字符串烛亦。因?yàn)閡rl只有普通英文字符和數(shù)字，特殊字符$-_.+!*'()還有保留字符懂拾。所以很多字符都需要編碼,非ASCII編碼的字符串先轉(zhuǎn)換為ASCII編碼煤禽，然后再轉(zhuǎn)換為百分號編碼。

/**
AFPercentEscapedStringFromString方法的作用就是把一個(gè)普通字符串轉(zhuǎn)換為百分號編碼的字符串
 http://blog.csdn.net/qq_32010299/article/details/51790407
 @param string 一個(gè)字符串
 @return 百分號編碼的字符串
 */
NSString * AFPercentEscapedStringFromString(NSString *string) {
    //可能需要做百分號編碼處理的字符串
    static NSString * const kAFCharactersGeneralDelimitersToEncode = @":#[]@"; 
    static NSString * const kAFCharactersSubDelimitersToEncode = @"!$&'()*+,;=";
    //不需要做百分號編碼的字符串集合
    NSMutableCharacterSet * allowedCharacterSet = [[NSCharacterSet URLQueryAllowedCharacterSet] mutableCopy];
    //獲取目前系統(tǒng)中最終需要做百分號編碼轉(zhuǎn)換的字符集合
    [allowedCharacterSet removeCharactersInString:[kAFCharactersGeneralDelimitersToEncode stringByAppendingString:kAFCharactersSubDelimitersToEncode]];

    static NSUInteger const batchSize = 50;
    NSUInteger index = 0;
    NSMutableString *escaped = @"".mutableCopy;
    //迭代字符串做百分號編碼
    while (index < string.length) {
        NSUInteger length = MIN(string.length - index, batchSize);
        NSRange range = NSMakeRange(index, length);
        //移除字符串中的一些非法字符岖赋。比如????
        range = [string rangeOfComposedCharacterSequencesForRange:range];
        NSString *substring = [string substringWithRange:range];
        //指定范圍內(nèi)的字符做百分號編碼
        NSString *encoded = [substring stringByAddingPercentEncodingWithAllowedCharacters:allowedCharacterSet];
        [escaped appendString:encoded];
        index += range.length;
    }
    //返回處理以后的字符串
    return escaped;
}

私有類AFQueryStringPair的主要功能就是把一個(gè)key和vaue的鍵值對轉(zhuǎn)換為百分號編碼格式的鍵值對并且用=鏈接起來

@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;
}
/**
 把key呜师、value鍵值對轉(zhuǎn)換為百分號編碼，并且鏈接起來
 @return 轉(zhuǎ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])];
    }
}
@end

方法AFQueryStringPairsFromDictionary和AFQueryStringPairsFromKeyAndValue分別把一個(gè)字典或者key汁汗、value鍵值對轉(zhuǎn)換為url的query參數(shù)衷畦。

/**
 把一個(gè)字典轉(zhuǎn)換為百分號編碼的query參數(shù)
 @param parameters 要轉(zhuǎn)換的字典
 @return query參數(shù)
 */
NSString * AFQueryStringFromParameters(NSDictionary *parameters) {
    NSMutableArray *mutablePairs = [NSMutableArray array];
    for (AFQueryStringPair *pair in AFQueryStringPairsFromDictionary(parameters)) {
        //調(diào)用`AFQueryStringPair`序列化
        [mutablePairs addObject:[pair URLEncodedStringValue]];
    }
    return [mutablePairs componentsJoinedByString:@"&"];
}
NSArray * AFQueryStringPairsFromDictionary(NSDictionary *dictionary) {
    return AFQueryStringPairsFromKeyAndValue(nil, dictionary);
}
/**
 分別把一個(gè)字典、數(shù)組知牌、集合轉(zhuǎn)換為一個(gè)AFQueryStringPair對象的的數(shù)組祈争。
 @param key key
 @param value value
 @return AFQueryStringPair類型數(shù)組
 */
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;
        for (id nestedKey in [dictionary.allKeys sortedArrayUsingDescriptors:@[ sortDescriptor ]]) {
            id nestedValue = dictionary[nestedKey];
            if (nestedValue) {
                //如果是字典，就取出每一對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ù)組菩混，則取出元素，添加一個(gè)額外的key處理
            [mutableQueryStringComponents addObjectsFromArray:AFQueryStringPairsFromKeyAndValue([NSString stringWithFormat:@"%@[]", key], nestedValue)];
        }
    } else if ([value isKindOfClass:[NSSet class]]) {
        NSSet *set = value;
        for (id obj in [set sortedArrayUsingDescriptors:@[ sortDescriptor ]]) {
            //如果是集合扁藕，就是用默認(rèn)key和集合元素處理
            [mutableQueryStringComponents addObjectsFromArray:AFQueryStringPairsFromKeyAndValue(key, obj)];
        }
    } else {
        //添加處理后的key和value
        [mutableQueryStringComponents addObject:[[AFQueryStringPair alloc] initWithField:key value:value]];
    }
    //返回`AFQueryStringPair`對象數(shù)組
    return mutableQueryStringComponents;
}

AFHTTPRequestSerializerObservedKeyPaths全局方法指定了request請求序列化要觀察的屬性列表沮峡、是一個(gè)數(shù)組，里面有對蜂窩數(shù)據(jù)亿柑、緩存策略邢疙、cookie、管道望薄、網(wǎng)絡(luò)狀態(tài)疟游、超時(shí)這幾個(gè)元素。

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

AFHTTPRequestSerializer的解析

AFHTTPRequestSerializer主要實(shí)現(xiàn)了大部分request拼接轉(zhuǎn)化功能痕支。比如通用請求頭的添加如userAgent颁虐、request屬性的KVO觀察、手動指定請求頭序列化的Block卧须、負(fù)責(zé)具體的request對象的初始化等另绩。

1 AFHTTPRequestSerializer的屬性和初始化

//屬性列表
@interface AFHTTPRequestSerializer ()
//某個(gè)request需要觀察的屬性集合
@property (readwrite, nonatomic, strong) NSMutableSet *mutableObservedChangedKeyPaths;
//存儲request的請求頭域
@property (readwrite, nonatomic, strong) NSMutableDictionary *mutableHTTPRequestHeaders;
//用于修改或者設(shè)置請求體域的dispatch_queue_t。
@property (readwrite, nonatomic, strong) dispatch_queue_t requestHeaderModificationQueue;
@property (readwrite, nonatomic, assign) AFHTTPRequestQueryStringSerializationStyle queryStringSerializationStyle;
//手動指定parameters參數(shù)序列化的Block
@property (readwrite, nonatomic, copy) AFQueryStringSerializationBlock queryStringSerialization;
@end
//初始化方法
- (instancetype)init {
    self = [super init];
    if (!self) {
        return nil;
    }
    //指定序列化編碼格式
    self.stringEncoding = NSUTF8StringEncoding;
    //請求頭保存在一個(gè)字典中花嘶，方便后面構(gòu)建request的時(shí)候拼裝板熊。
    self.mutableHTTPRequestHeaders = [NSMutableDictionary dictionary];
    //初始化一個(gè)操作request的header域的dispatch_queue_t
    self.requestHeaderModificationQueue = dispatch_queue_create("requestHeaderModificationQueue", DISPATCH_QUEUE_CONCURRENT);

    NSMutableArray *acceptLanguagesComponents = [NSMutableArray array];
    /*
     *枚舉系統(tǒng)的language列表。然后設(shè)置`Accept-Language`請求頭域察绷。優(yōu)先級逐級降低，最多五個(gè)津辩。
     */
    [[NSLocale preferredLanguages] enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) {
        float q = 1.0f - (idx * 0.1f);
        [acceptLanguagesComponents addObject:[NSString stringWithFormat:@"%@;q=%0.1g", obj, q]];
        *stop = q <= 0.5f;
    }];
    //數(shù)組元素使用`, `分割
    [self setValue:[acceptLanguagesComponents componentsJoinedByString:@", "] forHTTPHeaderField:@"Accept-Language"];
    /*
     *設(shè)置User-Agent請求頭域的值拆撼。
     */
    NSString *userAgent = nil;
    userAgent = [NSString stringWithFormat:@"%@/%@ (%@; iOS %@; Scale/%0.2f)", [[NSBundle mainBundle] infoDictionary][(__bridge NSString *)kCFBundleExecutableKey] ?: [[NSBundle mainBundle] infoDictionary][(__bridge NSString *)kCFBundleIdentifierKey], [[NSBundle mainBundle] infoDictionary][@"CFBundleShortVersionString"] ?: [[NSBundle mainBundle] infoDictionary][(__bridge NSString *)kCFBundleVersionKey], [[UIDevice currentDevice] model], [[UIDevice currentDevice] systemVersion], [[UIScreen mainScreen] scale]];
    if (userAgent) {
        /*
         *如果userAgent里面包含非ASCII碼的字符，比如中文喘沿，則需要轉(zhuǎn)換闸度。這里是轉(zhuǎn)換為對應(yīng)的拉丁字母。
         AFNetWorking3.X源碼閱讀/1.0 (iPhone; iOS 10.2; Scale/2.00)
         AFNetWorking3.X yuan ma yue du/1.0 (iPhone; iOS 10.2; Scale/2.00)
         */
        if (![userAgent canBeConvertedToEncoding:NSASCIIStringEncoding]) {
            NSMutableString *mutableUserAgent = [userAgent mutableCopy];
            //轉(zhuǎn)換為拉丁字母
            if (CFStringTransform((__bridge CFMutableStringRef)(mutableUserAgent), NULL, (__bridge CFStringRef)@"Any-Latin; Latin-ASCII; [:^ASCII:] Remove", false)) {
                userAgent = mutableUserAgent;
            }
        }
        [self setValue:userAgent forHTTPHeaderField:@"User-Agent"];
    }

    // HTTP Method Definitions; see http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html
    //需要把parameters轉(zhuǎn)換為query參數(shù)的方法集合蚜印。
    self.HTTPMethodsEncodingParametersInURI = [NSSet setWithObjects:@"GET", @"HEAD", @"DELETE", nil];

    self.mutableObservedChangedKeyPaths = [NSMutableSet set];
    /*
     添加對蜂窩數(shù)據(jù)莺禁、緩存策略、cookie窄赋、管道哟冬、網(wǎng)絡(luò)狀態(tài)楼熄、超時(shí)這幾個(gè)屬性的觀察。
     */
    for (NSString *keyPath in AFHTTPRequestSerializerObservedKeyPaths()) {
        if ([self respondsToSelector:NSSelectorFromString(keyPath)]) {
            [self addObserver:self forKeyPath:keyPath options:NSKeyValueObservingOptionNew context:AFHTTPRequestSerializerObserverContext];
        }
    }
    return self;
}

2 AFHTTPRequestSerializer的各種setter方法

首先通過automaticallyNotifiesObserversForKey方法來阻止一些屬性的KVO機(jī)制的觸發(fā)浩峡，然后我們通過重寫蜂窩數(shù)據(jù)可岂、緩存策略、cookie翰灾、管道缕粹、網(wǎng)絡(luò)狀態(tài)、超時(shí)的觀察纸淮∑秸叮可以用于測試這些屬性變化是否崩潰等。

/**
 如果kvo的觸發(fā)機(jī)制是默認(rèn)出發(fā)咽块。則返回true绘面，否則返回false。在這里糜芳，只要是`AFHTTPRequestSerializerObservedKeyPaths`里面的屬性飒货，我們都取消自動出發(fā)kvo機(jī)制，使用手動觸發(fā)峭竣。

 @param key kvo的key
 @return bool值
 */
+ (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) {
        //如果屬性值為null塘辅，則表示么有這個(gè)屬性，移除對其的觀察
        if ([change[NSKeyValueChangeNewKey] isEqual:[NSNull null]]) {
            [self.mutableObservedChangedKeyPaths removeObject:keyPath];
        } else {
            //添加到要觀察的屬性的集合
            [self.mutableObservedChangedKeyPaths addObject:keyPath];
        }
    }
}

通過重寫屬性的setter方法來手動觸發(fā)kvo

#pragma mark - 手動觸發(fā)蜂窩數(shù)據(jù)皆撩、緩存策略扣墩、cookie、管道扛吞、網(wǎng)絡(luò)狀態(tài)呻惕、超時(shí)的觀察±谋龋可以用于測試這些屬性變化是否崩潰等亚脆。
- (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))];
}

- (void)setHTTPShouldHandleCookies:(BOOL)HTTPShouldHandleCookies {
    [self willChangeValueForKey:NSStringFromSelector(@selector(HTTPShouldHandleCookies))];
    _HTTPShouldHandleCookies = HTTPShouldHandleCookies;
    [self didChangeValueForKey:NSStringFromSelector(@selector(HTTPShouldHandleCookies))];
}

- (void)setHTTPShouldUsePipelining:(BOOL)HTTPShouldUsePipelining {
    [self willChangeValueForKey:NSStringFromSelector(@selector(HTTPShouldUsePipelining))];
    _HTTPShouldUsePipelining = HTTPShouldUsePipelining;
    [self didChangeValueForKey:NSStringFromSelector(@selector(HTTPShouldUsePipelining))];
}

- (void)setNetworkServiceType:(NSURLRequestNetworkServiceType)networkServiceType {
    [self willChangeValueForKey:NSStringFromSelector(@selector(networkServiceType))];
    _networkServiceType = networkServiceType;
    [self didChangeValueForKey:NSStringFromSelector(@selector(networkServiceType))];
}

- (void)setTimeoutInterval:(NSTimeInterval)timeoutInterval {
    [self willChangeValueForKey:NSStringFromSelector(@selector(timeoutInterval))];
    _timeoutInterval = timeoutInterval;
    [self didChangeValueForKey:NSStringFromSelector(@selector(timeoutInterval))];
}

3 AFHTTPRequestSerializer的各種請求頭域處理方法

/**
 返回請求頭域key和vaue

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

/**
 設(shè)置一個(gè)請求頭域

 @param value vaue
 @param field 域名
 */
- (void)setValue:(NSString *)value
forHTTPHeaderField:(NSString *)field
{
    dispatch_barrier_async(self.requestHeaderModificationQueue, ^{
        [self.mutableHTTPRequestHeaders setValue:value forKey:field];
    });
}
/**
 返回指定請求頭域的值

 @param field 域名
 @return 值
 */
- (NSString *)valueForHTTPHeaderField:(NSString *)field {
    NSString __block *value;
    dispatch_sync(self.requestHeaderModificationQueue, ^{
        value = [self.mutableHTTPRequestHeaders valueForKey:field];
    });
    return value;
}

/**
 設(shè)置Basic Authorization的用戶名和密碼。記住需要是base64編碼格式的盲泛。
 @param username 用戶
 @param password 密碼
 */
- (void)setAuthorizationHeaderFieldWithUsername:(NSString *)username
                                       password:(NSString *)password
{
    NSData *basicAuthCredentials = [[NSString stringWithFormat:@"%@:%@", username, password] dataUsingEncoding:NSUTF8StringEncoding];
    NSString *base64AuthCredentials = [basicAuthCredentials base64EncodedStringWithOptions:(NSDataBase64EncodingOptions)0];
    [self setValue:[NSString stringWithFormat:@"Basic %@", base64AuthCredentials] forHTTPHeaderField:@"Authorization"];
}
/**
 移除Basic Authorization的請求頭
 */
- (void)clearAuthorizationHeader {
    dispatch_barrier_async(self.requestHeaderModificationQueue, ^{
        [self.mutableHTTPRequestHeaders removeObjectForKey:@"Authorization"];
    });
}

4 AFHTTPRequestSerializer的各種創(chuàng)建NSMutableURLRequest的方法

通過下面這三種方法處理不同類型的request對象的初始化和參數(shù)序列化濒持。

/**
 根據(jù)給定的url、方法名寺滚、參數(shù)構(gòu)建一個(gè)request柑营。

 @param method 方法名
 @param URLString url地址
 @param parameters 參數(shù)，根據(jù)不同的請求方法構(gòu)建出不同的模式
 @param error 構(gòu)建出錯(cuò)
 @return 返回一個(gè)非multipartForm請求
 */
- (NSMutableURLRequest *)requestWithMethod:(NSString *)method
                                 URLString:(NSString *)URLString
                                parameters:(id)parameters
                                     error:(NSError *__autoreleasing *)error
{
    NSParameterAssert(method);
    NSParameterAssert(URLString);
    NSURL *url = [NSURL URLWithString:URLString];
    NSParameterAssert(url);
    NSMutableURLRequest *mutableRequest = [[NSMutableURLRequest alloc] initWithURL:url];
    mutableRequest.HTTPMethod = method;
    /*
     *mutableObservedChangedKeyPaths集合里面的屬性都通過`setValue: forKey`手動設(shè)置一下村视。估計(jì)目的是觸發(fā)這幾個(gè)屬性的kvo官套。
     */
    for (NSString *keyPath in AFHTTPRequestSerializerObservedKeyPaths()) {
        if ([self.mutableObservedChangedKeyPaths containsObject:keyPath]) {
            [mutableRequest setValue:[self valueForKeyPath:keyPath] forKey:keyPath];
        }
    }
    /*
     根據(jù)parameters和HTTPRequestHeaders構(gòu)建一個(gè)request
     */
    mutableRequest = [[self requestBySerializingRequest:mutableRequest withParameters:parameters error:error] mutableCopy];
    return mutableRequest;
}

/**
 構(gòu)建一個(gè)multipartForm的request。并且通過`AFMultipartFormData`類型的formData來構(gòu)建請求體

 @param method 方法名，一般都是POST
 @param URLString 請求地址
 @param parameters 請求頭參數(shù)
 @param block 用于構(gòu)建請求體的Block
 @param error 構(gòu)建請求體出錯(cuò)
 @return 返回一個(gè)構(gòu)建好的request
 */
- (NSMutableURLRequest *)multipartFormRequestWithMethod:(NSString *)method
                                              URLString:(NSString *)URLString
                                             parameters:(NSDictionary *)parameters
                              constructingBodyWithBlock:(void (^)(id <AFMultipartFormData> formData))block
                                                  error:(NSError *__autoreleasing *)error
{
    NSParameterAssert(method);
    NSParameterAssert(![method isEqualToString:@"GET"] && ![method isEqualToString:@"HEAD"]);
    /*
     先構(gòu)建一個(gè)普通的request對象奶赔，然后在構(gòu)建出multipartFrom的request
     * 在這一步將會把parameters加入請求頭或者請求體惋嚎。然后把`AFURLRequestSerialization`指定的headers加入request的請求頭中。這個(gè)request就只差構(gòu)建multipartFrom部分了
     */
    NSMutableURLRequest *mutableRequest = [self requestWithMethod:method URLString:URLString parameters:nil error:error];
    /*
     *初始化一個(gè)`AFStreamingMultipartFormData`對象纺阔。用于封裝multipartFrom的body部分
     */
    __block AFStreamingMultipartFormData *formData = [[AFStreamingMultipartFormData alloc] initWithURLRequest:mutableRequest stringEncoding:NSUTF8StringEncoding];
    if (parameters) {
        /*
         把parameters拼接成`AFQueryStringPair`對象瘸彤。然后根據(jù)取出的key和value處理。
         */
        for (AFQueryStringPair *pair in AFQueryStringPairsFromDictionary(parameters)) {
            NSData *data = nil;
            //把value處理為NSData類型
            if ([pair.value isKindOfClass:[NSData class]]) {
                data = pair.value;
            } else if ([pair.value isEqual:[NSNull null]]) {
                data = [NSData data];
            } else {
                data = [[pair.value description] dataUsingEncoding:self.stringEncoding];
            }
            if (data) {
                [formData appendPartWithFormData:data name:[pair.field description]];
            }
        }
    }
    if (block) {
        block(formData);
    }
    //body具體序列化操作
    return [formData requestByFinalizingMultipartFormData];
}

/**
 通過一個(gè)Multipart-Form的request創(chuàng)建一個(gè)request笛钝。新request的httpBody是`fileURL`指定的文件质况。
 并且是通過`HTTPBodyStream`這個(gè)屬性添加，`HTTPBodyStream`屬性的數(shù)據(jù)會自動添加為httpBody玻靡。

 @param request 原request
 @param fileURL 文件的url
 @param handler 錯(cuò)誤處理
 @return 處理完成的request
 */
- (NSMutableURLRequest *)requestWithMultipartFormRequest:(NSURLRequest *)request
                             writingStreamContentsToFile:(NSURL *)fileURL
                                       completionHandler:(void (^)(NSError *error))handler
{
    NSParameterAssert(request.HTTPBodyStream);
    NSParameterAssert([fileURL isFileURL]);
    //獲取`HTTPBodyStream`屬性
    NSInputStream *inputStream = request.HTTPBodyStream;
    //獲取文件的數(shù)據(jù)流
    NSOutputStream *outputStream = [[NSOutputStream alloc] initWithURL:fileURL append:NO];
    __block NSError *error = nil;

    dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
        //把讀和寫的操作加入當(dāng)前線程的runloop
        [inputStream scheduleInRunLoop:[NSRunLoop currentRunLoop] forMode:NSDefaultRunLoopMode];
        [outputStream scheduleInRunLoop:[NSRunLoop currentRunLoop] forMode:NSDefaultRunLoopMode];
        //打開讀和寫數(shù)據(jù)流
        [inputStream open];
        [outputStream open];
        //循環(huán)做讀和寫操作
        while ([inputStream hasBytesAvailable] && [outputStream hasSpaceAvailable]) {
            uint8_t buffer[1024];

            NSInteger bytesRead = [inputStream read:buffer maxLength:1024];
            if (inputStream.streamError || bytesRead < 0) {
                error = inputStream.streamError;
                break;
            }

            NSInteger bytesWritten = [outputStream write:buffer maxLength:(NSUInteger)bytesRead];
            if (outputStream.streamError || bytesWritten < 0) {
                error = outputStream.streamError;
                break;
            }

            if (bytesRead == 0 && bytesWritten == 0) {
                break;
            }
        }
        //讀和寫完成结榄。關(guān)閉讀和寫數(shù)據(jù)流
        [outputStream close];
        [inputStream close];
        //如果有handler，調(diào)用handler這個(gè)Block
        if (handler) {
            dispatch_async(dispatch_get_main_queue(), ^{
                handler(error);
            });
        }
    });
    //獲取一個(gè)新的request囤捻，新的request的httpBody已經(jīng)通過`HTTPBodyStream`轉(zhuǎn)換成功
    NSMutableURLRequest *mutableRequest = [request mutableCopy];
    mutableRequest.HTTPBodyStream = nil;
    //返回一個(gè)request對象
    return mutableRequest;
}

AFStreamingMultipartFormData私有類的解析

首先臼朗，我們看幾個(gè)全局方法。下面幾個(gè)方法用于拼接multipart/form-data的分隔符和文件的MIMEType蝎土。

/*
 生成multipartForm的request的boundary
 */
static NSString * AFCreateMultipartFormBoundary() {
    return [NSString stringWithFormat:@"Boundary+%08X%08X", arc4random(), arc4random()];
}
//回車換行符
static NSString * const kAFMultipartFormCRLF = @"\r\n";
//生成一個(gè)request的請求體中的參數(shù)的開始符號视哑，第一個(gè)
static inline NSString * AFMultipartFormInitialBoundary(NSString *boundary) {
    return [NSString stringWithFormat:@"--%@%@", boundary, kAFMultipartFormCRLF];
}
//生成一個(gè)request的請求體中的參數(shù)的開始符號，菲第一個(gè)誊涯。
static inline NSString * AFMultipartFormEncapsulationBoundary(NSString *boundary) {
    return [NSString stringWithFormat:@"%@--%@%@", kAFMultipartFormCRLF, boundary, kAFMultipartFormCRLF];
}
//生成一個(gè)request的請求體中的參數(shù)的結(jié)束符號
static inline NSString * AFMultipartFormFinalBoundary(NSString *boundary) {
    return [NSString stringWithFormat:@"%@--%@--%@", kAFMultipartFormCRLF, boundary, kAFMultipartFormCRLF];
}
/*
根據(jù)文件的擴(kuò)展名獲取文件的`MIMEType`
 */
static inline NSString * AFContentTypeForPathExtension(NSString *extension) {
    NSString *UTI = (__bridge_transfer NSString *)UTTypeCreatePreferredIdentifierForTag(kUTTagClassFilenameExtension, (__bridge CFStringRef)extension, NULL);
    NSString *contentType = (__bridge_transfer NSString *)UTTypeCopyPreferredTagWithClass((__bridge CFStringRef)UTI, kUTTagClassMIMEType);
    if (!contentType) {
        return @"application/octet-stream";
    } else {
        return contentType;
    }
}

AFStreamingMultipartFormData負(fù)責(zé)multipart/form-data的Body的具體構(gòu)建挡毅。比如boundary的指定、請求體數(shù)據(jù)的拼接等暴构。

- (instancetype)initWithURLRequest:(NSMutableURLRequest *)urlRequest
                    stringEncoding:(NSStringEncoding)encoding
{
    self = [super init];
    if (!self) {
        return nil;
    }
    //需要添加httpbody的request
    self.request = urlRequest;
    //字符編碼
    self.stringEncoding = encoding;
    //指定boundary
    self.boundary = AFCreateMultipartFormBoundary();
    //這個(gè)屬性用于存儲httpbody數(shù)據(jù)
    self.bodyStream = [[AFMultipartBodyStream alloc] initWithStringEncoding:encoding];
    return self;
}
/*
 根據(jù)文件的url添加一個(gè)`multipart/form-data`請求的請求體域
 */
- (BOOL)appendPartWithFileURL:(NSURL *)fileURL
                         name:(NSString *)name
                        error:(NSError * __autoreleasing *)error
{
    NSParameterAssert(fileURL);
    NSParameterAssert(name);
    //文件擴(kuò)展名
    NSString *fileName = [fileURL lastPathComponent];
    //獲取文件的mimetype的類型
    NSString *mimeType = AFContentTypeForPathExtension([fileURL pathExtension]);

    return [self appendPartWithFileURL:fileURL name:name fileName:fileName mimeType:mimeType error:error];
}

/**
 根據(jù)指定類型的fileurl跪呈，把數(shù)據(jù)添加進(jìn)入bodyStream中。以提供給后面構(gòu)建request的body取逾。

 @param fileURL 文件的url
 @param name 參數(shù)名稱
 @param fileName 文件名稱
 @param mimeType 文件類型
 @param error 錯(cuò)誤
 @return 是否成功
 */
- (BOOL)appendPartWithFileURL:(NSURL *)fileURL
                         name:(NSString *)name
                     fileName:(NSString *)fileName
                     mimeType:(NSString *)mimeType
                        error:(NSError * __autoreleasing *)error
{
    NSParameterAssert(fileURL);
    NSParameterAssert(name);
    NSParameterAssert(fileName);
    NSParameterAssert(mimeType);
    /*
     各種錯(cuò)誤情況判斷
     */
    if (![fileURL isFileURL]) {
        NSDictionary *userInfo = @{NSLocalizedFailureReasonErrorKey: NSLocalizedStringFromTable(@"Expected URL to be a file URL", @"AFNetworking", nil)};
        if (error) {
            *error = [[NSError alloc] initWithDomain:AFURLRequestSerializationErrorDomain code:NSURLErrorBadURL userInfo:userInfo];
        }
        return NO;
    } else if ([fileURL checkResourceIsReachableAndReturnError:error] == NO) {
        NSDictionary *userInfo = @{NSLocalizedFailureReasonErrorKey: NSLocalizedStringFromTable(@"File URL not reachable.", @"AFNetworking", nil)};
        if (error) {
            *error = [[NSError alloc] initWithDomain:AFURLRequestSerializationErrorDomain code:NSURLErrorBadURL userInfo:userInfo];
        }
        return NO;
    }
    //獲取指定路徑文件的屬性
    NSDictionary *fileAttributes = [[NSFileManager defaultManager] attributesOfItemAtPath:[fileURL path] error:error];
    if (!fileAttributes) {
        return NO;
    }
    //添加`Content-Disposition`和`Content-Type`這兩個(gè)請求體域
    NSMutableDictionary *mutableHeaders = [NSMutableDictionary dictionary];
    [mutableHeaders setValue:[NSString stringWithFormat:@"form-data; name=\"%@\"; filename=\"%@\"", name, fileName] forKey:@"Content-Disposition"];
    [mutableHeaders setValue:mimeType forKey:@"Content-Type"];
    //把一個(gè)完整的請求體域封裝進(jìn)一個(gè)`AFHTTPBodyPart`對象中耗绿。
    AFHTTPBodyPart *bodyPart = [[AFHTTPBodyPart alloc] init];
    bodyPart.stringEncoding = self.stringEncoding;
    bodyPart.headers = mutableHeaders;
    bodyPart.boundary = self.boundary;
    bodyPart.body = fileURL;
    bodyPart.bodyContentLength = [fileAttributes[NSFileSize] unsignedLongLongValue];
    [self.bodyStream appendHTTPBodyPart:bodyPart];

    return YES;
}
/**
 根據(jù)指定類型的數(shù)據(jù)流，把數(shù)據(jù)添加進(jìn)入bodyStream中砾隅。以提供給后面構(gòu)建request的body误阻。
 
 @param inputStream 輸入的數(shù)據(jù)流
 @param name 參數(shù)名稱
 @param fileName 文件名稱
 @param mimeType 文件類型
 */
- (void)appendPartWithInputStream:(NSInputStream *)inputStream
                             name:(NSString *)name
                         fileName:(NSString *)fileName
                           length:(int64_t)length
                         mimeType:(NSString *)mimeType
{
    NSParameterAssert(name);
    NSParameterAssert(fileName);
    NSParameterAssert(mimeType);
    //添加`Content-Disposition`和`Content-Type`這兩個(gè)請求體域
    NSMutableDictionary *mutableHeaders = [NSMutableDictionary dictionary];
    [mutableHeaders setValue:[NSString stringWithFormat:@"form-data; name=\"%@\"; filename=\"%@\"", name, fileName] forKey:@"Content-Disposition"];
    [mutableHeaders setValue:mimeType forKey:@"Content-Type"];
    //把一個(gè)完整的請求體域封裝進(jìn)一個(gè)`AFHTTPBodyPart`對象中
    AFHTTPBodyPart *bodyPart = [[AFHTTPBodyPart alloc] init];
    bodyPart.stringEncoding = self.stringEncoding;
    bodyPart.headers = mutableHeaders;
    bodyPart.boundary = self.boundary;
    bodyPart.body = inputStream;
    bodyPart.bodyContentLength = (unsigned long long)length;
    [self.bodyStream appendHTTPBodyPart:bodyPart];
}

/**
 根據(jù)指定的data添加到請求體域中

 @param data 數(shù)據(jù)
 @param name 名稱
 @param fileName 文件名稱
 @param mimeType mimeType
 */
- (void)appendPartWithFileData:(NSData *)data
                          name:(NSString *)name
                      fileName:(NSString *)fileName
                      mimeType:(NSString *)mimeType
{
    NSParameterAssert(name);
    NSParameterAssert(fileName);
    NSParameterAssert(mimeType);

    NSMutableDictionary *mutableHeaders = [NSMutableDictionary dictionary];
    [mutableHeaders setValue:[NSString stringWithFormat:@"form-data; name=\"%@\"; filename=\"%@\"", name, fileName] forKey:@"Content-Disposition"];
    [mutableHeaders setValue:mimeType forKey:@"Content-Type"];
    
    [self appendPartWithHeaders:mutableHeaders body:data];
}

/**
 根據(jù)指定的key和value拼接到`Content-Disposition`屬性中

 @param data 參數(shù)值
 @param name 參數(shù)名
 */
- (void)appendPartWithFormData:(NSData *)data
                          name:(NSString *)name
{
    NSParameterAssert(name);

    NSMutableDictionary *mutableHeaders = [NSMutableDictionary dictionary];
    [mutableHeaders setValue:[NSString stringWithFormat:@"form-data; name=\"%@\"", name] forKey:@"Content-Disposition"];
    //把處理好的數(shù)據(jù)加入對應(yīng)的request的請求體中`Content-Disposition`部分
    [self appendPartWithHeaders:mutableHeaders body:data];
}

/**
 給一個(gè)multipartForm的`Content-Disposition`添加boundary

 @param headers 請求頭域
 @param body 值
 */
- (void)appendPartWithHeaders:(NSDictionary *)headers
                         body:(NSData *)body
{
    NSParameterAssert(body);

    AFHTTPBodyPart *bodyPart = [[AFHTTPBodyPart alloc] init];
    bodyPart.stringEncoding = self.stringEncoding;
    bodyPart.headers = headers;
    bodyPart.boundary = self.boundary;
    bodyPart.bodyContentLength = [body length];
    bodyPart.body = body;

    [self.bodyStream appendHTTPBodyPart:bodyPart];
}

- (void)throttleBandwidthWithPacketSize:(NSUInteger)numberOfBytes
                                  delay:(NSTimeInterval)delay
{
    self.bodyStream.numberOfBytesInPacket = numberOfBytes;
    self.bodyStream.delay = delay;
}

/**
 根據(jù)一個(gè)request對應(yīng)的`AFStreamingMultipartFormData`對象獲取封裝好的request對象

 @return multipart/form的request對象
 */
- (NSMutableURLRequest *)requestByFinalizingMultipartFormData {
    if ([self.bodyStream isEmpty]) {
        return self.request;
    }
    // Reset the initial and final boundaries to ensure correct Content-Length
    //重置boundary，從而確保`Content-Length`正確
    [self.bodyStream setInitialAndFinalBoundaries];
    //把拼接好的bodyStream添加進(jìn)入request中
    [self.request setHTTPBodyStream:self.bodyStream];
    //給requst的請求頭添加Content-Type屬性指定為`multipart/form-data`類型的request晴埂。同時(shí)設(shè)置請求體的長度Content-Length究反。
    [self.request setValue:[NSString stringWithFormat:@"multipart/form-data; boundary=%@", self.boundary] forHTTPHeaderField:@"Content-Type"];
    [self.request setValue:[NSString stringWithFormat:@"%llu", [self.bodyStream contentLength]] forHTTPHeaderField:@"Content-Length"];
    return self.request;
}

AFJSONRequestSerializer和AFPropertyListRequestSerializer

這兩個(gè)類繼承自AFHTTPRequestSerializer。他們的基本實(shí)現(xiàn)都是繼承自父類邑时。但是也根據(jù)自身不同情況，做了處理特姐。

對于AFJSONRequestSerializer晶丘。需要把Content-Type指定為"application/json。同時(shí)HTTPBody
需要使用JSON序列化：

- (NSURLRequest *)requestBySerializingRequest:(NSURLRequest *)request
                               withParameters:(id)parameters
                                        error:(NSError *__autoreleasing *)error
{
    NSParameterAssert(request);
    /*
     對于`GET`,`HEAD`,`DELETE`等方法中。直接使用父類的處理方式
     */
    if ([self.HTTPMethodsEncodingParametersInURI containsObject:[[request HTTPMethod] uppercaseString]]) {
        return [super requestBySerializingRequest:request withParameters:parameters error:error];
    }
    NSMutableURLRequest *mutableRequest = [request mutableCopy];
    //把`HTTPRequestHeaders`中的值添加進(jìn)入請求頭中浅浮。
    [self.HTTPRequestHeaders enumerateKeysAndObjectsUsingBlock:^(id field, id value, BOOL * __unused stop) {
        if (![request valueForHTTPHeaderField:field]) {
            [mutableRequest setValue:value forHTTPHeaderField:field];
        }
    }];
    if (parameters) {
        //設(shè)置請求頭的`Content-Type`類型
        if (![mutableRequest valueForHTTPHeaderField:@"Content-Type"]) {
            [mutableRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
        }

        if (![NSJSONSerialization isValidJSONObject:parameters]) {
            if (error) {
                NSDictionary *userInfo = @{NSLocalizedFailureReasonErrorKey: NSLocalizedStringFromTable(@"The `parameters` argument is not valid JSON.", @"AFNetworking", nil)};
                *error = [[NSError alloc] initWithDomain:AFURLRequestSerializationErrorDomain code:NSURLErrorCannotDecodeContentData userInfo:userInfo];
            }
            return nil;
        }
        //把parameters轉(zhuǎn)換為JSON序列化的data
        NSData *jsonData = [NSJSONSerialization dataWithJSONObject:parameters options:self.writingOptions error:error];
        if (!jsonData) {
            return nil;
        }
        //JSON序列化的數(shù)據(jù)設(shè)置為httpbody
        [mutableRequest setHTTPBody:jsonData];
    }
    return mutableRequest;
}

對于AFPropertyListRequestSerializer也是同樣的道理：

- (NSURLRequest *)requestBySerializingRequest:(NSURLRequest *)request
                               withParameters:(id)parameters
                                        error:(NSError *__autoreleasing *)error
{
    NSParameterAssert(request);
    /*
     對于`GET`,`HEAD`,`DELETE`等方法中沫浆。直接使用父類的處理方式
     */
    if ([self.HTTPMethodsEncodingParametersInURI containsObject:[[request HTTPMethod] uppercaseString]]) {
        return [super requestBySerializingRequest:request withParameters:parameters error:error];
    }
    NSMutableURLRequest *mutableRequest = [request mutableCopy];
    //把`HTTPRequestHeaders`中的值添加進(jìn)入請求頭中。
    [self.HTTPRequestHeaders enumerateKeysAndObjectsUsingBlock:^(id field, id value, BOOL * __unused stop) {
        if (![request valueForHTTPHeaderField:field]) {
            [mutableRequest setValue:value forHTTPHeaderField:field];
        }
    }];
    if (parameters) {
        //設(shè)置請求頭的`Content-Type`類型
        if (![mutableRequest valueForHTTPHeaderField:@"Content-Type"]) {
            [mutableRequest setValue:@"application/x-plist" forHTTPHeaderField:@"Content-Type"];
        }
        //把parameters轉(zhuǎn)換為Plist序列化的data
        NSData *plistData = [NSPropertyListSerialization dataWithPropertyList:parameters format:self.format options:self.writeOptions error:error];
        if (!plistData) {
            return nil;
        }
        //Plist序列化的數(shù)據(jù)設(shè)置為httpbody
        [mutableRequest setHTTPBody:plistData];
    }
    return mutableRequest;
}

總結(jié)

這個(gè)類主要實(shí)現(xiàn)了對于不同情況的請求的request對象的封裝滚秩。尤其是對于multipart/form-data類型的request的封裝专执，簡化了我們自己封裝過程的痛苦。如果我們要使用multipart/form-data類型的請求郁油。強(qiáng)烈推薦使用AFHTTPSessionManager對象的AFHTTPRequestSerialization來處理參數(shù)的序列化過程本股。下面就是使用AFHTTPRequestSerailization序列化和自己拼裝的不同：

- (IBAction)updatePic:(id)sender {
    //請求頭參數(shù)
    NSDictionary *dic = @{
                          @"businessType":@"CC_USER_CENTER",
                          @"fileType":@"image",
                          @"file":@"img.jpeg"
                          };
    //請求體圖片數(shù)據(jù)
    NSData *imageData = UIImagePNGRepresentation([UIImage imageNamed:@"1.png"]);
    //創(chuàng)建request
    NSMutableURLRequest *request = [[NSMutableURLRequest alloc]initWithURL:[NSURL URLWithString:url]];
    //post方法
    [request setHTTPMethod:@"POST"];
    AFHTTPSessionManager *manager = [[AFHTTPSessionManager alloc]initWithSessionConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration]];
    NSURLSessionDataTask *task = [manager POST:url parameters:dic constructingBodyWithBlock:^(id<AFMultipartFormData>  _Nonnull formData) {
        //請求體里面的參數(shù)
        NSDictionary *bodyDic = @{
                                  @"Content-Disposition":@"form-data;name=\"file\";filename=\"img.jpeg\"",
                                  @"Content-Type":@"image/png",
                                  };
        [formData appendPartWithHeaders:bodyDic body:imageData];
    } progress:^(NSProgress * _Nonnull uploadProgress) {
        NSLog(@"下載進(jìn)度");
    } success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
        NSLog(@"下載成功:%@",responseObject);
    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"下載失敗%@",error);
    }];
    [task resume];
}
- (IBAction)multipartformPost3:(id)sender {
    //參數(shù)
    NSDictionary *dic = @{
                          @"businessType":@"CC_USER_CENTER",
                          @"fileType":@"image",
                          @"file":@"img.jpeg"
                          };
    NSString *boundaryString = @"xxxxx";
    NSMutableString *str = [NSMutableString string];
    [dic enumerateKeysAndObjectsUsingBlock:^(id  _Nonnull key, id  _Nonnull obj, BOOL * _Nonnull stop) {
        [str appendFormat:@"--%@\r\n",boundaryString];
        [str appendFormat:@"%@name=\"%@\"\r\n\r\n",@"Content-Disposition: form-data;",key];
        [str appendFormat:@"%@\r\n",obj];
    }];
    
    NSMutableData *requestMutableData=[NSMutableData data];
    
    [str appendFormat:@"--%@\r\n",boundaryString];
    [str appendFormat:@"%@:%@",@"Content-Disposition",@"form-data;"];
    [str appendFormat:@"%@=\"%@\";",@"name",@"file"];
    [str appendFormat:@"%@=\"%@\"\r\n",@"filename",@"img1.jpeg"];
    [str appendFormat:@"%@:%@\r\n\r\n",@"Content-Type",@"image/png"];
    //轉(zhuǎn)換成為二進(jìn)制數(shù)據(jù)
    [requestMutableData appendData:[str dataUsingEncoding:NSUTF8StringEncoding]];
    NSData *imageData = UIImagePNGRepresentation([UIImage imageNamed:@"1.png"]);
    //文件數(shù)據(jù)部分
    [requestMutableData appendData:imageData];
    //添加結(jié)尾boundary
    [requestMutableData appendData:[[NSString stringWithFormat:@"\r\n--%@--\r\n",boundaryString] dataUsingEncoding:NSUTF8StringEncoding]];

    
    NSMutableURLRequest *request = [[NSMutableURLRequest alloc]initWithURL:[NSURL URLWithString:url]];
    //post方法
    [request setHTTPMethod:@"POST"];
    // 設(shè)置請求頭格式為Content-Type:multipart/form-data; boundary=xxxxx
    [request setValue:[NSString stringWithFormat:@"multipart/form-data; boundary=%@",boundaryString] forHTTPHeaderField:@"Content-Type"];
    request.HTTPBody = requestMutableData;
    
    NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration]];
    NSURLSessionDataTask *task = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        NSString *result = [[NSString alloc]initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@",result);
    }];
    
    [task resume];

}