iOS网络框架

简介:

JDBAPMNetworkModules是基于iOS开源网络框架AFNetworking封装的组件化模块,AFNetworking基于NSURLSession的封装。AFHTTPSessionManager继承AFURLSessionManager对网络请求进行管理,使用AFURLRequestSerialization对网络请求进行封装,使用AFURLResponseSerialization对响应体进行处理,使用AFSecurityPolicy对服务器证书进行校验。支持HTTPS协议,支持本地证书和服务器证书进行对比验证。AFN数据传递主要使用block和notifacation方式。

使用

接入 JDTAFNetworkingModule

1、导入头文件

#import  <JDTAFNetworkingModule/JDTAFNetworkingModule-umbrella.h>

2、参数设置

AFNetworking 3.0 使用的是 AFHTTPSessionManager 来进行网络请求的,下面介绍一下参数的设置。

  • 关于 requestSerializer 它是 AFNetworking 参数编码的序列化器,它一共有三种编码格式,responseSerializer 同理,选择哪种看自己的需求。 ```
  • AFHTTPRequestSerializer:是普通的 HTTP 的编码格式的,也就是 mid=10&method=userInfo&dateInt=20160818 这种格式的。
  • AFJSONRequestSerializer:是 JSON 编码格式的,也就是 {"mid":"11","method":"userInfo","dateInt":"20160818"} 这种格式的。
  • AFPropertyListRequestSerializer:这个没用过,但是看介绍说是编码成 plist 格式的参数。 ```
  • HTTPHeaderField 请求头没有的话可以不用设置。
/* 创建网络请求对象 */
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];

/* 设置请求和接收的数据编码格式 */
manager.requestSerializer = [AFJSONRequestSerializer serializer]; // 设置请求数据为 JSON 数据
manager.responseSerializer = [AFJSONResponseSerializer serializer]; // 设置接收数据为 JSON 数据

/* 设置请求头 */
[manager.requestSerializer setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
[manager.requestSerializer setValue:@"xxx" forHTTPHeaderField:@"xxx"];
[manager.requestSerializer setValue:@"xxx" forHTTPHeaderField:@"xxx"];

/* 请求地址 */
NSString *url = @"http://xxx";

/* 请求参数 */
NSDictionary *parameters = @{@"xxx" : @"xxx",
                             @"xxx" : @"xxx",
                             @"xxx" : @"xxx"};

3、 调用方法

网络请求有 GET 请求、POST 请求、文件上传 这几种,按自己需求选择相应请求的方法,参数设置使用上面的设置。

/* 
 * GET 请求
 */
AFURLSessionManager *manager = [[AFURLSessionManager alloc] initWithSessionConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration]];

[manager GET:url parameters:parameters progress:nil success:^(NSURLSessionDataTask * _Nonnull task,  _Nullable responseObject) {
       NSLog(@"请求成功:%@", responseObject);
} failure:^(NSURLSessionDataTask * _Nullable task, NSError* _Nonnull error) {
        NSLog(@"请求失败:%@", error);
}];
/*
 *POST 请求 
 */ 
AFURLSessionManager *manager = [[AFURLSessionManager alloc] initWithSessionConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration]];

[manager POST:url parameters:parameters progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {
    NSLog(@"请求成功:%@", responseObject);
} failure:^(NSURLSessionDataTask * _Nullable task,NSError * _Nonnull error){
    NSLog(@"请求失败:%@", error);
}];
/*
 *文件上传
 */
AFURLSessionManager *manager = [[AFURLSessionManager alloc] initWithSessionConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration]];

[manager POST:url parameters:parameters constructingBodyWithBlock:^(id<AFMultipartFormData>  _Nonnull formData) {
    /* 本地图片上传 */
    NSURL *imageUrl = [[NSBundle mainBundle] URLForResource:@"test" withExtension:@"png"];
    NSData *imageData = [NSData dataWithContentsOfURL:imageUrl];

    // 直接将图片对象转成 data 也可以
    // UIImage *image = [UIImage imageNamed:@"test"];
    // NSData *imageData = UIImageJPEGRepresentation(image, 1.0);

    /* 上传数据拼接 */
    [formData appendPartWithFileData:imageData name:@"file" fileName:@"test.png" mimeType:@"image/png"];
} progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
    NSLog(@"上传成功:%@", responseObject);
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
    NSLog(@"上传失败:%@", error);
}];
/*
 *请求结果的处理
 *以下方法能够将获取到的 responseObject 数据直接转成 NSString 字符串或者 NSDictionary 字典,也可以使用 MJExtension 这个第三方库,能够将获取到的 responseObject 直接转换成对象,如果要转成字典或是对象, responseObject 必须是 JSON 格式的。
 */
AFURLSessionManager *manager = [[AFURLSessionManager alloc] initWithSessionConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration]];

[manager POST:url parameters:parameters progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
    /* 将得到的数据转换成 NSString 字符串 */
    NSString *infoStr = [[NSString alloc] initWithData:responseObject encoding:NSUTF8StringEncoding];
    NSLog(@"请求到的数据:%@", infoStr);

    /* 将得到的 JSON 数据转换成 NSDictionary 字典 */
    NSDictionary *resultDic = [NSJSONSerialization JSONObjectWithData:responseObject options:NSJSONReadingMutableLeaves error:nil];
    NSLog(@"请求到的数据:%@", resultDic);
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {

    NSLog(@"请求失败:%@", error);
}];
/*
 *文件下载
 *文件下载的话和上面三个不太一样,所以单独来说,上面那些设置的参数都不需要了,具体代码看下面。
 */

/* 创建网络下载对象 */
AFURLSessionManager *manager = [[AFURLSessionManager alloc] initWithSessionConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration]];

/* 下载地址 */
NSURL *url = [NSURL URLWithString:@"http://xxx/test.mp4"];
NSURLRequest *request = [NSURLRequest requestWithURL:url];

/* 下载路径 */
NSString *path = [NSHomeDirectory() stringByAppendingPathComponent:@"Documents"];
NSString *filePath = [path stringByAppendingPathComponent:url.lastPathComponent];

/* 开始请求下载 */
NSURLSessionDownloadTask *downloadTask = [manager downloadTaskWithRequest:request progress:^(NSProgress * _Nonnull downloadProgress) {
    NSLog(@"下载进度:%.0f%", downloadProgress.fractionCompleted * 100);
} destination:^NSURL * _Nonnull(NSURL * _Nonnull targetPath, NSURLResponse * _Nonnull response) {
    /* 设定下载到的位置 */
    return [NSURL fileURLWithPath:filePath];
} completionHandler:^(NSURLResponse * _Nonnull response, NSURL * _Nullable filePath, NSError * _Nullable error) {
    NSLog(@"下载完成");
}];
[downloadTask resume];
/*
 *监听网络状态
 *AFNetWorking 也可以用来监听网络状态,当网络状态发生改变的时候会自动调用以下 Block 回调,具体方法如下。
 */

/* 监听网络状态 */
AFNetworkReachabilityManager *manager = [AFNetworkReachabilityManager sharedManager];
[manager setReachabilityStatusChangeBlock:^(AFNetworkReachabilityStatus status) {
    if (status == AFNetworkReachabilityStatusUnknown) {
        NSLog(@"当前网络:未知网络");
    } else if (status == AFNetworkReachabilityStatusNotReachable) {
        NSLog(@"当前网络:没有网络");
    } else if (status == AFNetworkReachabilityStatusReachableViaWWAN) {
        NSLog(@"当前网络:手机流量");
    } else if (status == AFNetworkReachabilityStatusReachableViaWiFi) {
        NSLog(@"当前网络:WiFi");
    }
}];
[manager startMonitoring];

results matching ""

    No results matching ""