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.