NSURLSession
2016-11-22 本文已影响88人
Hayder
内容结构框图
1.NSURLSession优势在哪。(为什么要使用NSURLSession来替代NSURLConnection)
1.1 下载速度
在2015年RFC 7540正式发表了下一代HTTP协议，是1999年以来HTTP/1.1发布后的首个更新。相对HTTP1.1,HTTP/2更加快速。
HTTP/2比HTTP/1.1在速度上快很多，iOS9开始，NSURLSession开始全面的支持HTTP/2。
1.2 能够暂停和恢复网络操作
使用NSURLSession API能够暂停，停止，恢复所有的网络任务，再也完全不需要子类化NSOperation. 并且默认任务运行在其他非主线程中。
1.3 提高认证处理
认证是在一个指定的连接基础上完成的。在使用NSURLConnection时，如果发出一个访问，会返回一个任意的request。此时，你就不能确切的知道哪个request收到了访问。而在NSURLSession中，就能用代理处理认证。
1.4 可配置的容器
对于NSURLSession里面的requests来说，每个NSURLSession都是可配置的容器。举个例来说，假如你需要设置HTTP header选项，你只用做一次，session里面的每个request就会有同样的配置。
2.NSURLSession介绍。
2.1NSURLSession类继承关系
2.png
在NSURLSession中，网络请求基本由3个任务完成:
1.NSURLSessionData：请求数据任务
2.NSURLSessionUploadTask：请求上传任务
3.NSURLSessionDownloadTask：请求下载任务
2.2NSURL代理协议类继承关系
3.png
2.3NSURLSession使用步骤
1.创建一个URL
NSURL *url = [NSURL URLWithString:@"协议://主机地址/路径?参数&参数"];
2.创建NSURLRequest请求
NSURLRequest *request = [NSURLRequest requestWithURL:url cachePolicy:NSURLRequestUseProtocolCachePolicy timeoutInterval:30.0];
url:资源路径
cachePolicy:缓存策略。（无论使用哪种缓存策略，都会在本地缓存数据） NSURLRequestUseProtocolCachePolicy = 0 //默认的缓存策略，使用协议的缓存策略 NSURLRequestReloadIgnoringLocalCacheData = 1 //每次都从网络加载 NSURLRequestReturnCacheDataElseLoad = 2 //返回缓存否则加载，很少使用 NSURLRequestReturnCacheDataDontLoad = 3 //只返回缓存，没有也不加载，很少使用
timeoutInterval:超时时长，默认60s.
注意：request还可以设置一些其他的信息，比如请求头，请求体等。此时的request要为NSMutableRequest类型。
// 告诉服务器数据为json类型
[request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
// 设置请求体(json类型)
NSData *jsonData = [NSJSONSerialization dataWithJSONObject:@{@"userid":@"123456"} options:NSJSONWritingPrettyPrinted error:nil];
request.HTTPBody = jsonData;
3.创建会话:NSURLSession
4.通过会话创建务:NSURLSessionDataTask,NSURLSessionUploadTask,NSURLSessionDownloadTask
5.调用resume方法启动任务。（每一个任务都是默认挂起的，需要调用resume方法）
3.NSURLSession具体使用。
3.1 NSURLSessionDataTask进行GET请求
//1.创建URL
NSURL *url = [NSURL URLWithString:@"http://test.igenshang.com:8001/openapi/api/event/addEventRecord?"];
//2.NSMutableURLRequest
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url cachePolicy:NSURLRequestUseProtocolCachePolicy timeoutInterval:30.f];
request.HTTPMethod = @"GET";
//3.创建NSURLSession对象(使用一个全局会话对象)
NSURLSession *session = [NSURLSession sharedSession];
//4.通过会话创建任务
NSURLSessionDataTask *task = [session dataTaskWithURL:url completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
if (!error) {
NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableContainers error:nil];
NSLog(@"%@",dict);
}
}];
//5.启动任务
[task resume];
4.会话Session控制。
一般情况下全局的Session我们够用了，但是如果遇到两个连接使用不同配置的情况，就得重新配置session
NSURLSession支持的3种会话配置
1.defaultSessionConfiguration （default）
进程内会话（默认会话），用硬盘来缓存数据
2.ephemeralSessionConfiguration （ephemeral）
临时的进程内会话，不会将cookie,缓存储存到本地，只会放在内存中，当应用程序退出后数据也会消失。（浏览器的无痕浏览模式）
3.backgroundSessionConfiguration （background）
后台会话，相比默认会话，该会话会在后台开启一个线程进行网络数据处理。
配置一个默认session
NSURLSessionConfiguration *sessionConfig = [NSURLSessionConfiguration defaultSessionConfiguration];
sessionConfig.timeoutIntervalForRequest = 5.0f;//请求超时时间
sessionConfig.allowsCellularAccess = true;//是否允许蜂窝网络下载（2G/3G/4G）
//创建会话，指定配置和代理
NSURLSession *session = [NSURLSession sessionWithConfiguration:sessionConfig
delegate:self
delegateQueue:nil];
NSURLSession代理协议
NSURLSessionDelegate：NSObject
会话父协议
NSURLSessionTaskDelegate：NSURLSessionDelegate
任务协议
NSURLSessionDataDelegate：NSURLSessionTaskDelegate
数据协议
NSURLSessionDownloadDelegate： NSURLSessionTaskDelegate
下载协议
NSURLSessionStreamDelegate：NSURLSessionTaskDelegate
网络流协议
NSURLSessionDownloadDelegate 协议（常用）
/**
* 1.下载中会多次调用
*
* @param session 会话
* @param downloadTask 下载任务
* @param bytesWritten 此次下载完成的字节数
* @param totalBytesWritten 已经下载完成的总字节数
* @param totalBytesExpectedToWrite 需要下载完成的总字节数
*/
- (void)URLSession:(NSURLSession *)session
downloadTask:(nonnull NSURLSessionDownloadTask *)downloadTask
didWriteData:(int64_t)bytesWritten
totalBytesWritten:(int64_t)totalBytesWritten
totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
/**
* 2.成功下载后调用
*/
- (void)URLSession:(NSURLSession *)session
downloadTask:(NSURLSessionDownloadTask *)downloadTask
didFinishDownloadingToURL:(NSURL *)location
/**
* 3.任务完成后调用,不管下载是否成功
*/
- (void)URLSession:(NSURLSession *)session
task:(NSURLSessionTask *)task
didCompleteWithError:(NSError *)error
NSURLSessionTask 任务操作方法
1.取消任务
- (void)cancel;
2.挂起任务(暂停任务)
- (void)suspend;
3.启动任务
- (void)resume;
使用DownloadTask 自制Configuration 代码
-(void)downloadFile{
1.创建url
NSString *fileName = _textField.text;
NSString *urlStr = [NSString stringWithFormat: @"http://192.168.1.208/FileDownload.aspx?file=%@",fileName];
urlStr = [urlStr stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
NSURL *url = [NSURL URLWithString:urlStr];
2.创建request
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
3.创建session
3.1创建configuration
NSURLSessionConfiguration *sessionConfig = [NSURLSessionConfiguration defaultSessionConfiguration];
sessionConfig.timeoutIntervalForRequest = 5.0f;//请求超时时间
sessionConfig.allowsCellularAccess = true;//是否允许蜂窝网络下载（2G/3G/4G）
3.2创建session
NSURLSession *session = [NSURLSession sessionWithConfiguration:sessionConfig
delegate:self
delegateQueue:nil];
4.创建任务
_downloadTask = [session downloadTaskWithRequest:request];
5.启动任务
[_downloadTask resume];
}
pragma mark 点击取消下载
-(void)cancelDownload{
[_downloadTask cancel];
}
pragma mark 点击挂起下载
-(void)suspendDownload{
[_downloadTask suspend];
}
pragma mark 点击恢复下载
-(void)resumeDownload{
[_downloadTask resume];
}
pragma mark - 下载任务代理
pragma mark 下载中(会多次调用，可以记录下载进度)
-(void)URLSession:(NSURLSession *)session
downloadTask:(NSURLSessionDownloadTask *)downloadTask
didWriteData:(int64_t)bytesWritten
totalBytesWritten:(int64_t)totalBytesWritten
totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
{
[self setUIStatus:totalBytesWritten expectedToWrite:totalBytesExpectedToWrite];//设置界面状态
}
pragma mark 下载完成
-(void)URLSession:(NSURLSession *)session
downloadTask:(NSURLSessionDownloadTask *)downloadTask
didFinishDownloadingToURL:(NSURL *)location
{
NSError *error;
NSString *cachePath = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject];
NSString *savePath = [cachePath stringByAppendingPathComponent:_textField.text];
NSURL *saveUrl = [NSURL fileURLWithPath:savePath];
[[NSFileManager defaultManager] copyItemAtURL:location toURL:saveUrl error:&error];
}
pragma mark 任务完成，不管是否下载成功
-(void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task
didCompleteWithError:(NSError *)error
{
[self setUIStatus:0 expectedToWrite:0];//设置界面状态
}
5.session后台开启任务
session后台开启任务的意义：
场景: APP下载一个比较大的文件，用户开始下载后，让APP进入后台，他去做别的事情。
当程序进入后台后，下载继续进行，下载完成后，用户正常打开应该为100%位置。但是程序在后台无法更新UI，此时可以通过应用程序的代理进行UI更新。
AppDelegate.m添加函数
/*
有其中几个任务完成后，系统会调用此应用程序的该方法
此方法会包含一个competionHandler，通常我们会保存此对象
competionHandler此操作表示应用完成所有处理工作
**/
- (void)application:(UIApplication *)application
handleEventsForBackgroundURLSession:(NSString *)identifier
completionHandler:(void (^)())completionHandler
{
//backgroundSessionCompletionHandler是自定义的一个属性
self.backgroundSessionCompletionHandler = completionHandler;
}
在实现NSURLSessionDelegate代理方法
/*
直到最后一个任务完成，系统会调用该方法。
在这个方法中通常可以进行UI更新，并调用completionHandler通知系统已经完成所有操作。
*/
- (void)URLSessionDidFinishEventsForBackgroundURLSession:(NSURLSession *)session
{
AppDelegate *appDelegate = (AppDelegate *)[[UIApplication sharedApplication] delegate];
//这中间就可以写更新UI的代码了
if (appDelegate.backgroundSessionCompletionHandler) {
void (^completionHandler)() = appDelegate.backgroundSessionCompletionHandler;
appDelegate.backgroundSessionCompletionHandler = nil;
completionHandler();
}
}
文章中有些内容是引用了其他文章的内容，时间久了，找不到具体的链接了，如有原文作者看到，请联系我，我加上你原文地址，同时也感谢你写的文章给了我很多的帮助。
