AFNetworking源碼之Serialization模塊
本篇我們來看AFNetworking的下一個(gè)模塊Serialization
其中包括AFURLRequestSerialization和AFURLResponseSerialization兩個(gè)類
我們主要講AFURLRequestSerialization,因?yàn)锳FURLRequestSerialization的實(shí)現(xiàn)比AFURLResponseSerialization復(fù)雜得多,我們理解了AFURLRequestSerialization就不難理解AFURLResponseSerialization了诵闭。
AFURLRequestSerialization的作用是協(xié)助構(gòu)建NSURLRequest
其主要實(shí)現(xiàn)以下兩個(gè)功能:
1.構(gòu)建普通請求:格式化請求參數(shù),生成HTTP Header疲牵。
2.構(gòu)建multipart請求。
1.構(gòu)建普通請求
格式化請求參數(shù) 一般我們請求都會(huì)按key=value的方式帶上各種參數(shù)榆鼠,GET方法參數(shù)直接加在URL上纲爸,POST方法放在body上,NSURLRequest沒有封裝好這個(gè)參數(shù)的解析妆够,只能我們自己拼好字符串识啦。AFNetworking提供了接口,讓參數(shù)可以是NSDictionary, NSArray, NSSet這些類型神妹,再由內(nèi)部解析成字符串后賦給NSURLRequest袁滥。
轉(zhuǎn)換分為三部分:
第一部分是用戶傳進(jìn)來的數(shù)據(jù),支持包含
NSArray,NSDictionary,NSSet這三種數(shù)據(jù)結(jié)構(gòu)灾螃。
第二部分是轉(zhuǎn)換成
AFNetworking內(nèi)自己的數(shù)據(jù)結(jié)構(gòu)题翻,每一個(gè)key-value對都用一個(gè)對象AFQueryStringPair表示,作用是最后可以根據(jù)不同的字符串編碼生成各自的key=value字符串腰鬼。主要函數(shù)是AFQueryStringPairsFromKeyAndValue嵌赠。
第三部分是最后生成
NSURLRequest可用的字符串?dāng)?shù)據(jù),并且對參數(shù)進(jìn)行url編碼熄赡,在AFQueryStringFromParametersWithEncoding這個(gè)函數(shù)里姜挺。
最后在把數(shù)據(jù)賦給NSURLRequest時(shí)根據(jù)不同的HTTP方法分別處理,對于
GET/HEAD/DELETE方法彼硫,把參數(shù)加到URL后面炊豪,對于其他如POST/PUT方法,把數(shù)據(jù)加到body上拧篮,并設(shè)好HTTP頭词渤,告訴服務(wù)端字符串的編碼。
相關(guān)代碼:
創(chuàng)建管理路口:
- (instancetype)initWithBaseURL:(NSURL *)url
sessionConfiguration:(NSURLSessionConfiguration *)configuration
{
self = [super initWithSessionConfiguration:configuration];
if (!self) {
return nil;
}
// Ensure terminal slash for baseURL path, so that NSURL +URLWithString:relativeToURL: works as expected
if ([[url path] length] > 0 && ![[url absoluteString] hasSuffix:@"/"]) {
url = [url URLByAppendingPathComponent:@""];
}
self.baseURL = url;
self.requestSerializer = [AFHTTPRequestSerializer serializer];
self.responseSerializer = [AFJSONResponseSerializer serializer];
return self;
}
構(gòu)建普通請求:格式化請求參數(shù)串绩,生成HTTP Header
self.requestSerializer = [AFHTTPRequestSerializer serializer];
+ (instancetype)serializer {
return [[self alloc] init];
}
- (instancetype)init {
self = [super init];
if (!self) {
return nil;
}
self.stringEncoding = NSUTF8StringEncoding;
self.mutableHTTPRequestHeaders = [NSMutableDictionary dictionary];
// Accept-Language HTTP Header; see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.4
NSMutableArray *acceptLanguagesComponents = [NSMutableArray array];
[[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;
}];
[self setValue:[acceptLanguagesComponents componentsJoinedByString:@", "] forHTTPHeaderField:@"Accept-Language"];
NSString *userAgent = nil;
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wgnu"
#if TARGET_OS_IOS
// User-Agent Header; see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.43
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]];
#elif TARGET_OS_WATCH
// User-Agent Header; see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.43
userAgent = [NSString stringWithFormat:@"%@/%@ (%@; watchOS %@; 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], [[WKInterfaceDevice currentDevice] model], [[WKInterfaceDevice currentDevice] systemVersion], [[WKInterfaceDevice currentDevice] screenScale]];
#elif defined(__MAC_OS_X_VERSION_MIN_REQUIRED)
userAgent = [NSString stringWithFormat:@"%@/%@ (Mac OS X %@)", [[NSBundle mainBundle] infoDictionary][(__bridge NSString *)kCFBundleExecutableKey] ?: [[NSBundle mainBundle] infoDictionary][(__bridge NSString *)kCFBundleIdentifierKey], [[NSBundle mainBundle] infoDictionary][@"CFBundleShortVersionString"] ?: [[NSBundle mainBundle] infoDictionary][(__bridge NSString *)kCFBundleVersionKey], [[NSProcessInfo processInfo] operatingSystemVersionString]];
#endif
#pragma clang diagnostic pop
if (userAgent) {
if (![userAgent canBeConvertedToEncoding:NSASCIIStringEncoding]) {
NSMutableString *mutableUserAgent = [userAgent mutableCopy];
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
self.HTTPMethodsEncodingParametersInURI = [NSSet setWithObjects:@"GET", @"HEAD", @"DELETE", nil];
self.mutableObservedChangedKeyPaths = [NSMutableSet set];
for (NSString *keyPath in AFHTTPRequestSerializerObservedKeyPaths()) {
if ([self respondsToSelector:NSSelectorFromString(keyPath)]) {
[self addObserver:self forKeyPath:keyPath options:NSKeyValueObservingOptionNew context:AFHTTPRequestSerializerObserverContext];
}
}
return self;
}
數(shù)據(jù)格式:
self.responseSerializer = [AFJSONResponseSerializer serializer];
+ (instancetype)serializer {
return [self serializerWithReadingOptions:(NSJSONReadingOptions)0];
}
+ (instancetype)serializerWithReadingOptions:(NSJSONReadingOptions)readingOptions {
AFJSONResponseSerializer *serializer = [[self alloc] init];
serializer.readingOptions = readingOptions;
return serializer;
}
- (instancetype)init {
self = [super init];
if (!self) {
return nil;
}
self.acceptableContentTypes = [NSSet setWithObjects:@"application/json", @"text/json", @"text/javascript", nil];
return self;
}