【iOS】使用AFNetworking进行网络请求

前言

  在暑假写天气预报项目时，我们已经接触到网络请求，当时我们是使用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库的常用方法

1. AFHTTPSessionManager：这是最常用的类，用于处理 HTTP 请求。它基于 NSURLSession，可以发送网络请求和处理响应。

2. 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);
   }];
   

3. 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);
   }];
   

4. 文件上传：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);
   }];
   

5. 文件下载：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];
   

6. 网络状态监控：使用 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];
   

7. 响应序列化：AFNetworking 提供了多种响应序列化器，如 AFJSONResponseSerializer，AFXMLParserResponseSerializer 等，用于自动解析服务器返回的数据。

8. 单例模式：在实际应用中，通常会将 AFNetworking 封装在单例类中，以便在整个应用中统一管理和使用网络请求。

9. 缓存机制：AFNetworking 支持内存缓存和磁盘缓存，可以配置缓存策略来提高应用性能和用户体验 。

10. HTTPS 和 SSL/TLS 支持：AFNetworking 支持 HTTPS 请求，并且可以配置 SSL/TLS 证书，以确保数据传输的安全性 。

11. 响应式布局和动态请求：可以根据不同的设备和屏幕尺寸动态调整请求参数，以适应不同的设备和屏幕尺寸 。

12. 复合响应序列化：AFCompoundResponseSerializer 允许同时使用多个响应序列化器，这在处理复杂或混合格式的响应时非常有用。

13. 图片加载和处理：AFImageResponseSerializer 不仅可以处理图片的下载，还可以进行图片的解压和缓存，以提高图片显示的性能 。

14. 错误处理和重试机制：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类来进行网络请求便利许多，在后续写项目的过程中有时应该会更加明显。