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

news2024/11/5 17:59:27

文章目录

前言
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);
}];