AFNetWorking的介紹(給沒(méi)使用過(guò)的讀者看的)
- AFNetWorking是目前iOS開(kāi)發(fā)者網(wǎng)絡(luò)庫(kù)中最多的選擇
- AFNetWorking是對(duì)NSURLConnection和NSURLSession的封裝,iOS 9(AFN3.0版本)之后刪除了NSURLConnection的API的所有支持,完全基于NSURLSession 的API.
介紹下2.0版本跟3.0版本使用的區(qū)別
2.0版本:
使用 AFHTTPRequestOperationManager這個(gè)網(wǎng)絡(luò)管理者
AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];
[manager GET:@"需要請(qǐng)求的url" parameters:nil success:^(AFHTTPRequestOperation *operation, id responseObject) {
NSLog(@"請(qǐng)求成功");
} failure:^(AFHTTPRequestOperation *operation, NSError*error) {
NSLog(@"請(qǐng)求失敗");
}];
3.0版本:
使用 AFHTTPSessionManager 這個(gè)網(wǎng)絡(luò)管理者
AFHTTPSessionManager *session = [AFHTTPSessionManager manager];
[session GET:@"需要請(qǐng)求的url" parameters:nil success:^(NSURLSessionDataTask *task, id responseObject) {
NSLog(@"請(qǐng)求成功");
} failure:^(NSURLSessionDataTask *task, NSError *error) {
NSLog(@"請(qǐng)求失敗");
}];
為什么會(huì)廢棄NSURLConnection而使用NSURLSession這個(gè)網(wǎng)絡(luò)類(lèi)呢?
- 從iOS7之后,蘋(píng)果就推出了NSURLSession , AFN跟隨著蘋(píng)果的腳步,加入了對(duì)其的支持
- NSURLSession推出后蘋(píng)果大力推廣,但是其效果和NSURLConnection效果差不多,為什么NSURLConnection還會(huì)被廢棄呢?
- 因?yàn)?2015年的WWDC大會(huì),HTTP2.0時(shí)代的到來(lái),(1.1版本是99年),HTTP2.0比之前的版本速度更快
- iOS9(Xcode7)之后, NSURLSession開(kāi)始正式支持HTTP2.0,所以相比速度快差不多4倍, NSURLSession將NSURLConnection甩開(kāi)了距離
- 純屬個(gè)人理解
AFNetWorking的使用(直接上代碼)
- GET請(qǐng)求
-(void)get
{
//1.創(chuàng)建會(huì)話管理者
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
//2.封裝參數(shù)
NSDictionary *dict = @{
@"username":@"Lion",
@"pwd":@"1314",
@"type":@"JSON"
};
//3.發(fā)送GET請(qǐng)求
/*
第一個(gè)參數(shù):請(qǐng)求路徑(NSString)+ 不需要加參數(shù)
第二個(gè)參數(shù):發(fā)送給服務(wù)器的參數(shù)數(shù)據(jù)
第三個(gè)參數(shù):progress 進(jìn)度回調(diào)
第四個(gè)參數(shù):success 成功之后的回調(diào)(此處的成功或者是失敗指的是整個(gè)請(qǐng)求)
task:請(qǐng)求任務(wù)
responseObject:注意!!!響應(yīng)體信息--->(json--->oc))
task.response: 響應(yīng)頭信息
第五個(gè)參數(shù):failure 失敗之后的回調(diào)
*/
[manager GET:@"需要請(qǐng)求的URL" parameters:dict progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {
NSLog(@"success--%@--%@",[responseObject class],responseObject);
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
NSLog(@"failure--%@",error);
}];
}
- POST請(qǐng)求和GET請(qǐng)求一樣,只需要換成POST請(qǐng)求方法
[manager POST:@"需要請(qǐng)求的URL" parameters:dict progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {
NSLog(@"success--%@--%@",[responseObject class],responseObject);
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
NSLog(@"failure--%@",error);
}];
- 下載操作(不是離線下載,離線下載需要自己手動(dòng)處理)
-(void)download
{
//1.創(chuàng)建會(huì)話管理者
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
//2.確定請(qǐng)求路徑
NSURL *url = [NSURL URLWithString:@"需要請(qǐng)求的URL"];
//3.創(chuàng)建請(qǐng)求對(duì)象
NSURLRequest *request = [NSURLRequest requestWithURL:url];
//4.發(fā)送網(wǎng)絡(luò)請(qǐng)求下載文件
/*
第一個(gè)參數(shù):請(qǐng)求對(duì)象
第二個(gè)參數(shù):progress 進(jìn)度回調(diào)
downloadProgress
@property int64_t totalUnitCount;
@property int64_t completedUnitCount;
第三個(gè)參數(shù):destination 讓我們告訴系統(tǒng)應(yīng)該把文件存放到什么地方
內(nèi)部自動(dòng)的完成剪切處理
第四個(gè)參數(shù): completionHandler 完成之后的回調(diào)
response 響應(yīng)頭信息
filePath 文件最終的存儲(chǔ)路徑
error 錯(cuò)誤信息
*/
[[manager downloadTaskWithRequest:request progress:^(NSProgress * _Nonnull downloadProgress) {
NSLog(@"%f",1.0 * downloadProgress.completedUnitCount / downloadProgress.totalUnitCount);
} destination:^NSURL * _Nonnull(NSURL * _Nonnull targetPath, NSURLResponse * _Nonnull response) {
//拼接文件的全路徑
NSString *fullpath = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:response.suggestedFilename];
NSLog(@"fullpath == %@",fullpath);
return [NSURL fileURLWithPath:fullpath];
} completionHandler:^(NSURLResponse * _Nonnull response, NSURL * _Nullable filePath, NSError * _Nullable error) {
NSLog(@"%@",filePath);
}] resume];
}
- 上傳操作
-(void)upload
{
//1.創(chuàng)建會(huì)話管理者
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
//2.發(fā)送請(qǐng)求上傳文件
/*
第一個(gè)參數(shù):請(qǐng)求路徑(NSString)
第二個(gè)參數(shù):非文件參數(shù)
第三個(gè)參數(shù):constructingBodyWithBlock 拼接數(shù)據(jù)(告訴AFN要上傳的數(shù)據(jù)是哪些)
第四個(gè)參數(shù):progress 進(jìn)度回調(diào)
第五個(gè)參數(shù):success 成功回調(diào)
responseObject:響應(yīng)體
第六個(gè)參數(shù):failure 失敗的回調(diào)
*/
[manager POST:@"需要請(qǐng)求的URL" parameters:nil constructingBodyWithBlock:^(id<AFMultipartFormData> _Nonnull formData) {
NSData *data = [NSData dataWithContentsOfFile:@"/Users/apple/Desktop/Snip20160409_148.png"];
//拼接數(shù)據(jù)
/*
第一個(gè)參數(shù):文件參數(shù) (二進(jìn)制數(shù)據(jù))
第二個(gè)參數(shù):參數(shù)名~file
第三個(gè)參數(shù):該文件上傳到服務(wù)器以什么名稱(chēng)來(lái)保存
第四個(gè)參數(shù):
*/
[formData appendPartWithFileData:data name:@"file" fileName:@"123.png" mimeType:@"image/png"];
} progress:^(NSProgress * _Nonnull uploadProgress) {
NSLog(@"%f",1.0 * uploadProgress.completedUnitCount / uploadProgress.totalUnitCount);
} success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {
NSLog(@"success--%@",responseObject);
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
NSLog(@"failure -- %@",error);
}];
}
NSURLSessionConfiguration配置信息
- 作用:
- 統(tǒng)一配置session的信息,每個(gè)session可以發(fā)送多個(gè)請(qǐng)求
- 設(shè)置蜂窩網(wǎng)絡(luò),隱私信息,超時(shí)時(shí)間\
@property (strong, nonatomic) NSURLSession *session;
//將session設(shè)置為全局的屬性,方便發(fā)送網(wǎng)絡(luò)請(qǐng)求
//在懶加載里面設(shè)置配置的信息,達(dá)到統(tǒng)一設(shè)置
#pragma makr - 懶加載
-(NSURLSession *)session
{
if (_session == nil) {
//設(shè)置配置信息
NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
//統(tǒng)一設(shè)置請(qǐng)求超時(shí)
config.timeoutIntervalForRequest = 15.0;
//設(shè)置是否允許蜂窩網(wǎng)絡(luò)訪問(wèn)
config.allowsCellularAccess = YES;
_session = [NSURLSession sessionWithConfiguration:config delegate:self delegateQueue:[NSOperationQueue mainQueue]];
}
return _session;
}
AFNetWorking的序列化
- AFNetWorking默認(rèn)是JSON解析(因?yàn)殚_(kāi)發(fā)中百分之90都是JSON數(shù)據(jù))
默認(rèn)情況:JSON AFJSONResponseSerializer
XML:AFXMLParserResponseSerializer
既不是XML也不是JSON:AFHTTPResponseSerializer
- JSON
//1.創(chuàng)建會(huì)話管理者
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
/*
1)afn內(nèi)部默認(rèn)已經(jīng)完成了JSON解析工作
優(yōu)點(diǎn):方便
缺點(diǎn):如果服務(wù)器返回的數(shù)據(jù)不是JSON會(huì)報(bào)錯(cuò)
*/
NSDictionary *dict = @{@"type":@"JSON"};
//2.發(fā)請(qǐng)求
[manager GET:@"需要請(qǐng)求的URL" parameters:dict progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {
NSLog(@"%@--%@",[responseObject class],responseObject);
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
NSLog(@"%@---",error);
}];
- XML
-(void)xml
{
<NSXMLParserDelegate>代理協(xié)議
//1.創(chuàng)建會(huì)話管理者
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
//設(shè)置以XML的方式來(lái)解析數(shù)據(jù)
manager.responseSerializer = [AFXMLParserResponseSerializer serializer];
NSDictionary *dict = @{@"type":@"XML"};
//2.發(fā)請(qǐng)求
[manager GET:@"需要請(qǐng)求的URL" parameters:dict progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {
NSLog(@"%@--%@",[responseObject class],responseObject);
//1.創(chuàng)建解析器
NSXMLParser *parser = (NSXMLParser *)responseObject;
//2.設(shè)置代理
parser.delegate = self;
//3.開(kāi)始解析
[parser parse];
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
NSLog(@"%@---",error);
}];
}
- OtherHttpData
-(void)otherHttpData
{
//1.創(chuàng)建會(huì)話管理者
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
//設(shè)置不做處理
manager.responseSerializer = [AFHTTPResponseSerializer serializer];
//2.發(fā)請(qǐng)求
[manager GET:@"需要請(qǐng)求的URL" parameters:nil progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {
NSLog(@"%@--%@",[responseObject class],responseObject);
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
NSLog(@"%@---",error);
}];
}
#pragma mark NSXMLParserDelegate
-(void)parser:(NSXMLParser *)parser didStartElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName attributes:(NSDictionary<NSString *,NSString *> *)attributeDict
{
NSLog(@"%@--%@",elementName,attributeDict);
}
- 檢測(cè)網(wǎng)絡(luò)的狀態(tài)
-(void)networkStatusChangeAFN
{
//1.獲得一個(gè)網(wǎng)絡(luò)狀態(tài)監(jiān)聽(tīng)管理者
AFNetworkReachabilityManager *manager = [AFNetworkReachabilityManager sharedManager];
//2.監(jiān)聽(tīng)狀態(tài)的改變(當(dāng)網(wǎng)絡(luò)狀態(tài)改變的時(shí)候就會(huì)調(diào)用該block)
[manager setReachabilityStatusChangeBlock:^(AFNetworkReachabilityStatus status) {
/*
AFNetworkReachabilityStatusUnknown = -1, 未知
AFNetworkReachabilityStatusNotReachable = 0, 沒(méi)有網(wǎng)絡(luò)
AFNetworkReachabilityStatusReachableViaWWAN = 1, 3G|4G
AFNetworkReachabilityStatusReachableViaWiFi = 2, WIFI
*/
switch (status) {
case AFNetworkReachabilityStatusReachableViaWiFi:
NSLog(@"wifi");
break;
case AFNetworkReachabilityStatusReachableViaWWAN:
NSLog(@"3G|4G");
break;
case AFNetworkReachabilityStatusNotReachable:
NSLog(@"沒(méi)有網(wǎng)絡(luò)");
break;
case AFNetworkReachabilityStatusUnknown:
NSLog(@"未知");
break;
default:
break;
}
}];
//3.手動(dòng)開(kāi)啟 開(kāi)始監(jiān)聽(tīng)
[manager startMonitoring];
}
AFN使用技巧
1.在開(kāi)發(fā)的時(shí)候可以創(chuàng)建一個(gè)工具類(lèi),繼承自我們的AFN中的請(qǐng)求管理者,再控制器中真正發(fā)請(qǐng)求的代碼使用自己封裝的工具類(lèi)。
2.這樣做的優(yōu)點(diǎn)是以后如果修改了底層依賴(lài)的框架,那么我們修改這個(gè)工具類(lèi)就可以了,而不用再一個(gè)一個(gè)的去修改。
3.該工具類(lèi)一般提供一個(gè)單例方法,在該方法中會(huì)設(shè)置一個(gè)基本的請(qǐng)求路徑。
4.該方法通常還會(huì)提供對(duì)GET或POST請(qǐng)求的封裝。
5.在外面的時(shí)候通過(guò)該工具類(lèi)來(lái)發(fā)送請(qǐng)求
6.單例方法:+ (instancetype)shareNetworkTools{
static XMGNetworkTools *instance;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
// 注意: BaseURL中一定要以/結(jié)尾
instance=[[selfalloc]initWithBaseURL:[NSURL URLWithString:@"請(qǐng)求的URL"]]; }); return instance;
}