AFNetworking毫無疑問是目前iOS開發(fā)中(Objective-C)最好的第三方網(wǎng)絡(luò)庫。一般規(guī)模的app使用AFNetworking就可以完成所有需求,不需要自己造輪子顽分。
在使用AFNetworking的過程中遇到了許多坑司志,也獲得了不少經(jīng)驗(yàn)佃乘,在這里總結(jié)一下凳谦,希望能夠幫助到大家。
AFNetworking進(jìn)一步封裝
AFNetworking 3.x 已經(jīng)為我們提供了豐富而且易用的API犁功,但還是不夠氓轰。AFNetworking是一個(gè)通用的庫,而在我們自己的項(xiàng)目中浸卦,有特定的需求署鸡,而且往往在許多類中都需要用到網(wǎng)絡(luò)請(qǐng)求。對(duì)AFNetworking進(jìn)一步封裝限嫌,能夠大大簡化代碼靴庆,減少重復(fù)。
舉個(gè)例子怒医,新建一個(gè)CDMNetworkManager類炉抒,繼承AFHTTPSessionManager。
//CDMNetworkManager.h
#import <AFNetworking/AFNetworking.h>
typedef void(^requestSuccessBlock) (NSURLSessionTask *task, id resposeObject);
typedef void(^requestFailureBlock) (NSURLSessionTask *task, NSError *error);
@interface CDMNetworkManager : AFHTTPSessionManager
+(instancetype)sharedManager;
-(void)sendPostRequest:(NSString *)path parameters:(NSDictionary *)parameters success:(requestSuccessBlock)success failure:(requestFailureBlock)failure;
//CDMNetworkManager.m
#import "CDMNetworkManager.h"
typedef void(^requestSuccessBlock) (NSURLSessionTask *task, id resposeObject);
typedef void(^requestFailureBlock) (NSURLSessionTask *task, NSError *error);
@implementation CDMNetworkManager
+(instancetype)sharedManager{
static CDMNetworkManager *manager = nil;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
manager = [[self alloc] initWithBaseURL:[NSURL URLWithString:@"http://www.someurl.com/"]];
});
return manager;
}
-(void)sendPostRequest:(NSString *)path parameters:(NSDictionary *)parameters success:(requestSuccessBlock)success failure:(requestFailureBlock)failure{
[self POST:path parameters:parameters progress:nil success:^(NSURLSessionTask *task, id responseObject){
success(task,responseObject);
} failure:^(NSURLSessionTask *task, NSError *error){
failure(task,error);
}];
}
初始化方法中使用了單例模式稚叹,這樣與服務(wù)器的連接不會(huì)斷掉焰薄,省去了每次建立連接時(shí)三次握手等過程。如果有多個(gè)URL地址扒袖,可以創(chuàng)建多個(gè)單例塞茅。如果有更多特殊的要求,比如設(shè)置超時(shí)時(shí)間等季率,可以在這個(gè)方法中設(shè)置野瘦。
具體的網(wǎng)絡(luò)請(qǐng)求方法這里只封裝了一個(gè)簡單的post方法,如果有需要可以封裝別的方法飒泻。
調(diào)用的時(shí)候很簡單鞭光,在任何一個(gè)需要發(fā)送post請(qǐng)求的類中:
[[CDMNetworkManager sharedManager] sendPostRequest:@"XXX" parameters:parameter success:^(NSURLSessionTask *task, id responseObject){
//your code
} failure:^(NSURLSessionTask *task, NSError *error){
// your code
}];
調(diào)試工具
曾經(jīng)我每次網(wǎng)絡(luò)請(qǐng)求調(diào)試的時(shí)候只會(huì)在回調(diào)里寫log,然后在控制臺(tái)里一行一行的仔細(xì)查找泞遗。如果這個(gè)請(qǐng)求返回的內(nèi)容很多衰猛,在Xcode里的顯示效果就很差,而且不能直接顯示中文刹孔。體驗(yàn)很差!
這時(shí)候需要神器Charles
上面是Charles的截圖,能夠監(jiān)聽Mac的所有網(wǎng)絡(luò)請(qǐng)求并且顯示各種格式的內(nèi)容髓霞,非常好用卦睹。如果用模擬器的話就可以直接用Charles抓包,如果真機(jī)調(diào)試的話方库,需要設(shè)置一下iPhone结序,網(wǎng)上也有很多教程。
雖然是付費(fèi)軟件纵潦,但是不買license只是打開時(shí)會(huì)有10秒延時(shí)徐鹤,每隔30分鐘自動(dòng)關(guān)閉。
常見錯(cuò)誤
Error Domain=com.alamofire.error.serialization.response Code=-1016 "Request failed: unacceptable content-type: text/html"
出現(xiàn)這個(gè)問題的原因有很多邀层,從表面上看是返回?cái)?shù)據(jù)的格式不支持text/html返敬,但是為什么返回了text/html?原因不唯一寥院。
首先要看請(qǐng)求的response code劲赠,如果是200,說明請(qǐng)求已經(jīng)傳到服務(wù)器并且成功返回秸谢,返回的格式是text/html凛澎。AFNetworking的默認(rèn)response serializer是AFJSONResponseSerializer,不支持text/html估蹄。
這時(shí)需要在manager的初始化方法中增加一下代碼塑煎。或者與服務(wù)器開發(fā)人員溝通臭蚁,改寫服務(wù)器端最铁。
manager.responseSerializer.acceptableContentTypes = [manager.responseSerializer.acceptableContentTypes setByAddingObject:@"text/html"];
如果response code是400,說明服務(wù)器根本沒有收到請(qǐng)求刊棕。這時(shí)為什么返回了一個(gè)text/html的數(shù)據(jù)呢炭晒?返回的數(shù)據(jù)在Xcode控制臺(tái)上顯示為16進(jìn)制,但是在Charles里我們可以看到結(jié)果
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>請(qǐng)求錯(cuò)誤</title>
<style>BODY { color: #000000; background-color: white; font-family: Verdana; margin-left: 0px; margin-top: 0px; } #content { margin-left: 30px; font-size: .70em; padding-bottom: 2em; } A:link { color: #336699; font-weight: bold; text-decoration: underline; } A:visited { color: #6699cc; font-weight: bold; text-decoration: underline; } A:active { color: #336699; font-weight: bold; text-decoration: underline; } .heading1 { background-color: #003366; border-bottom: #336699 6px solid; color: #ffffff; font-family: Tahoma; font-size: 26px; font-weight: normal;margin: 0em 0em 10px -20px; padding-bottom: 8px; padding-left: 30px;padding-top: 16px;} pre { font-size:small; background-color: #e5e5cc; padding: 5px; font-family: Courier New; margin-top: 0px; border: 1px #f0f0e0 solid; white-space: pre-wrap; white-space: -pre-wrap; word-wrap: break-word; } table { border-collapse: collapse; border-spacing: 0px; font-family: Verdana;} table th { border-right: 2px white solid; border-bottom: 2px white solid; font-weight: bold; background-color: #cecf9c;} table td { border-right: 2px white solid; border-bottom: 2px white solid; background-color: #e5e5cc;}</style>
</head>
<body>
<div id="content">
<p class="heading1">請(qǐng)求錯(cuò)誤</p>
<p xmlns="">服務(wù)器處理請(qǐng)求時(shí)遇到錯(cuò)誤甥角。有關(guān)構(gòu)造有效服務(wù)請(qǐng)求的內(nèi)容网严,請(qǐng)參閱<a rel="help-page" >服務(wù)幫助頁</a>。</p>
</div>
</body>
</html>
這是自動(dòng)返回的一個(gè)錯(cuò)誤頁面嗤无,而不是服務(wù)器返回的數(shù)據(jù)格式不對(duì)震束。這時(shí)候再去找response serializer的問題就南轅北轍了。
那么為什么服務(wù)器沒有受到請(qǐng)求当犯?
一種可能是baseURL的問題垢村。AFHTTPSessionManager的初始化中用到了baseURL,與之后的path拼接時(shí)可能出錯(cuò)嚎卫,檢查一下嘉栓。
還有可能是request serializer的問題。AFNetworking默認(rèn)的是AFHTTPRequestSerializer。如果服務(wù)器接受的參數(shù)只能是json的話侵佃,需要使用AFJSONRequestSerializer麻昼。
self.requestSerializer = [AFJSONRequestSerializer serializer];
可能還有其他各種各樣奇怪的原因,歡迎大家補(bǔ)充馋辈。
作者時(shí)間抚芦、能力有限,文章難免有不足之處迈螟,請(qǐng)大家指正叉抡。