iOS-一直用AFN,别忘了NSURLSession

NSURLSession从2013年发展到现在,变得越来越完善和强大,iOS 9以后,NSURLConnection被宣布弃用,苹果主推NSURLSession.

AFNetworking 3.0 是对 NSURLSession 进行的封装,了解AFN 3.0的用法及封装请看之前的博客:
iOS-利用Block二次封装AFNetworking 3.0

---

NSURLSession 及 NSURLSessionTask 的结构图:

---

使用NSURLSession,可以分三步:

• 第一步 创建NSURLSession管理类事例;
• 第二步 通过NSURLSession的实例创建任务task;
• 第三步 执行task(resume).

---

一 GET数据请求,自定义request

    NSURLSession *urlSession = [NSURLSession sharedSession];
    NSURL *url = [NSURL URLWithString:@"http://www.tngou.net/api/info/classify"];
    NSURLRequest *request = [NSURLRequest requestWithURL:url];
    NSURLSessionDataTask *dataTask = [urlSession dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:0 error:nil];
        NSLog(@"%@",dict);
    }];
    // 启动任务
    [dataTask resume];

---

二 GET数据请求,使用默认request

    NSURLSession *urlSession = [NSURLSession sharedSession];
    NSURL *url = [NSURL URLWithString:@"http://www.tngou.net/api/info/classify"];
    NSURLSessionDataTask *dataTask = [urlSession dataTaskWithURL:url completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:0 error:nil];
        NSLog(@"%@",dict);
    }];
    // 启动任务
    [dataTask resume];

---

三 POST数据请求

    NSURLSession *urlSession = [NSURLSession sharedSession];
    NSURL *url = [NSURL URLWithString:@"http://www.tngou.net/api/info/classify"];
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
    // 设置数据请求方法
    request.HTTPMethod = @"POST";
    // 设置请求参数
    request.HTTPBody = [@"key=value" dataUsingEncoding:NSUTF8StringEncoding];
    NSURLSessionDataTask *dataTask = [urlSession dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:0 error:nil];
        NSLog(@"%@",dict);
    }];
    // 启动任务
    [dataTask resume];

---

四 下载任务 使用默认request

    NSURLSession *urlSession = [NSURLSession sharedSession];
    NSURL *url = [NSURL URLWithString:@"http://www.tngou.net/api/info/classify"];
    NSURLSessionDownloadTask *downloadTask = [urlSession downloadTaskWithURL:url completionHandler:^(NSURL * _Nullable location, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        NSLog(@"%@",location); // 下载位置路径,默认保存在 tmp 临时文件内,当文件下载完毕后,自动销毁
    }];
    // 启动任务
    [downloadTask resume];

---

五 下载任务 自定义request

    NSURLSession *urlSession = [NSURLSession sharedSession];
    NSURL *url = [NSURL URLWithString:@"http://p3.gexing.com/G1/M00/76/29/rBACE1LVEpfiXboYAACpIhA79mo980.jpg"];
    NSURLRequest *request = [NSURLRequest requestWithURL:url];
    NSURLSessionDownloadTask *downloadTask = [urlSession downloadTaskWithRequest:request completionHandler:^(NSURL * _Nullable location, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        NSLog(@"%@",location);
        NSFileManager *fileManager = [[NSFileManager alloc] init];
        NSString *cachePath = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:response.suggestedFilename];
        NSLog(@"%@",cachePath);
        [fileManager moveItemAtURL:location toURL:[NSURL fileURLWithPath:cachePath] error:nil];
    }];
    // 启动任务
    [downloadTask resume];

---

六 下载任务 通过代理方法监听下载任务

    NSURLSession *urlSession = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:nil];
    NSURL *url = [NSURL URLWithString:@"http://p3.gexing.com/G1/M00/76/29/rBACE1LVEpfiXboYAACpIhA79mo980.jpg"];
    NSURLSessionDownloadTask *downloadTask = [urlSession downloadTaskWithURL:url];
    // 启动任务
    [downloadTask resume];

代理方法 - NSURLSessionDownloadDelegate

pragma mark ----------NSURLSessionDownloadDelegate----------
// 完成任务下载
// downloadTask 下载任务
// location 文件下载路径,默认保存在temp临时文件夹内,需要手动将文件移动到其他路径内
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location
{
    NSLog(@"%s",__func__);
}

// 监听下载进度
// downloadTask 下载任务
// bytesWritten 本次下载数量
// totalBytesWritten 当前下载总数
// totalBytesExpectedToWrite 文件预期总大小
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite {
    NSLog(@"%f",1.0 * totalBytesWritten / totalBytesExpectedToWrite);
}

// 下载任务完成或者失败都会调用此方法,当下载失败时,error有值,否则为空
// task 任务
// error 任务结束是否失败
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error {
    NSLog(@"结束任务下载 %@",error);
}

---

总结:

• 1 task任务默认是暂停的,首次设置必须手动调用 resume 方法
• 2 NSURLSession的代理方法必须在NSURLSession创建事例的时候添加
• 3 不同的任务,用不同的代理,所有的代理都是基于NSURLSessionDelegate.下载任务用:NSURLSessionDownloadDelegate.数据请求代理用:NSURLSessionTaskDelegate.