本篇文章介紹傳說(shuō)中的 AFN 框架的使用
專注于為中小企業(yè)提供成都網(wǎng)站設(shè)計(jì)、成都網(wǎng)站建設(shè)服務(wù),電腦端+手機(jī)端+微信端的三站合一,更高效的管理,為中小企業(yè)友誼免費(fèi)做網(wǎng)站提供優(yōu)質(zhì)的服務(wù)。我們立足成都,凝聚了一批互聯(lián)網(wǎng)行業(yè)人才,有力地推動(dòng)了上千家企業(yè)的穩(wěn)健成長(zhǎng),幫助中小企業(yè)通過(guò)網(wǎng)站建設(shè)實(shí)現(xiàn)規(guī)模擴(kuò)充和轉(zhuǎn)變。
AFNetworking是iOS開發(fā)中最廣泛使用的開源項(xiàng)目之一,是最活躍最有影響力的開源項(xiàng)目之一。
源自一個(gè)LBS項(xiàng)目,成功代替了ASIHTTPRequest成為了主流的網(wǎng)絡(luò)解決方案。
AFN將NSURLConnection與NSOperation結(jié)合(內(nèi)部使用GCD),并在2.0版本開始兼容NSURLSession
使用AFN發(fā)送請(qǐng)求可以使用兩種方式:
AFHTTPRequestOperationManager和AFURessionManager
如果是數(shù)據(jù)任務(wù)推薦使用第一種,如果是下載/上傳任務(wù)推薦使用第二種
使用AFHTTPRequestOperationManager
這個(gè)類的對(duì)象,能夠非常方便的創(chuàng)建并發(fā)起各種HTTP請(qǐng)求
對(duì)象的創(chuàng)建:
+ (instancetype)manager
1)發(fā)起GET請(qǐng)求:
- (nullable AFHTTPRequestOperation *)GET:(NSString *)URLString parameters:(nullable id)parameters success:(nullable void ( ^ ) ( AFHTTPRequestOperation *operation , id responseObject ))success failure:(nullable void ( ^ ) ( AFHTTPRequestOperation *operation , NSError *error ))failure
參數(shù)URLString:請(qǐng)求的url
參數(shù)parameters:參數(shù)字典,GET請(qǐng)求的參數(shù)可以放在URL中也可以放在這里
使用@{key1:value1, key2:value2, ...} 代理 key1=value1&key2=value2&...
參數(shù)success:請(qǐng)求成功時(shí),執(zhí)行的block
參數(shù)failure:請(qǐng)求失敗時(shí),執(zhí)行的block
返回值:AFHTTPRequestOperation請(qǐng)求任務(wù)對(duì)象
如:
或?qū)?shù)放在parameters參數(shù)上
2)發(fā)起POST請(qǐng)求
- (nullable AFHTTPRequestOperation *)POST:(NSString *)URLString parameters:(nullable id)parameters success:(nullable void ( ^ ) ( AFHTTPRequestOperation *operation , id responseObject ))success failure:(nullable void ( ^ ) ( AFHTTPRequestOperation *operation , NSError *error ))failure
如:
請(qǐng)求對(duì)象的序列化工具
功能一:完成請(qǐng)求對(duì)象的功能
使用AFHTTPRequestOperationManager發(fā)送請(qǐng)求參數(shù)是NSURL而不是NSURLRequest;之前介紹過(guò),NSURLRequest中并不僅僅是NSURL,還可以:設(shè)置請(qǐng)求頭參數(shù)、設(shè)置緩存策略、設(shè)置請(qǐng)求超時(shí)等
這些功能由請(qǐng)求對(duì)象的序列化工具對(duì)象完成
功能二:請(qǐng)求的參數(shù)自動(dòng)序列化
除了完成這些本屬于NSURLRequest的任務(wù)外,還能實(shí)現(xiàn)將請(qǐng)求的參數(shù)(URL參數(shù)及請(qǐng)求體參數(shù))進(jìn)行序列化,由于很少服務(wù)器上請(qǐng)求要求傳遞JSON/XML數(shù)據(jù),所以這個(gè)功能很少使用
父類:AFHTTPRequestSerializer
子類:AFJSONRequestSerializer(默認(rèn)) AFPropertyListRequestSerializer ...
1)設(shè)置請(qǐng)求頭的參數(shù)
- (void)setValue:(nullable NSString *)valueforHTTPHeaderField:(NSString *)field - (nullable NSString *)valueForHTTPHeaderField:(NSString *)field @property (readonly, nonatomic, strong) NSDictionary *HTTPRequestHeaders
如:發(fā)送GET請(qǐng)求獲得用戶信息,要求傳入header參數(shù) Authorization=tokenID xxxxxx
2)設(shè)置緩存策略
@property (nonatomic, assign) NSURLRequestCachePolicy cachePolicy
3)通過(guò)序列化工具,可以設(shè)置請(qǐng)求超時(shí)
@property (nonatomic, assign) NSTimeInterval timeoutInterval
響應(yīng)對(duì)象的反序列化工具
功能一:將響應(yīng)數(shù)據(jù)反序列化
也就是說(shuō),如果接受到一個(gè)JSON數(shù)據(jù),它能幫助我們直接反序列化為OC基本數(shù)據(jù)對(duì)象
功能二:通過(guò)一些屬性的設(shè)定,可以限制接收哪些想要的響應(yīng)數(shù)據(jù)
父類:AFHTTPResponseSerializer
子類:AFJSONResponseSerializer AFPropertyListResponseSerializer AFImageResponseSerializer
AFXMLParserResponseSerializer AFXMLDocumentResponseSerializer
默認(rèn)是AFJSONResponseSerializer,因?yàn)榇蠖鄶?shù)的請(qǐng)求都是JSON類型
1)設(shè)置能夠正確接收的響應(yīng)數(shù)據(jù)類型(MIMETYPE):
@property (nonatomic, copy, nullable) NSSet *acceptableContentTypes
2)設(shè)置能夠正確接收的狀態(tài)碼:
@property (nonatomic, copy, nullable) NSIndexSet *acceptableStatusCodes
AFURLSessionManager
提供了對(duì)NSURLSession操作的封裝
創(chuàng)建數(shù)據(jù)任務(wù):
- (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request completionHandler:(nullable void ( ^ ) ( NSURLResponse *response , id responseObject , NSError *error ))completionHandler
manager的屬性:
// 完成block執(zhí)行所在任務(wù)隊(duì)列 @property (nonatomic, strong, nullable) dispatch_queue_t completionQueue // 請(qǐng)求執(zhí)行所在任務(wù)隊(duì)列 @property (readonly, nonatomic, strong) NSOperationQueue *operationQueue // 響應(yīng)對(duì)象的序列化工具 @property (nonatomic, strong) idresponseSerializer ...
下載任務(wù)及上傳任務(wù)在后面的文章介紹
AFNetworkingActivityIndicatorManager
用于方便地管理狀態(tài)欄上的網(wǎng)絡(luò)活動(dòng)指示器
獲得全局對(duì)象:
+ (instancetype)sharedManager
網(wǎng)絡(luò)活動(dòng)指示器的顯示狀態(tài):
@property (nonatomic, assign, getter=isEnabled) BOOL enabled @property (readonly, nonatomic, assign) BOOL isNetworkActivityIndicatorVisible
為了方便正確地控制指示器狀態(tài),在管理對(duì)象中包含一個(gè)整型的引用計(jì)數(shù),當(dāng)>0時(shí)顯示,==0時(shí)不顯示
在發(fā)起網(wǎng)絡(luò)請(qǐng)求前,使用下面的方法,對(duì)引用計(jì)數(shù)+1:
- (void)incrementActivityCount
在完成網(wǎng)絡(luò)請(qǐng)求后,使用下面的方法,對(duì)引用計(jì)數(shù)-1:
- (void)decrementActivityCount
AFNetworkReachabilityManager
用于檢測(cè)網(wǎng)絡(luò)的可達(dá)性,如:
[[AFNetworkReachabilityManager sharedManager] startMonitoring]; [[AFNetworkReachabilityManager sharedManager] setReachabilityStatusChangeBlock:^(AFNetworkReachabilityStatus status) { switch (status) { case AFNetworkReachabilityStatusNotReachable: NSLog(@"無(wú)網(wǎng)絡(luò)"); break; case AFNetworkReachabilityStatusReachableViaWiFi: NSLog(@"WiFi網(wǎng)絡(luò)”); break; case AFNetworkReachabilityStatusReachableViaWWAN: NSLog(@"無(wú)線網(wǎng)絡(luò)”); break; default: break; } }];
UIKit的分類
AFN框架和SDWebImage類似,也提供了很多UI控件的分類
AFNetworking源碼中的一些常用技巧
所有的單例都是用dispatch_once創(chuàng)建,保證只執(zhí)行一次
block中對(duì)self關(guān)鍵字的訪問(wèn),如代碼段:
__weak __typeof(self)weakSelf = self; self.backgroundTaskIdentifier = [application beginBackgroundTaskWithExpirationHandler:^{ __strong __typeof(weakSelf)strongSelf = weakSelf; }];
第一個(gè)weakSelf是為了block中不持有self,避免出現(xiàn)循環(huán)引用
第二個(gè)strongSelf是為了保證在block執(zhí)行過(guò)程中,這個(gè)self不會(huì)被釋放
常用類的說(shuō)明
AFURLRequestOperation繼承自NSOperation,描述網(wǎng)絡(luò)請(qǐng)求任務(wù)對(duì)象
管理著NSURLConnection,并實(shí)現(xiàn)了其代理方法
AFHTTPRequestOperation又是AFURLRequestOperation的子類
包含請(qǐng)求任務(wù)成功或失敗時(shí)需要執(zhí)行的block(實(shí)際上這些block是在代理方法中被調(diào)用)
AFHTTPRequestOperationManager用于快速創(chuàng)建AFHTTPRequestOperation并添加到任務(wù)隊(duì)列中
AFURLRequestSerialization用于幫助構(gòu)建NSURLRequest
格式化參數(shù):
一般我們請(qǐng)求都會(huì)按key=value的方式帶上各種參數(shù),GET方法參數(shù)直接加在URL上,POST方法放在body上,NSURLRequest沒有封裝好這個(gè)參數(shù)的解析,只能我們自己拼好字符串。AFNetworking提供了接口,讓參數(shù)可以是NSDictionary, NSArray, NSSet這些類型,再由內(nèi)部解析成字符串后賦給NSURLRequest。
轉(zhuǎn)化過(guò)程大致是這樣的: