NSURLSession

最新推荐文章于 2021-06-02 15:05:13 发布

原创最新推荐文章于 2021-06-02 15:05:13 发布 · 476 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#NSURLSession

iPhone开发专栏收录该内容

30 篇文章

订阅专栏

本文详细介绍了iOS7中引入的NSURLSession接口，与NSURLConnection的区别及使用方法，包括配置、任务启动、数据返回方式、线程安全、后台网络操作、下载进度跟踪与断点续传等特性，并通过实例展示了如何使用NSURLSession进行文件下载，以及如何优化代码以避免主线程阻塞。同时，阐述了NSURLSession与NSURLConnection的互替条件以及各自的应用场景。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

NSURLConnection问题：

1. 做复杂的网络操作，需要使用代理来实现。比如下载大文件

2. 默认下载任务在主线程工作。

3. 默认这个任务的代理也是在主线程

4. 如果添加到子线程去执行，需要主动启动运行循环

5. 只提供开始和取消。不支持暂停。

使用NSURLSession肯定是异步

NSURLSession是iOS7中新的网络接口，与NSURLConnection是并列的。

当程序在前台时，NSURLSession与NSURLConnection大部分可以互相替代

NSURLSession支持后台网络操作，除非用户强行关闭

NSURLSession提供的功能：

通过URL将数据下载到内存

通过URL将数据下载到文件系统

将数据上传到指定URL

在后台完成上述功能

对于小型数据，例如用户登录、下载小图像、JSON&XML仍然使用NSURLConnection的异步或同步方法即可

NSURLSessionConfiguration

作用：用于定义和配置NSURLSession对象

每一个NSURLSession对象都可以设置不同的NSURLSessionConfiguration，从而满足应用内不同类型的网络请求

NSURLSessionConfiguration的三种类型：

(1)defaultSessionConfiguration默认session配置，类似NSURLConnection的标准配置，使用硬盘来存储缓存数据

(2)ephemeralSessionConfiguration临时session配置，与默认配置相比，这个配置不会将缓存、cookie等存在本地，只会存在内存里，所以当程序退出时，所有的数据都会消失

(3)backgroundSessionConfiguration后台session配置，与默认配置类似，不同的是会在后台开启另一个线程来处理网络数据

NSURLSession的使用

1.使用NSURLSessionConfiguration来配置NSURLSession对象

2.用NSURLSession对象来启动一个NSURLSessionTask对象

提示：

可以使用系统全局的sharedSession单例来满足大多数的需求

相比较NSURLConnection的返回处理，NSURLSession提供了灵活的数据返回方式，可以使用简单的block方式来处理返回数据，也可以使用更强大的delegate

URLSession是线程安全的，在多线程方面的支持也比URLConnection要好

NSURLSessionTask

NSURLSession使用NSURLSessionTask来具体执行网络请求的任务

NSURLSessionTask支持网络请求的取消、暂停和恢复，比如下载文件暂停之后再恢复就能够自动从上次的进度继续下载

NSURLSessionTask还能获取数据的读取进度

NSURLSessionTask的三种类型：

(1)NSURLSessionDataTask处理一般的NSData数据对象，比如通过GET或POST方式从服务器获取JSON或XML返回等等，但不支持后台获取

(2)NSURLSessionUploadTask用于PUT上传文件，支持后台上传

(3)NSURLSessionDownloadTask用于下载文件，支持后台下载

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

基本使用：

<span style="color:#990000;"> </span>// 1. url
    NSURL *url = [NSURL URLWithString:@"http://192.168.10.9/videos.json"];
    
    // 2. 创建session
    // 苹果直接提供了一个全局的session
    NSURLSession *session = [NSURLSession sharedSession];
    
    // 3. 由session发起任务
    NSURLSessionDataTask *task = [session dataTaskWithURL:url completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        
        // 反序列化
        id result = [NSJSONSerialization JSONObjectWithData:data options:0 error:NULL];
        
        NSLog(@"%@", result);
    }];
    
    // 4. 需要把任务开始。 默认都是挂起
    [task resume];

优化上面的代码：

// 1. url
    NSURL *url = [NSURL URLWithString:@"http://192.168.10.9/videos.json"];
    
    // 2. 由session发起任务
    [[[NSURLSession sharedSession] dataTaskWithURL:url completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        
        // 反序列化
        id result = [NSJSONSerialization JSONObjectWithData:data options:0 error:NULL];
        
        NSLog(@"%@", result);
        
        
        // 更新UI在主线程
        dispatch_async(dispatch_get_main_queue(), ^{
            NSLog(@"更新UI");
        });
        
    }] resume];

URLSession下载：

解压缩有个第三方框架，导入第三方框架，然后再导入libz包来支持这个框架

NSURLSession下载，默认将下载的文件保存到tmp目录下。如果回调方法什么事情都没做。tmp里面的东西会自动删除
 
 比如：通常从服务器下载的是压缩包（压缩包会省流量）.
 
 当文件下载完成以后，会解压缩。 原始的zip包不需要了。
 
 解压缩也是耗时操作。也需要在子线程执行
#import "ViewController.h"
#import "SSZipArchive.h"

@interface ViewController ()

@end

@implementation ViewController

- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event {
    
    // 1. url
    NSString *urlStr = @"http://127.0.0.1/itcast/images.zip";
    urlStr = [urlStr stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
    
    NSURL *url = [NSURL URLWithString:urlStr];
    
    // 2. 下载
    [[[NSURLSession sharedSession] downloadTaskWithURL:url completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) {
        
        NSLog(@"文件的路径%@", location.path);
        
        NSString *cacheDir = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject];
        NSLog(@"%@", cacheDir);
        /**
         FileAtPath：要解压缩的文件
         Destination: 要解压缩到的路径
         */
        [SSZipArchive unzipFileAtPath:location.path toDestination:cacheDir];
        
    }] resume];
}

NSURLSession跟踪下载进度：

- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event {
    
    // 1. url
    NSString *urlStr = @"http://127.0.0.1/01-课程概述.mp4";
    urlStr = [urlStr stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
    
    NSURL *url = [NSURL URLWithString:urlStr];
    
    // 2. 实例化一个session对象
    // Configuration可以配置全局的网络访问的参数
    NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
    
    // 指定回调方法工作的线程
//    NSURLSession *session = [NSURLSession sessionWithConfiguration:config delegate:self delegateQueue:[[NSOperationQueue alloc] init]];
    // NSURLSession 如果不指定线程，默认就是子线程
    NSURLSession *session = [NSURLSession sessionWithConfiguration:config delegate:self delegateQueue:nil];
    
    // 发起并且继续任务。
    [[session downloadTaskWithURL:url] resume];
}

#pragma mark - NSURLSessionDownloadDelegate
// 1. 下载完成被调用的方法  iOS 7 & iOS 8都必须实现
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location
{
    NSLog(@"下载完成..");
}

// 2. 下载进度变化的时候被调用的。 iOS 8可以不实现
/**
 bytesWritten：     本次写入的字节数
 totalBytesWritten：已经写入的字节数（目前下载的字节数）
 totalBytesExpectedToWrite： 总的下载字节数(文件的总大小)
 */
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
{
    float progress = (float)totalBytesWritten / totalBytesExpectedToWrite;
    NSLog(@"%f---%@", progress, [NSThread currentThread]);
}

// 3. 短点续传的时候，被调用的。一般什么都不用写 iOS 8可以不实现
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didResumeAtOffset:(int64_t)fileOffset expectedTotalBytes:(int64_t)expectedTotalBytes
{

}

NSURLSession断点续传：（注意强引用问题）

<pre name="code" class="objc">/**下载任务*/
@property(nonatomic,strong)NSURLSessionDownloadTask *downloadTask;

/**全局管理的会话*/
@property(nonatomic,strong)NSURLSession *session;

/**续传的数据*/
@property(nonatomic,strong)NSData *resumeData;

@end

@implementation ViewController


- (void)dealloc
{
    NSLog(@"888");
}

- (NSURLSession *)session
{
    if (_session == nil) {
        
        NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];

        _session = [NSURLSession sessionWithConfiguration:config delegate:self delegateQueue:nil];
    }
    return _session;
}

/**继续*/
- (IBAction)resume:(id)sender
{
    if (self.resumeData == nil) {
        NSLog(@"没有续传的数据");
        return;
    }
    
    // 使用上一次的记录，新建一个下载任务
    self.downloadTask =  [self.session downloadTaskWithResumeData:self.resumeData];
    
    // 一旦任务建立完成，之前的续传数据没有用，释放掉
    self.resumeData = nil;
    
    [self.downloadTask resume];
}

/**暂停*/
- (IBAction)pause:(id)sender
{
    NSLog(@"%s", __func__);
    
    [self.downloadTask cancelByProducingResumeData:^(NSData *resumeData) {
        
        NSLog(@"＝----%tu", resumeData.length);
        
        // 保存起来暂停的时候的字节数
        self.resumeData = resumeData;
        
        // 释放下载任务
        self.downloadTask = nil;
    }];
}

- (IBAction)start {
    
    // 1. url
    NSString *urlStr = @"http://127.0.0.1/01-课程概述.mp4";
    urlStr = [urlStr stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
    
    NSURL *url = [NSURL URLWithString:urlStr];
    
    // 2. 通过session对象 开始一个任务
    self.downloadTask = [self.session downloadTaskWithURL:url];
   
    // 继续
    [self.downloadTask resume];
}

/**视图将要消失的时候，取消session*/
- (void)viewWillDisappear:(BOOL)animated
{
    [super viewWillDisappear:animated];
    
    // 任务完成，取消NSURLSession
    [self.session invalidateAndCancel];
    // 释放会话
    self.session = nil;
}

#pragma mark - NSURLSessionDownloadDelegate
// 1. 下载完成被调用的方法  iOS 7 & iOS 8都必须实现
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location
{
    NSLog(@"下载完成..");
    
    // 任务完成，取消NSURLSession
    [self.session invalidateAndCancel];
    // 释放会话
    self.session = nil;
    
    self.downloadTask = nil;
}

// 2. 下载进度变化的时候被调用的。 iOS 8可以不实现
/**
 bytesWritten：     本次写入的字节数
 totalBytesWritten：已经写入的字节数（目前下载的字节数）
 totalBytesExpectedToWrite： 总的下载字节数(文件的总大小)
 */
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
{
    float progress = (float)totalBytesWritten / totalBytesExpectedToWrite;
    NSLog(@"%f---%@", progress, [NSThread currentThread]);
}

// 3. 断点续传的时候，被调用的。一般什么都不用写 iOS 8可以不实现
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didResumeAtOffset:(int64_t)fileOffset expectedTotalBytes:(int64_t)expectedTotalBytes
{
    
}