【iOS】使用AFNetworking进行网络请求
文章目录
- 前言
- AFNetworking
- AFNetworking 的核心组件
- AKNetworking库的常用方法
- 使用AKNetworking进行网络请求的步骤和代码示例
- 总结
前言
在暑假写天气预报项目时,我们已经接触到网络请求,当时我们是使用URLSession类,即Foundation框架中用于管理和配置网络连接的API,来完成对实时天气预报数据的请求,现在我们来学习一种更方便的网络请求方式——使用一个单例通过AFNetworking来实现网络请求。
AFNetworking
AFNetworking 是一个开源的网络库,它基于 NSURLSession,为 iOS、macOS、watchOS 和 tvOS 应用程序开发提供了强大的网络请求功能。AFNetworking 通过简单的 API 设计,使得开发者可以轻松地处理 HTTP 请求,包括 GET、POST、PUT、DELETE 等操作。它还支持文件上传、下载、自动处理 HTTP 缓存、自定义缓存策略、安全性设置等高级特性。
由此来看,AKNetworking库兼容了我们之前使用URLSession类来进行网络请求的方法。使用这个库可以简化我们进行网络请求的代码,在使用前记得下载cocoapods然后将该库安装到对应的文档里。
AFNetworking 的核心组件
AFHTTPSessionManager:这是最常用的类,用于处理 HTTP 请求。它基于 NSURLSession,可以发送网络请求和处理响应。
AFURLSessionManager:同样基于 NSURLSession,用于管理下载、上传等任务。
AFNetworkReachabilityManager:用于监控网络状态的变化,帮助开发者了解当前的网络连接情况。
序列化和反序列化:AFNetworking 自动解析响应的数据格式,如 JSON、XML、图片等,并且支持自定义序列化和反序列化操作。
AKNetworking库的常用方法
-
AFHTTPSessionManager:这是最常用的类,用于处理 HTTP 请求。它基于
NSURLSession
,可以发送网络请求和处理响应。 -
GET 请求:使用
GET
方法发送请求,可以传递参数字典,并且在请求成功或失败时提供回调。AFHTTPSessionManager *manager = [AFHTTPSessionManager manager]; NSDictionary *parameters = @{@"key": @"value"}; [manager GET:@"http://example.com/api" parameters:parameters success:^(NSURLSessionDataTask *task, id responseObject) { NSLog(@"Success: %@", responseObject); } failure:^(NSURLSessionDataTask *task, NSError *error) { NSLog(@"Error: %@", error); }];
-
POST 请求:使用
POST
方法发送请求,同样可以传递参数字典,并在请求成功或失败时提供回调。[manager POST:@"http://example.com/api" parameters:parameters success:^(NSURLSessionDataTask *task, id responseObject) { NSLog(@"Success: %@", responseObject); } failure:^(NSURLSessionDataTask *task, NSError *error) { NSLog(@"Error: %@", error); }];
-
文件上传:AFNetworking 支持文件上传,并且可以监控上传进度。
NSURL *fileURL = [NSURL fileURLWithPath:@"path/to/file"]; [manager POST:@"http://example.com/upload" parameters:nil constructingBodyWithBlock:^(id<AFMultipartFormData> formData) { [formData appendPartWithFileURL:fileURL name:@"file" fileName:@"filename" mimeType:@"file mimeType"]; } progress:^(NSProgress *uploadProgress) { NSLog(@"Upload Progress: %@%", uploadProgress.fractionCompleted); } success:^(NSURLSessionDataTask *task, id responseObject) { NSLog(@"Success: %@", responseObject); } failure:^(NSURLSessionDataTask *task, NSError *error) { NSLog(@"Error: %@", error); }];
-
文件下载:AFNetworking 也支持文件下载,并且可以指定下载进度和完成时的回调。
NSURL *fileURL = [NSURL URLWithString:@"http://example.com/file"]; NSURLSessionDownloadTask *downloadTask = [manager downloadTaskWithRequest:[NSURLRequest requestWithURL:fileURL] progress:^(NSProgress *downloadProgress) { NSLog(@"Download Progress: %@%", downloadProgress.fractionCompleted); } destination:^NSURL * _Nonnull(NSURL * _Nonnull targetPath, NSURLResponse * _Nonnull response) { return [NSURL fileURLWithPath:@"path/to/save/file"]; } completionHandler:^(NSURLResponse *response, NSURL *filePath, NSError *error) { if (error) { NSLog(@"Download Error: %@", error); } else { NSLog(@"Download Success: %@", filePath); } }]; [downloadTask resume];
-
网络状态监控:使用
AFNetworkReachabilityManager
可以监控网络状态的变化。AFNetworkReachabilityManager *reachabilityManager = [AFNetworkReachabilityManager sharedManager]; [reachabilityManager setReachabilityStatusChangeBlock:^(AFNetworkReachabilityStatus status) { switch (status) { case AFNetworkReachabilityStatusReachableViaWiFi: NSLog(@"Reachable via WiFi"); break; case AFNetworkReachabilityStatusReachableViaWWAN: NSLog(@"Reachable via WWAN"); break; case AFNetworkReachabilityStatusNotReachable: NSLog(@"Not reachable"); break; } }]; [reachabilityManager startMonitoring];
-
响应序列化:AFNetworking 提供了多种响应序列化器,如
AFJSONResponseSerializer
,AFXMLParserResponseSerializer
等,用于自动解析服务器返回的数据。 -
单例模式:在实际应用中,通常会将 AFNetworking 封装在单例类中,以便在整个应用中统一管理和使用网络请求。
-
缓存机制:AFNetworking 支持内存缓存和磁盘缓存,可以配置缓存策略来提高应用性能和用户体验 。
-
HTTPS 和 SSL/TLS 支持:AFNetworking 支持 HTTPS 请求,并且可以配置 SSL/TLS 证书,以确保数据传输的安全性 。
-
响应式布局和动态请求:可以根据不同的设备和屏幕尺寸动态调整请求参数,以适应不同的设备和屏幕尺寸 。
-
复合响应序列化:
AFCompoundResponseSerializer
允许同时使用多个响应序列化器,这在处理复杂或混合格式的响应时非常有用。 -
图片加载和处理:
AFImageResponseSerializer
不仅可以处理图片的下载,还可以进行图片的解压和缓存,以提高图片显示的性能 。 -
错误处理和重试机制:AFNetworking 提供了丰富的错误处理机制,你可以设置重试策略,以应对网络不稳定或服务器错误的情况。
使用AKNetworking进行网络请求的步骤和代码示例
引入 AFNetworking:通过 CocoaPods 或其他依赖管理工具将 AFNetworking 添加到项目中。
创建 AFHTTPSessionManager 实例:这个实例将用于发起网络请求。
配置请求和响应序列化器:AFNetworking 提供了多种序列化器,如 AFJSONRequestSerializer 和 AFJSONResponseSerializer,用于处理 JSON 格式的数据。
发起网络请求:使用 GET、POST 等方法发起网络请求,并在回调中处理响应数据。
处理响应和错误:在回调中,你可以获取到响应数据,并根据需要进行处理。
// 创建 AFHTTPSessionManager 实例
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
// 设置请求和响应序列化器
manager.requestSerializer = [AFJSONRequestSerializer serializer];
manager.responseSerializer = [AFJSONResponseSerializer serializer];
// 发起 GET 请求
[manager GET:@"https://example.com/api/resource" parameters:nil progress:nil success:^(NSURLSessionDataTask *task, id responseObject) {
// 请求成功的回调
NSLog(@"Response: %@", responseObject);
} failure:^(NSURLSessionDataTask *task, NSError *error) {
// 请求失败的回调
NSLog(@"Error: %@", error);
}];
总结
AFNetworking 作为一个开源库,简化了网络请求的过程,相比于之前使用xcode自带的URLSession类来进行网络请求便利许多,在后续写项目的过程中有时应该会更加明显。