IOS - 网络请求之NSURLSession

序言

仅做自身巩固学习之用！！！

<一> 枯燥的定义与优势描叙

1. NSURLSession 特点 :

NSURLSession 可以发送 Get / Post 请求，实现文件的下载和上传；
NSURLSession 只提供了异步请求的方式获取数据，所以支持后台下载|上传；
提供了全局的 session 并且可以统一配置，使用更加方便，同一个 session 发送多个请求，只需要建立一次连接（复用了TCP）
在NSURLSesiion中，任何请求都可以被看做是一个任务。根据NSURLSession会话对象创建一个请求任务（NSURLSessionTask），然后执行该任务即可，包括缓存，会话周期，多线程任务的iOS都已经在SDK层面封装完毕，其中有三种任务类型

2. NSURLSessionTask，是一个抽象类，有两个子类 - NSURLSessionDataTask 和 NSURLSessionDownloadTask

NSURLSessionTask家族图.png

NSURLSessionDataTask，可以用来处理一般的网络请求，如：GET/POST请求等；
NSURLSessionUploadTask 是 NSURLSessionDataTask的子类，专门用来处理上传的请求；
NSURLSessionDownloadTask，主要用于处理下载的请求。

<二> NSURLSession 剖析与使用：

NSURLSession发送请求非常简单，与connection不同的是，任务创建后不会自动发送请求，需要手动开始执行任务；三种获取session对象的方法：
1.方法一，直接获取session会话对象

NSURLSession*session = [NSURLSession sharedSession];

2.方法二，该方法需要首先创建会话请求的基本配置（NSURLSessionConfiguration）

NSURLSession*session = [NSURLSession sessionWithConfiguration:<#(nonnull NSURLSessionConfiguration *)#>];

NSURLSessionConfiguration ：有三种类型：

// 1.默认配置使用的是持久化的硬盘缓存，存储证书到用户钥匙链。存储cookie到shareCookie。
NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];

// 2.不使用永久持存cookie、证书、缓存的配置，最佳优化数据传输。
NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration ephemeralSessionConfiguration];

// 3.可以上传下载HTTP和HTTPS的后台任务(程序在后台运行)。在后台时，将网络传输交给系统的单独的一个进程,即使app挂起、推出甚至崩溃照样在后台执行。
NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration backgroundSessionConfigurationWithIdentifier:@"Identifier"];

通过NSURLSessionConfiguration可以统一设置超时时间、请求头等信息

// 设置请求超时为10秒钟
configuration.timeoutIntervalForRequest = 10;   
// 在蜂窝网络情况下是否继续请求（上传或下载）
configuration.allowsCellularAccess = false;
//配置请求头
configuration.HTTPAdditionalHeaders =@{@"Content-Encoding":@"gzip"};

3.方法三，该方式会为session会话设置代理对象，当发起网络请求后，在系统的代理方法中可以获取到请求的详细情况，特别是在数据的下载过程中 (系统的代理方法就不展示了，根据方法名就可以知道了！！！)

NSURLSession*session = [NSURLSession sessionWithConfiguration:<#(nonnull NSURLSessionConfiguration *)#> delegate:<#(nullable id<NSURLSessionDelegate>)#> delegateQueue:<#(nullable NSOperationQueue *)#>];

<三> NSURLSessionDataTask 剖析与使用：

NSURLSessionDataTask 苹果提供了两类创建方式 :

1.方法一该方法是由会话(session) 通过请求设置(NSURLRequest) 创建的网络请求任务,但是此处有一点需要注意（看代码注释）

//  根据请求对象创建任务task
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:<#(nonnull NSURLRequest *)#>]
// 如果使用Block回调时，会话（session）的代理方法将不会再走！！！
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:<#(nonnull NSURLRequest *)#> completionHandler:<#^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error)completionHandler#>]

NSURLRequest 对象是用来封装网络请求的url ，同时设置网络请求的超时时间、请求方法(GET/POST)、请求头、请求体等等

// 确定请求路径
NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login"];
// 创建可变请求对象
NSMutableURLRequest *requestM = [NSMutableURLRequest requestWithURL:url];
// 修改请求方法
requestM.HTTPMethod = @"POST";
// 设置请求体
requestM.HTTPBody = [@"username=520&pwd=520&type=JSON" dataUsingEncoding:NSUTF8StringEncoding];
// 超时时间
requestM.timeoutInterval = 30.0f;

2.方法二该方法根据网络请求的url可以直接创建任务Task,但是此处有一点需要注意（看代码注释）

// 根据网络请求的地址url创建任务，请求的设置采用 默认的
NSURLSessionDataTask *dataTask = [session dataTaskWithURL:<#(nonnull NSURL *)#>]
// 如果使用Block回调时，会话（session）的代理方法将不会再走！！！
NSURLSessionDataTask *dataTask = [session dataTaskWithURL:<#(nonnull NSURL *)#> completionHandler:<#^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error)completionHandler#>]

NSURLSessionUploadTask 苹果提供了三类创建方式 :

1.方法一

NSURLSessionUploadTask *uploadTask = [session uploadTaskWithRequest:<#(nonnull NSURLRequest *)#> fromData:<#(nonnull NSData *)#>];
// 如果使用Block回调时，会话（session）的代理方法将不会再走！！！
NSURLSessionUploadTask *uploadTask = [session uploadTaskWithRequest:<#(nonnull NSURLRequest *)#> fromData:<#(nullable NSData *)#> completionHandler:<#^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error)completionHandler#>];

2.方法二

NSURLSessionUploadTask *uploadTask = [session uploadTaskWithRequest:<#(nonnull NSURLRequest *)#> fromFile:<#(nonnull NSURL *)#>];
// 如果使用Block回调时，会话（session）的代理方法将不会再走！！！
NSURLSessionUploadTask *uploadTask = [session uploadTaskWithRequest:<#(nonnull NSURLRequest *)#> fromFile:<#(nonnull NSURL *)#> completionHandler:<#^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error)completionHandler#>];

3.方法三

NSURLSessionUploadTask *uploadTask = [session uploadTaskWithStreamedRequest:<#(nonnull NSURLRequest *)#>];

<四> NSURLSessionDownloadTask 剖析与使用：

苹果提供了三类创建方式 :