URLSession
NSURLSession是iOS7中新的网络接口，与NSURLConnection是并列的。
当程序在前台时，NSURLSession与NSURLConnection大部分可以互相替代
NSURLSession支持后台网络操作，除非用户强行关闭
NSURLSession提供的功能：
通过URL将数据下载到内存
通过URL将数据下载到文件系统
将数据上传到指定URL
在后台完成上述功能
对于小型数据，例如用户登录、下载小图像、JSON & XML仍然使用NSURLConnection的异步或同步方法即可
[图片上传中。。。（1）]
NSURLSession的使用
使用NSURLSessionConfiguration来配置NSURLSession对象
用NSURLSession对象来启动一个NSURLSessionTask对象
也可以使用系统全局的sharedSession单例来满足大多数的需求
注：相比较NSURLConnection的返回处理，NSURLSession提供了灵活的数据返回方式，可以使用简单的block方式来处理返回数据，也可以使用更强大的delegate
NSURLSessionConfiguration
作用：用于定义和配置NSURLSession对象
每一个NSURLSession对象都可以设置不同的NSURLSessionConfiguration，从而满足应用内不同类型的网络请求
NSURLSessionConfiguration的三种类型：
defaultSessionConfiguration默认session配置，类似NSURLConnection的标准配置，使用硬盘来存储缓存数据
ephemeralSessionConfiguration临时session配置，与默认配置相比，这个配置不会将缓存、cookie等存在本地，只会存在内存里，所以当程序退出时，所有的数据都会消失
backgroundSessionConfiguration后台session配置，与默认配置类似，不同的是会在后台开启另一个线程来处理网络数据
NSURLSessionTask
NSURLSession使用NSURLSessionTask来具体执行网络请求的任务
NSURLSessionTask支持网络请求的取消、暂停和恢复，比如下载文件暂停之后再恢复就能够自动从上次的进度继续下载
NSURLSessionTask还能获取数据的读取进度
NSURLSessionTask的三种类型：
NSURLSessionDataTask 处理一般的NSData数据对象，比如通过GET或POST方式从服务器获取JSON或XML返回等等，但不支持后台获取
NSURLSessionUploadTask 用于上传文件，支持后台上传
NSURLSessionDownloadTask 用于下载文件，支持后台下载
通过HTTP PUT方法实现文件上传的步骤
实例化NSMutableURLRequest并指定HTTPMethod为PUT
设置请求的授权
授权字符串格式：用户名:口令
授权模式：Basic base64编码的授权字符串
为HTTPHeaderField的Authorization赋值
文件上传的请求部分
- URLRequest
NSURL *url = [NSURL URLWithString:@"http://localhost/uploads/xxx.png"];
NSMutableURLRequest *requestM = [NSMutableURLRequest requestWithURL:url cachePolicy:0 timeoutInterval:2.0f];
requestM.HTTPMethod = @"PUT";
设置用户授权
1> 授权字符串(用户名+密码)
NSString *authStr = @"admin:123456";
2> BASE 64编码
NSData *authData = [authStr dataUsingEncoding:NSUTF8StringEncoding];
NSString *base64Str = [authData base64EncodedStringWithOptions:0];
NSString *auth = [NSString stringWithFormat:@"BASIC %@", base64Str];
[requestM setValue:auth forHTTPHeaderField:@"Authorization"];
1.NSURLSession的基本使用
- 1.1 涉及知识点
（1）使用步骤
使用NSURLSession创建task,然后执行task
（2）关于task
a.NSURLSessionTask是一个抽象类，本身不能使用，只能使用它的子类
b.NSURLSessionDataTask\NSURLSessionUploadTask\NSURLSessionDownloadTask
（3）发送get请求
1.创建NSURLSession对象（可以获取单例对象）
NSURLSession *session = [NSURLSession sharedSession];
2.根据NSURLSession对象创建一个Task
NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login?username=ss&pwd=ss&type=JSON"];
NSURLRequest *request = [NSURLRequest requestWithURL:url];
方法参数说明
注意：该block是在子线程中调用的，如果拿到数据之后要做一些UI刷新操作，那么需要回到主线程刷新
第一个参数：需要发送的请求对象
block:当请求结束拿到服务器响应的数据时调用block
block-NSData:该请求的响应体
block-NSURLResponse:存放本次请求的响应信息，响应头，真实类型为NSHTTPURLResponse
block-NSErroe:请求错误信息
NSURLSessionDataTask * dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * __nullable data, NSURLResponse * __nullable response, NSError * __nullable error) {
拿到响应头信息
NSHTTPURLResponse *res = (NSHTTPURLResponse *)response;
4.解析拿到的响应数据
NSLog(@"%@\n%@",[[NSString alloc]initWithData:data encoding:NSUTF8StringEncoding],res.allHeaderFields);
}];
3.执行Task
注意：刚创建出来的task默认是挂起状态的，需要调用该方法来启动任务（执行任务）
[dataTask resume];
（4）发送get请求的第二种方式
注意：该方法内部默认会把URL对象包装成一个NSURLRequest对象（默认是GET请求）
方法参数说明
第一个参数：发送请求的URL地址
block:当请求结束拿到服务器响应的数据时调用block
block-NSData:该请求的响应体
block-NSURLResponse:存放本次请求的响应信息，响应头，真实类型为NSHTTPURLResponse
block-NSErroe:请求错误信息
- (nullable NSURLSessionDataTask *)dataTaskWithURL:(NSURL *)url completionHandler:(void (^)(NSData * __nullable data, NSURLResponse * __nullable response, NSError * __nullable error))completionHandler;
（5）发送POST请求
1.创建NSURLSession对象（可以获取单例对象）
NSURLSession *session = [NSURLSession sharedSession];
2.根据NSURLSession对象创建一个Task
NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login"];
创建一个请求对象，并这是请求方法为POST，把参数放在请求体中传递
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
request.HTTPMethod = @"POST";
request.HTTPBody = [@"username=520it&pwd=520it&type=JSON" dataUsingEncoding:NSUTF8StringEncoding];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * __nullable data, NSURLResponse * __nullable response, NSError * __nullable error) {
拿到响应头信息
NSHTTPURLResponse *res = (NSHTTPURLResponse *)response;
解析拿到的响应数据
NSLog(@"%@\n%@",[[NSString alloc]initWithData:data encoding:NSUTF8StringEncoding],res.allHeaderFields);
}];
3.执行Task
注意：刚创建出来的task默认是挂起状态的，需要调用该方法来启动任务（执行任务）
[dataTask resume];
2.NSURLSession下载文件-代理
- 2.1 涉及知识点
（1）创建NSURLSession对象，设置代理（默认配置）
1.创建NSURLSession,并设置代理
第一个参数：session对象的全局配置设置，一般使用默认配置就可以
第二个参数：谁成为session对象的代理
第三个参数：代理方法在哪个队列中执行（在哪个线程中调用）,如果是主队列那么在主线程中执行，如果是非主队列，那么在子线程中执行
NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[NSOperationQueue mainQueue]];
（2）根据Session对象创建一个NSURLSessionDataTask任务（post和get选择）
创建task
NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/resources/images/minion_01.png"];
注意：如果要发送POST请求，那么请使用dataTaskWithRequest,设置一些请求头信息
NSURLSessionDataTask *dataTask = [session dataTaskWithURL:url];
（3）执行任务（其它方法，如暂停、取消等）
启动task
[dataTask resume];
其它方法，如取消任务，暂停任务等
[dataTask cancel];
[dataTask suspend];
（4）遵守代理协议，实现代理方法（3个相关的代理方法）
1.当接收到服务器响应的时候调用
session：发送请求的session对象
dataTask：根据NSURLSession创建的task任务
response:服务器响应信息（响应头）
completionHandler：通过该block回调，告诉服务器端是否接收返回的数据
-(void)URLSession:(nonnull NSURLSession *)session dataTask:(nonnull NSURLSessionDataTask *)dataTask didReceiveResponse:(nonnull NSURLResponse *)response completionHandler:(nonnull void (^)(NSURLSessionResponseDisposition))completionHandler
2.当接收到服务器返回的数据时调用
该方法可能会被调用多次
-(void)URLSession:(nonnull NSURLSession *)session dataTask:(nonnull NSURLSessionDataTask *)dataTask didReceiveData:(nonnull NSData *)data
3.当请求完成之后调用该方法
不论是请求成功还是请求失败都调用该方法，如果请求失败，那么error对象有值，否则那么error对象为空
-(void)URLSession:(nonnull NSURLSession *)session task:(nonnull NSURLSessionTask *)task didCompleteWithError:(nullable NSError *)error
（5）当接收到服务器响应的时候，告诉服务器接收数据（调用block）
默认情况下，当接收到服务器响应之后，服务器认为客户端不需要接收数据，所以后面的代理方法不会调用
如果需要继续接收服务器返回的数据，那么需要调用block,并传入对应的策略
NSURLSessionResponseCancel = 0, 取消任务
NSURLSessionResponseAllow = 1, 接收任务
NSURLSessionResponseBecomeDownload = 2, 转变成下载
NSURLSessionResponseBecomeStream NS_ENUM_AVAILABLE(10_11, 9_0) = 3, 转变成流
completionHandler(NSURLSessionResponseAllow);
3.NSURLSessionDownloadTask实现大文件下载
- 3.1 涉及知识点
（1）使用NSURLSession和NSURLSessionDownload可以很方便的实现文件下载操作
第一个参数：要下载文件的url路径
第二个参数：当接收完服务器返回的数据之后调用该block
location:下载的文件的保存地址（默认是存储在沙盒中tmp文件夹下面，随时会被删除）
response：服务器响应信息，响应头
error：该请求的错误信息
说明：downloadTaskWithURL方法已经实现了在下载文件数据的过程中边下载文件数据，边写入到沙盒文件的操作
NSURLSessionDownloadTask *downloadTask = [session downloadTaskWithURL:url completionHandler:^(NSURL * __nullable location, NSURLResponse * __nullable response, NSError * __nullable error)
（2）downloadTaskWithURL内部默认已经实现了变下载边写入操作，所以不用开发人员担心内存问题
（3）文件下载后默认保存在tmp文件目录，需要开发人员手动的剪切到合适的沙盒目录
（4）缺点：没有办法监控下载进度
4.使用NSURLSessionDownloadTask实现大文件下载-监听下载进度
（1）创建NSURLSession并设置代理，通过NSURLSessionDownloadTask并以代理的方式来完成大文件的下载
1.创建NSULRSession,设置代理
self.session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[NSOperationQueue mainQueue]];
2.创建task
NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/resources/videos/minion_
01.mp4”];
self.downloadTask = [self.session downloadTaskWithURL:url];
3.执行task
[self.downloadTask resume];
（2）常用代理方法的说明
1.当接收到下载数据的时候调用,可以在该方法中监听文件下载的进度
该方法会被调用多次
totalBytesWritten:已经写入到文件中的数据大小
totalBytesExpectedToWrite:目前文件的总大小
bytesWritten:本次下载的文件数据大小
-(void)URLSession:(nonnull NSURLSession *)session downloadTask:(nonnull NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
2.恢复下载的时候调用该方法
fileOffset:恢复之后，要从文件的什么地方开发下载
expectedTotalBytes：该文件数据的总大小
-(void)URLSession:(nonnull NSURLSession *)session downloadTask:(nonnull NSURLSessionDownloadTask *)downloadTask didResumeAtOffset:(int64_t)fileOffset expectedTotalBytes:(int64_t)expectedTotalBytes
3.下载完成之后调用该方法
-(void)URLSession:(nonnull NSURLSession *)session downloadTask:(nonnull NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(nonnull NSURL *)location
4.请求完成之后调用
如果请求失败，那么error有值
-(void)URLSession:(nonnull NSURLSession *)session task:(nonnull NSURLSessionTask *)task didCompleteWithError:(nullable NSError *)error
```
（3）实现断点下载相关代码
如果任务，取消了那么以后就不能恢复了
[self.downloadTask cancel];
如果采取这种方式来取消任务，那么该方法会通过resumeData保存当前文件的下载信息
只要有了这份信息，以后就可以通过这些信息来恢复下载
[self.downloadTask cancelByProducingResumeData:^(NSData * __nullable resumeData) {
self.resumeData = resumeData;
}];
继续下载
首先通过之前保存的resumeData信息，创建一个下载任务
self.downloadTask = [self.session downloadTaskWithResumeData:self.resumeData];
[self.downloadTask resume];
（4）计算当前下载进度
获取文件下载进度
self.progress.progress = 1.0 * totalBytesWritten/totalBytesExpectedToWrite;
（5）局限性
01 如果用户点击暂停之后退出程序，那么需要把恢复下载的数据写一份到沙盒，代码复杂度更
02 如果用户在下载中途未保存恢复下载数据即退出程序，则不具备可操作性
5.使用NSURLSessionDataTask实现大文件离线断点下载（完整）
- 5.1 涉及知识点
（1）关于NSOutputStream的使用
1. 创建一个输入流,数据追加到文件的屁股上
把数据写入到指定的文件地址，如果当前文件不存在，则会自动创建
NSOutputStream *stream = [[NSOutputStream alloc]initWithURL:[NSURL fileURLWithPath:[self fullPath]] append:YES];
2. 打开流
[stream open];
3. 写入流数据
[stream write:data.bytes maxLength:data.length];
4.当不需要的时候应该关闭流
[stream close];
（2）关于网络请求请求头的设置（可以设置请求下载文件的某一部分）
1. 设置请求对象
1.1 创建请求路径
NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/resources/videos/minion_01.mp4"];
1.2 创建可变请求对象
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
1.3 拿到当前文件的残留数据大小
self.currentContentLength = [self FileSize];
1.4 告诉服务器从哪个地方开始下载文件数据
NSString *range = [NSString stringWithFormat:@"bytes=%zd-",self.currentContentLength];
NSLog(@"%@",range);
1.5 设置请求头
[request setValue:range forHTTPHeaderField:@"Range"];
（3）NSURLSession对象的释放
-(void)dealloc
{
在最后的时候应该把session释放，以免造成内存泄露
NSURLSession设置过代理后，需要在最后（比如控制器销毁的时候）调用session的invalidateAndCancel或者
resetWithCompletionHandler，才不会有内存泄露
[self.session invalidateAndCancel];
[self.session resetWithCompletionHandler:^{
NSLog(@"释放---");
}];
}
（4）优化部分
01 关于文件下载进度的实时更新
02 方法的独立与抽取
6.NSURLSession实现文件上传
- 6.1 涉及知识点
（1）实现文件上传的方法
第一个参数：请求对象
第二个参数：请求体（要上传的文件数据）
block回调：
NSData:响应体
NSURLResponse：响应头
NSError：请求的错误信息
NSURLSessionUploadTask *uploadTask = [session uploadTaskWithRequest:request fromData:data completionHandler:^(NSData * __nullable data, NSURLResponse * __nullable response, NSError * __nullable error)
（2）设置代理，在代理方法中监听文件上传进度
调用该方法上传文件数据
如果文件数据很大，那么该方法会被调用多次
参数说明：
totalBytesSent：已经上传的文件数据的大小
totalBytesExpectedToSend：文件的总大小
-(void)URLSession:(nonnull NSURLSession *)session task:(nonnull NSURLSessionTask *)task didSendBodyData:(int64_t)bytesSent totalBytesSent:(int64_t)totalBytesSent totalBytesExpectedToSend:(int64_t)totalBytesExpectedToSend
{
NSLog(@"%.2f",1.0 * totalBytesSent/totalBytesExpectedToSend);
}
（3）关于NSURLSessionConfiguration相关
01 作用：可以统一配置NSURLSession,如请求超时等
02 创建的方式和使用
创建配置的三种方式
+ (NSURLSessionConfiguration *)defaultSessionConfiguration;
+ (NSURLSessionConfiguration *)ephemeralSessionConfiguration;
+ (NSURLSessionConfiguration *)backgroundSessionConfigurationWithIdentifier:(NSString *
)identifier NS_AVAILABLE(10_10, 8_0);
统一配置NSURLSession
-(NSURLSession *)session
{
if (_session == nil) {
创建NSURLSessionConfiguration
NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
设置请求超时为10秒钟
config.timeoutIntervalForRequest = 10;
在蜂窝网络情况下是否继续请求（上传或下载）
config.allowsCellularAccess = NO;
_session = [NSURLSession sessionWithConfiguration:config delegate:self delegateQueue:[NSOperationQueue mainQueue]];
}
return _session;
}
NSURLSessionConfiguration笔记
NSURLSessionConfiguration对象用于初始化NSURLSession对象。
展开请求级别中与NSMutableURLRequest相关的可供选择的方案，我们可以看到NSURLSessionConfiguration对于会话如何产生请求，提供了相当多的控制和灵活性。从网络访问性能，到cookie，安全性，缓存策略，自定义协议，启动事件设置，以及用于移动设备优化的几个新属性，你会发现你一直在寻找的，正是NSURLSessionConfiguration。
会话在初始化时复制它们的配置，NSURLSession有一个只读的配置属性，使得该配置对象上的变化对这个会话的政策无效。配置在初始化时被读取一次，之后都是不会变化的。
－构造方法
NSURLSessionConfiguration有三个类构造函数，这很好地说明了NSURLSession是为不同的用例而设计的。
- "defaultSessionConfiguration"返回标准配置，这实际上与NSURLConnection的网络协议栈是一样的，具有相同的共享NSHTTPCookieStorage，共享NSURLCache和共享NSURLCredentialStorage。
- "ephemeralSessionConfiguration"返回一个预设配置，没有持久性存储的缓存，Cookie或证书。这对于实现像"秘密浏览"功能的功能来说，是很理想的。
- "backgroundSessionConfiguration"：独特之处在于，它会创建一个后台会话。后台会话不同于常规的，普通的会话，它甚至可以在应用程序挂起，退出，崩溃的情况下运行上传和下载任务。初始化时指定的标识符，被用于向任何可能在进程外恢复后台传输的守护进程提供上下文。
想要查看更多关于后台会话的信息，可以查看WWDC Session 204: “What’s New with Multitasking”
－NSURLSessionConfiguration的属性
NSURLSessionConfiguration拥有20个属性。熟练掌握这些属性的用处，将使应用程序充分利用其网络环境。
最重要的属性：
替代 request 中的forHTTPHeaderField 告诉服务器有关客户端的附加信息
"HTTPAdditionalHeaders"指定了一组默认的可以设置出站请求的数据头。这对于跨会话共享信息，如内容类型，语言，用户代理，身份认证，是很有用的。
WebDav的身份验证
NSString *userPasswordString = [NSString stringWithFormat:@"%@:%@", user, password];
NSData * userPasswordData = [userPasswordString dataUsingEncoding:NSUTF8StringEncoding];
NSString *base64EncodedCredential = [userPasswordData base64EncodedStringWithOptions:0];
NSString *authString = [NSString stringWithFormat:@"Basic: %@", base64EncodedCredential];
设置客户端类型
NSString *userAgentString = @"iPhone AppleWebKit";
configuration.HTTPAdditionalHeaders = @{@"Accept": @"application/json",
@"Accept-Language": @"en",
@"Authorization": authString,
@"User-Agent": userAgentString};
"networkServiceType（网络服务类型）"对标准的网络流量，网络电话，语音，视频，以及由一个后台进程使用的流量进行了区分。大多数应用程序都不需要设置这个
"allowsCellularAccess（允许蜂窝访问）"和"discretionary（自行决定）"被用于节省通过蜂窝连接的带宽。建议在使用后台传输的时候，使用discretionary属性，而不是allowsCellularAccess属性，因为它会把WiFi和电源可用性考虑在内
"timeoutIntervalForRequest"和"timeoutIntervalForResource"指定了请求以及该资源的超时时间间隔。许多开发人员试图使用timeoutInterval去限制发送请求的总时间，但这误会了timeoutInterval的意思：报文之间的时间。timeoutIntervalForResource实际上提供了整体超时的特性，这应该只用于后台传输，而不是用户实际上可能想要等待的任何东西
"HTTPMaximumConnectionsPerHost"是Foundation 框架中URL加载系统的一个新的配置选项。它曾经被用于NSURLConnection管理私人连接池。现在有了NSURLSession，开发者可以在需要时限制连接到特定主机的数量
"HTTPShouldUsePipelining"也出现在NSMutableURLRequest，它可以被用于开启HTTP管道，这可以显着降低请求的加载时间，但是由于没有被服务器广泛支持，默认是禁用的
"sessionSendsLaunchEvents" 是另一个新的属性，该属性指定该会话是否应该从后台启动
"connectionProxyDictionary"指定了会话连接中的代理服务器。同样地，大多数面向消费者的应用程序都不需要代理，所以基本上不需要配置这个属性
关于连接代理的更多信息可以在 CFProxySupport Reference 找到。
"Cookie Policies"
－"HTTPCookieStorage" 是被会话使用的cookie存储。默认情况下，NSHTTPCookieShorage的 + sharedHTTPCookieStorage会被使用，这与NSURLConnection是相同的
－"HTTPCookieAcceptPolicy" 决定了该会话应该接受从服务器发出的cookie的条件
－"HTTPShouldSetCookies" 指定了请求是否应该使用会话HTTPCookieStorage的cookie
"Security Policies"
URLCredentialStorage 是会话使用的证书存储。默认情况下，NSURLCredentialStorage 的+ sharedCredentialStorage 会被使用使用，这与NSURLConnection是相同的
"TLSMaximumSupportedProtocol" 和 "TLSMinimumSupportedProtocol" 确定是否支持SSLProtocol版本的会话
"Caching Policies"
URLCache 是会话使用的缓存。默认情况下，NSURLCache 的 + sharedURLCache 会被使用，这与NSURLConnection是相同的
requestCachePolicy 指定了一个请求的缓存响应应该在什么时候返回。这相当于NSURLRequest 的-cachePolicy方法
"Custom Protocols"
protocolClasses是注册NSURLProtocol类的特定会话数组
网友评论