AFNetworking 這個強大的框架相信大家都已經很熟悉了,這裡不再班門弄斧,主要是給新入門的同學做個簡單介紹,包括版本歷史、框架結構和基本使用。
AFN 是 iOS 開發中一個非常流行的網絡請求框架,根據其 GitHub 介紹,支持 iOS、macOS、watchOS、tvOS 等。遺憾的是 AFN 並不支持 Swift,不過作者另外推出了 Swift 版的 Alamofire 框架,目前已有 10000+ 星,用 Swift 開發的同學可以用它替代 AFN。根據作者介紹:AFN 1.x 及 0.10x 底層由 NSURLConnection 實現;2.0–2.6.3 版本由 NSURLConnection 和 NSURLSession 共同實現;最新的 3.x 版本放棄了 NSURLConnection,單獨由 NSURLSession 實現。
AFN 主要分三個部分:
1. NSURLSession:最新 AFN 底層由 NSURLSession 實現,主要使用兩個管理者——AFURLSessionManager 和 AFHTTPSessionManager。
2. Serialization(序列化):AFN 的強大之處在於幫我們完成序列化,無論請求還是響應,都不用擔心 JSON 還是 XML 解析。
AFURLRequestSerialization:請求相關序列化,很少用到。
AFURLResponseSerialization:響應相關序列化,主要有三個——AFHTTPResponseSerializer(不做處理)、AFJSONResponseSerializer(JSON 解析)、AFXMLParserResponseSerializer(XML 解析)。
3. Additional Functionality:主要包括網絡安全(如加密)以及網絡狀態監聽相關的類。


-(void)get {
// 1. 創建會話管理者
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
// AFN 會自動把字典對象轉換並拼接到 URL 裡
NSDictionary *paramDict = @{ @"username":@"Cehae", @"pwd":@"Cehae", @"type":@"JSON" };
// 2. 發送 GET 請求
// 參數:請求路徑、字典參數、進度回調、成功回調(task 為請求任務,responseObject 為響應體)、失敗回調(error 為錯誤信息)
[manager GET:@"https://120.25.226.186:32812/login" parameters:paramDict progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {
NSLog(@"%@---%@", [responseObject class], responseObject);
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
NSLog(@"請求失敗--%@", error);
}];
}
-(void)post {
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
NSDictionary *paramDict = @{ @"username":@"Cehae", @"pwd":@"Cehae", @"type":@"JSON" };
[manager POST:@"https://120.25.226.186:32812/login" parameters:paramDict progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {
NSLog(@"%@---%@", [responseObject class], responseObject);
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
NSLog(@"請求失敗--%@", error);
}];
}
-(void)download {
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
NSURL *url = [NSURL URLWithString:@"https://120.25.226.186:32812/resources/videos/minion_01.mp4"];
NSURLRequest *request = [NSURLRequest requestWithURL:url];
// 參數:請求對象、進度回調、目標位置回調(targetPath 為臨時路徑,response 為響應頭)、下載完成回調(filePath 為最終路徑)
NSURLSessionDownloadTask *download = [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(@"targetPath:%@", targetPath);
NSLog(@"fullPath:%@", fullPath);
return [NSURL fileURLWithPath:fullPath];
} completionHandler:^(NSURLResponse * _Nonnull response, NSURL * _Nullable filePath, NSError * _Nullable error) {
NSLog(@"%@", filePath);
}];
// 執行 Task
[download resume];
}
-(void)upload2 {
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
// 參數:請求路徑、非文件參數、拼接文件數據的 block、進度回調、成功回調、失敗回調
[manager POST:@"https://120.25.226.186:32812/upload" parameters:nil constructingBodyWithBlock:^(id _Nonnull formData) {
UIImage *image = [UIImage imageNamed:@"Snip20160227_128"];
NSData *imageData = UIImagePNGRepresentation(image);
// 使用 formData 拼接數據
// 參數:二進制數據、服務器規定的字段名、上傳到服務器後保存的文件名
// [formData appendPartWithFileData:imageData name:@"file" fileName:@"xxxx.png" mimeType:@"image/png"];
// [formData appendPartWithFileURL:[NSURL fileURLWithPath:@"/Users/Cehae/Desktop/Snip20160227_128.png"] name:@"file" fileName:@"123.png" mimeType:@"image/png" error:nil];
[formData appendPartWithFileURL:[NSURL fileURLWithPath:@"/Users/Cehae/Desktop/Snip20160227_128.png"] name:@"file" error:nil];
} progress:^(NSProgress * _Nonnull uploadProgress) {
NSLog(@"%f", 1.0 * uploadProgress.completedUnitCount / uploadProgress.totalUnitCount);
} success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {
NSLog(@"上傳成功---%@", responseObject);
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
NSLog(@"上傳失敗---%@", error);
}];
}
-(void)afn {
// 1. 獲得網絡狀態檢測管理者
AFNetworkReachabilityManager *manager = [AFNetworkReachabilityManager sharedManager];
// 2. 監聽狀態改變
// Unknown 未知 / NotReachable 無網絡 / ReachableViaWWAN 蜂窩網絡 / ReachableViaWiFi 無線網
[manager setReachabilityStatusChangeBlock:^(AFNetworkReachabilityStatus status) {
switch (status) {
case AFNetworkReachabilityStatusReachableViaWWAN:
NSLog(@"蜂窩網絡"); break;
case AFNetworkReachabilityStatusReachableViaWiFi:
NSLog(@"WIFI"); break;
case AFNetworkReachabilityStatusNotReachable:
NSLog(@"沒有網絡"); break;
case AFNetworkReachabilityStatusUnknown:
NSLog(@"未知"); break;
default: break;
}
}];
// 3. 開始監聽
[manager startMonitoring];
}
#import "ViewController.h"
#import "AFNetworking.h"
@interface ViewController () <NSXMLParserDelegate>
@end
@implementation ViewController
-(void)touchesBegan:(NSSet<UITouch> *)touches withEvent:(UIEvent *)event {
[self httpData2];
}
// 返回 JSON 數據
-(void)json {
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
NSDictionary *paramDict = @{ @"username":@"Cehae", @"pwd":@"Cehae", @"type":@"JSON" };
[manager GET:@"https://120.25.226.186:32812/login" parameters:paramDict 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 {
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
// 注意:若返回的是 XML 數據,需修改 AFN 的解析方案
manager.responseSerializer = [AFXMLParserResponseSerializer serializer];
NSDictionary *paramDict = @{ @"type":@"XML" };
[manager GET:@"https://120.25.226.186:32812/video" parameters:paramDict progress:nil success:^(NSURLSessionDataTask * _Nonnull task, NSXMLParser *parser) {
// 設置代理並開始解析
parser.delegate = self;
[parser parse];
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
NSLog(@"請求失敗--%@", error);
}];
}
// 返回二進制數據
-(void)httpData {
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
// 若返回的數據既不是 XML 也不是 JSON,可修改解析方案為 AFHTTPResponseSerializer
manager.responseSerializer = [AFHTTPResponseSerializer serializer];
[manager GET:@"https://120.25.226.186:32812/resources/images/minion_01.png" parameters:nil progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {
NSLog(@"%@-", [responseObject class]);
// UIImage *image = [UIImage imageWithData:responseObject];
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
NSLog(@"請求失敗--%@", error);
}];
}
-(void)httpData2 {
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
// 告訴 AFN 能夠接受 text/html 類型的數據
manager.responseSerializer.acceptableContentTypes = [NSSet setWithObject:@"text/html"];
manager.responseSerializer = [AFHTTPResponseSerializer serializer];
[manager GET:@"https://www.baidu.com" parameters:nil progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {
NSLog(@"%@-%@", [responseObject class], [[NSString alloc] initWithData:responseObject encoding:NSUTF8StringEncoding]);
} 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);
}
@end