iOS NSURLSession 讲解 (一)

2018-07-03 本文已影响47人奔跑吧小蚂蚁

NSURLSession

在2013年的时候, 苹果推出了iOS 7, 这个版本的iOS被称为革命性的iOS, 而我们以前所用到的NSURLConnection这个网络库也被苹果爸爸给重构, 并且重新命名为NSURLSession.

现在在GitHub里用的最多的两个库AFNetworking, SDWebImage都是用了NSURLSession.

这里就不废话了, 直接来知识点吧.

网络通信
关于Session的意思, 我这里找到一段比较古方的解释:

Session翻译为中文意思是会话，我们知道，在七层网络协议中有物理层->数据链路层->网络层->传输层->会话层->表示层->应用层，那我们可以将NSURLSession类理解为会话层，用于管理网络接口的创建、维护、删除等等工作，我们要做的工作也只是会话层之后的层即可，底层的工作NSURLSession已经帮我们封装好了.

看到这我们就很激动, 因为底层的东西不需要我们去管理, 这就轻松多了.

NSURLSession的分支

我们都知道苹果爸爸用NSURLSession代替了NSURLConnection, 那么NSURLSession里面到底有什么呢?

NSURLSession父类:

NSURLSession
NSURLSessionConfiguration

NSURLSessionTask子类:

NSURLSessionDataTask
NSURLSessionUploadTask
NSURLSessionDownloadTask
NSURLSessionStreamTask (iOS 9后才支持)

NSURLSession关系图.png

NSURLSessionTask子类的继承关系:

NSURLSessionTask子类的继承关系.png

NSURLSessionDataTask: 主要使用在请求一些比较简单的数据, 比如我们常用的JSON数据.
NSURLSessionDownloadTask: 这个主要使用在进行一些文件的下载, 它可以针对一些大文件的网络请求做更多的处理, 比如获取下载进度, 文件的断点续传等等牛逼事情.
NSURLSessionUploadTask: 这个和上面那个task对应, 主要是给服务器发送文件数据所使用的.
NSURLSessionStreamTask: 提供TCP/IP的一个链接入口, 方便进行传输.

使用NSURLSession

不要以为看完了上面就可以直接拿来和服务器交互了啦, 因为NSURLSession本身是不会进行请求, 需要通过创建对应的task, 然后配置完之后, 再去调用resume()方法才能够进行通信.
这里有一个好消息就是同意个NSURLSession是可以创建多个task, 并且这些task的cache和cookie都是共享的.

使用NSURLSession的步骤:

创建NSURLSession对象
使用NSURLSession创建对应的task
最后一步就是调用resume()方法, 开始请求.

创建NSURLSession对象有三种方法, 这里就不创建工程里, 直接贴代码吧:
第一种:

// 获取一个共享的单例会话对象
    NSURLSession *urlSession = [NSURLSession sharedSession];

第二种:

// 用NSURLSessionConfiguration获取一个特定的NSURLSession
NSURLSession *urlSession = [NSURLSession sessionWithConfiguration:<#(nonnull NSURLSessionConfiguration *)#>];

第三种:

// 用NSURLSessionConfiguration获取一个特定的NSURLSession, 并且设置好代理对象, 和代理的队列
    NSURLSession *urlSession = [NSURLSession sessionWithConfiguration:<#(nonnull NSURLSessionConfiguration *)#>
                                                             delegate:<#(nullable id<NSURLSessionDelegate>)#>
                                                        delegateQueue:<#(nullable NSOperationQueue *)#>]

配置NSURLSession

刚刚我们也提到, NSURLSession是没法直接进行请求的, 所以我们需要去配置一下, 这里也有三种配置的方法.
第一种:

// NSURLSessionConfiguration的默认配置, 这种配置会把缓存数据存储到磁盘上
@property (class, readonly, strong) NSURLSessionConfiguration *defaultSessionConfiguration;

NSURLSession *urlSession = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration]];

第二种:

// NSURLSessionConfiguration的第二种配置, 这种配置不会把数据持久化, 也就是说不会存储到磁盘上
@property (class, readonly, strong) NSURLSessionConfiguration *ephemeralSessionConfiguration;

NSURLSession *urlSession = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration ephemeralSessionConfiguration]];

第三种:

// 这个配置可以允许程序在后台进行上传和下载的操作, 给定一个Identifier可以在系统关闭应用之后重启, 根据给定的`Identifier`终止正在下载或者上传操作, 但如果是用户手动关闭了应用, 系统就会取消所有后台传输的会话, 官方建议, 如果要时候后台操作的话, 把discretionary属性设置成为YES, 可以获得更好地性能.
+ (NSURLSessionConfiguration *)backgroundSessionConfigurationWithIdentifier:(NSString *)identifier NS_AVAILABLE(10_10, 8_0);

NSURLSession *urlSession = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration backgroundSessionConfigurationWithIdentifier:@"backgroundSessionConfiguration"]];

使用NSURLSession创建Task

刚刚我们也说了, NSURLSession是有三个子类的Task, 所以这里我们也要分开来说说.
NSURLSessionDataTask:

// 通过指定的NSURL来创建一个NSURLSessionDataTask
NSURLSessionDataTask *dataTask = [urlSession dataTaskWithURL:[NSURL URLWithString:@""]];

// 通过指定的NSURL对象来创建, 并同时执行完对应的任务后通过completionHandler:返回NSURLSessionDataTask
NSURLSessionDataTask *dataTask = [urlSession dataTaskWithURL:[NSURL URLWithString:@""]
                                           completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
                                           }];

// 通过指定的NSURLRequest对象来创建一个NSURLSessionDataTask
NSURLSessionDataTask *dataTask = [urlSession dataTaskWithRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@""]]];

// 通过指定的NSURLRequest对象来创建, 并同时执行完对应的任务后通过completionHandler:返回NSURLSessionDataTask
NSURLSessionDataTask *dataTask = [urlSession dataTaskWithRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@""]]
                                               completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
                                                   }];

NSURLSessionUploadTask:

// 通过指定的NSURLRequest对象来创建一个NSURLSessionUploadTask
NSURLSessionUploadTask *uploadTask = [urlSession uploadTaskWithStreamedRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@""]]];

// 通过指定的NSURLRequest对象来创建一个NSURLSessionUploadTask, 并且指定上传时所需的数据源
NSURLSessionUploadTask *uploadTask = [urlSession uploadTaskWithRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@""]]
                                                              fromData:[NSData data]];

// 通过指定的NSURLRequest对象来创建一个NSURLSessionUploadTask, 并且指定上传时所需的文件源
NSURLSessionUploadTask *uploadTask = [urlSession uploadTaskWithRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@""]]
                                                              fromFile:[NSURL URLWithString:@""]];

// 通过指定的NSURLRequest对象来创建, 指定上传时所需的文件源, 并且同时执行完对应的任务后通过completionHandler:来返回NSURLSessionUploadTask
NSURLSessionUploadTask *uploadTask = [urlSession uploadTaskWithRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@""]]
                                                              fromFile:[NSURL URLWithString:@""]
                                                     completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
                                                     }];

// 通过指定的NSURLRequest对象来创建, 指定上传时所需的数据源, 并且同时执行完对应的任务后通过completionHandler:来返回NSURLSessionUploadTask
NSURLSessionUploadTask *uploadTask = [urlSession uploadTaskWithRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@""]]
                                                              fromData:[NSData data]
                                                     completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
                                                     }];

NSURLSessionDownloadTask:

// 通过指定的NSURL对象来创建一个NSURLSessionDownloadTask
NSURLSessionDownloadTask *downloadTask = [urlSession downloadTaskWithURL:[NSURL URLWithString:@""]];

// 通过指定的NSURL对象来创建一个NSURLSessionDownloadTask, 并同时执行完对应的任务后通过completionHandler:返回NSURLSessionDownloadTask
NSURLSessionDownloadTask *downloadTask = [urlSession downloadTaskWithURL:[NSURL URLWithString:@""]
                                                       completionHandler:^(NSURL * _Nullable location, NSURLResponse * _Nullable response, NSError * _Nullable error) {    
                                                       }];

// 通过指定的NSURLRequest对象来创建一个NSURLSessionDownloadTask
NSURLSessionDownloadTask *downloadTask = [urlSession downloadTaskWithRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@""]]];

// 通过指定的NSURLRequest对象来创建一个NSURLSessionDownloadTask, 并同时执行完对应的任务后通过completionHandler:返回NSURLSessionDownloadTask
NSURLSessionDownloadTask *downloadTask = [urlSession downloadTaskWithRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@""]]
                                                           completionHandler:^(NSURL * _Nullable location, NSURLResponse * _Nullable response, NSError * _Nullable error) {                                                             
                                                           }];

// 通过指定的NSData对象来创建一个NSURLSessionDownloadTask, 这个NSData对象是之前下载失败或者是停止下载了的数据, 这就是我们常说的断点续传
NSURLSessionDownloadTask *downloadTask = [urlSession downloadTaskWithResumeData:[NSData data]];

// 通过指定的NSData对象来创建一个NSURLSessionDownloadTask, , 并同时执行完对应的任务后通过completionHandler:返回NSURLSessionDownloadTask, 同时也是支持断点续传
NSURLSessionDownloadTask *downloadTask = [urlSession downloadTaskWithResumeData:[NSData data]
                                                              completionHandler:^(NSURL * _Nullable location, NSURLResponse * _Nullable response, NSError * _Nullable error) {
                                                              }];

NSURLSessionStreamTask:

// 通过一个指定的NSNetService对象来创建NSURLSessionStreamTask
NSURLSessionStreamTask *streamTask = [urlSession streamTaskWithNetService:[[NSNetService alloc] init]];

// 通过一个指定的IP地址, 端口号来创建一个NSURLSessionStreamTask
NSURLSessionStreamTask *streamTask = [urlSession streamTaskWithHostName:@"192.168.1.1"
                                                                   port:8888];

NSURLSessionDelegate

刚刚讲完了三种Task, 这里补充一下, 就是说我们无论会用哪一种Task, 我们都可以指定对应的代理, 这里有一张NSURLSession代理关系图:

NSURLSession代理关系图.png

代理关系图.png

详细大家都会用代理方法, 这里就不介绍了.

执行任务

刚刚说完了那么多东西, 最后就差执行任务了:

酱紫就完事啦, 如果还想了解更多的话, 可以去看看苹果爸爸的官方文档.