NSURLSession 教程

作者: i红人 | 来源:发表于2015-01-11 17:26 被阅读10420次

    为什么要使用NSURLSession?

    翻译原文 ,所有版权规其所有。

    well,先来看一些优点:

    • 后台上传和下载:只需在创建NSURLSession的时候配置一个选项,就能得到后台网络的所有好处。这样可以延长电池寿命,并且还支持UIKit的多task,在进程间使用相同的委托模型。

    • 能够暂停和恢复网络操作:使用NSURLSession API能够暂停,停止,恢复所有的网络任务,再也完全不需要子类化NSOperation.

    • 可配置的容器:对于NSURLSession里面的requests来说,每个NSURLSession都是可配置的容器。举个例来说,假如你需要设置HTTP header选项,你只用做一次,session里面的每个request就会有同样的配置。

    • 提高认证处理:认证是在一个指定的连接基础上完成的。在使用NSURLConnection时,如果发出一个访问,会返回一个任意的request。此时,你就不能确切的知道哪个request收到了访问。而在NSURLSession中,就能用代理处理认证。

    • 丰富的代理模式:在处理认证的时候,NSURLConnection有一些基于异步的block方法,但是它的代理方法就不能处理认证,不管请求是成功或是失败。在NSURLSession中,可以混合使用代理和block方法处理认证。

    • 上传和下载通过文件系统:它鼓励将数据(文件内容)从元数据(URL和settings)中分离出来。

    NSURLSession vs NSURLConnection

    “哇喔,看起来NSURLSession好复杂!”,你可能会这样想。“还是坚持用NSURLConnection吧。”

    别担心 — 使用NSURLSession处理简单task就如使用NSURLConnection一样容易。例如,我们使用一个简单的网络调用,来得到伦敦最新天气的JSON数据。

    假设你有这样一个URL字符串:

    NSString *londonWeatherUrl = @"http://api.openweathermap.org/data/2.5/weather?q=London,uk" ;
    

    首先,使用NSURLConnection会这么做:

    NSURLRequest *request = [NSURLRequest requestWithURL:
    [NSURL URLWithString:londonWeatherUrl]];
    [NSURLConnection sendAsynchronousRequest:request queue:[NSOperationQueue mainQueue] completionHandler:^(NSURLResponse *response,
                       NSData *data,
                       NSError *connectionError) {
      // handle response
      }];  
    

    那来看下NSURLSession是怎么做的。这个是NSURLSession使用的最简单方法。随后你还会看到怎样配置session,设置其他的特性,比如代理。

    NSURLSession *session = [NSURLSession sharedSession];
    [[session dataTaskWithURL:[NSURL URLWithString:londonWeatherUrl]
          completionHandler:^(NSData *data,
                              NSURLResponse *response,
                              NSError *error) {
            // handle response
    }] resume];  
    

    注意,你不需要指定运行哪个队列,默认会开辟一个后台线程。如果有两个的话,这种设计可能就比较难区分之间的不同。苹果官方旨在使用dataTaskWithURL来代替NSURLConnection中的sendAsynchronousRequest

    看吧,NSURLSession就如NSURLConnection一样易用,并且还有一些额外的功能。

    NSURLSession vs AFNetworking

    说到网络请求不得不说的就是AFNetworking Framework。这是iOS/OS X上最流行的框架之一,由Mattt Thompson创建。
    <pre>
    <b>注意</b>:学习AFNetworking,可以在github页面上找到,<a harf="https://github.com/AFNetworking/AFNetworking">https://github.com/AFNetworking/AFNetworking</a>,你还可以看这篇教程<a harf="http://www.raywenderlich.com/30445/afnetworking-crash-course">http://www.raywenderlich.com/30445/afnetworking-crash-course</a>
    </pre>

    下面是对于同样的数据请求,AFNetworking 1.x的代码:

    NSURLRequest *request = [NSURLRequest requestWithURL:
                         [NSURL URLWithString:londonWeatherUrl]];
    
    AFJSONRequestOperation *operation =
    [AFJSONRequestOperation JSONRequestOperationWithRequest:request
    success:^(NSURLRequest *request,
              NSHTTPURLResponse *response,
              id JSON) {
    // handle response
    } failure:nil];
    [operation start];  
    

    使用AFNetworking的好处之一是,它的处理响应数据是数据类型类,AFJSONRequestOperation(或类似XML,plist)的返回成功的block里面已经解析出了你要的数据。而NSURLSession接收到的是NSData类型,你需要把它再转换成JSON类型。

    <pre>
    <b>注意:</b>用NSJSONSerialization可以轻松的将NSData类型转换为JSON类型。
    </pre>

    那么,你是喜欢用AFNetworking还是NSURLSession呢?
    个人认为,简单的需求最好用NSURlSession-这可减少工程里面第三方库的依赖。当然了,现在AFNetworking也添加了新的代理,配置,基于task的API等等特性。

    如果你使用了AFNetworking2.0的新特性,比如系列化,并且还集成了UIKit(加入了一些UIImageView的类目方法),现在就很难说服你不用它了。

    <pre>
    <b>注意:</b>在AFNetworking2.0的分支,他们已经转成使用NSURLSession。
    <a harf="https://github.com/AFNetworking/AFNetworking/wiki/AFNetworking-2.0-Migration-Guide">https://github.com/AFNetworking/AFNetworking/wiki/AFNetworking-2.0-Migration-Guide</a>
    </pre>

    译者注:中间这里有一部分讲到了Dropbox,这里就不翻译了。对于Dropbox,国内墙得厉害,完全打不开。

    NSURLSession 类套(suite of classes)

    苹果公司描述了新类NSURLSession,及其类套。包括新的上传,下载,处理认证等工具,能处理http协议中的所用事情。

    在编码前,重要的先理解它们是怎样协同工作的。

    NSurLSessionNSuRLSessionConfiguration和可选代理(optional delegate)构成。再根据你的网络需求通过NSURLSessionTask来创建session。

    NSURLSessionConfiguration

    有三个方法用来创建NSURLSessionConfiguration:

    • defaultSessionConfiguration- 使用全局的cache,cookie和credential storage objects来创建configuration对象。

    • ephemeralSessionConfiguration – 这个configuration用于“private” sessions,还有对于cache, cookie, or credential storage objects的非永久存储。

    • backgroundSessionConfiguration – 做远程push通知或是应用程序挂起的时候就要用到这个configuration。

    一旦创建了NSURLSessionConfiguration就可以给它设置各种属性:

    NSURLSessionConfiguration *sessionConfig =
    [NSURLSessionConfiguration defaultSessionConfiguration];
    
    // 1
    sessionConfig.allowsCellularAccess = NO;
    
    // 2
    [sessionConfig setHTTPAdditionalHeaders:
          @{@"Accept": @"application/json"}];
    
    // 3
    sessionConfig.timeoutIntervalForRequest = 30.0;
    sessionConfig.timeoutIntervalForResource = 60.0;
    sessionConfig.HTTPMaximumConnectionsPerHost = 1;
    
    1. 限制了网络只能是wifi。
    2. 设置了所有的请求只接收JSON数据
    3. 配置网络超时,限制一个主机只有一个网络连接。

    这里仅仅只做了一些简单的配置,看文档去了解更多的属性吧。

    NSURLSession

    NSURLSession是为了代替NSURLConnection而设计的。Sessions的所有工作都是通过它的小弟,也就是NSURLSessionTask的对象。可以用block,delegate,或者两者混合来创建task。举个例子,你要下载图片,就要创建NSURLSessionDownloadTask

    首先需要创建session:

    // 1
    NSString *imageUrl =
    @"http://www.raywenderlich.com/images/store/    iOS7_PDFonly_280@2x_authorTBA.png";
    
    // 2
    NSURLSessionConfiguration *sessionConfig =[NSURLSessionConfiguration defaultSessionConfiguration];
    
    // 3
    NSURLSession *session =[NSURLSession sessionWithConfiguration:sessionConfig
                                delegate:self
                           delegateQueue:nil];
    

    ok,这个看上去和前面的只有点不同,一步一步看:

    1. 这里下载一张图片(译者改:原文匪夷所思)。
    2. 创建NSURLConfiguration
    3. 用当前类对象作为代理创建session。

    之后,通过创建带有完成处理的task来下载图片:

    // 1
    NSURLSessionDownloadTask *getImageTask =
    [session downloadTaskWithURL:[NSURL URLWithString:imageUrl]
    
    completionHandler:^(NSURL *location,
                        NSURLResponse *response,
                        NSError *error) {
    // 2
    UIImage *downloadedImage =
          [UIImage imageWithData:
              [NSData dataWithContentsOfURL:location]];
    //3
    dispatch_async(dispatch_get_main_queue(), ^{
        // do stuff with image
        _imageWithBlock.image = downloadedImage;
      });
      }];
    
    // 4
    [getImageTask resume];  
    

    很好,现在看起来像网络请求代码了!

    1. task由session创建。上面是创建了一个基于block的方法。你还可以用NSURLSessionDownloadDelegate跟踪下载进度:

       -URLSession:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite:  
      
    2. 通过location变量来得到image指针。

    3. 然后是更新UIImageView的图片。

    4. 开始这个task。

    5. session能够轻松的创建task,并发送到代理方法,通知你完成。

    这是像上面使用相同的session:

    // 1
    NSURLSessionDownloadTask *getImageTask = [session downloadTaskWithURL:[NSURL URLWithString:imageUrl]];
    
    [getImageTask resume];  
    
    1. 如果你接下来什么都不做的话,我们就使用这些代码。那么,就需要实现这个协议中的代理方法NSURLSessionDownloadDelegate。首先是,收到下载完成的通知:

       -(void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location { 
       // use code above from completion handler 
       }  
      

    这里再一次给你提供了location,然后用它就能获取image。

    最后,如果需要跟踪下载进度:

    -(void)URLSession:(NSURLSession *)session
         downloadTask:(NSURLSessionDownloadTask *)downloadTask
         didWriteData:(int64_t)bytesWritten
    totalBytesWritten:(int64_t)totalBytesWritten
    totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
    {
      NSLog(@"%f / %f", (double)totalBytesWritten,
    (double)totalBytesExpectedToWrite);
    }  
    

    NSURLSessionTask

    上面看了NSURLSessionDataTaskNSURLSessionDownloadTask的使用。这两个都是继承至NSURLSessionTask

    NSURLSessionTask是session中task的基类,它们只能由session或session的子类创建。

    NSURLSessionDataTask

    这个task调用HTTP GET请求从服务器获取数据。返回的数据格式是NSData。可能需要你自己转换成XML,JSON,UIimage等..

    NSURLSessionDataTask *jsonData = [session dataTaskWithURL:yourNSURL
      completionHandler:^(NSData *data,
                          NSURLResponse *response,
                          NSError *error) {
        // handle NSData
    }];  
    

    NSURLSessionUploadTask

    这个类是上传用的,在数据传输过程中,这个代理方法能观察网络状况。
    上传一张图片:

    NSData *imageData = UIImageJPEGRepresentation(image, 0.6);
    
    NSURLSessionUploadTask *uploadTask = [upLoadSession uploadTaskWithRequest:request fromData:imageData];
    

    这个task由session创建,上传图片的NSData。其他上传方法还有上传文件,或是数据流。

    NSURLSessionDownloadTask

    NSURLSessionDownloadTask下载文件更简单,可以在下载中挂起,恢复。它有一点点不同于其他两个子类。

    1. task的类型直接写到一个临时文件中。
    2. 下载过程中会调用URLSession:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite: 去更新状态。
    3. 当task完成,URLSession:downloadTask:didFinishDownloadingToURL:会被调用。此时你可以将临时文件保存到永久文件中。
    4. 下载失败或是取消还可以得到已经下载的那一部分数据。

    使用这个挂起task:

    //[uploadTask resume];  
    [uploadTask suspend];  
    

    同时管理多个task时,可以用taskIdentifier属性来唯一标识task。

    well,现在了解了NSURLSession类套中主要的类。

    后面还有一部分,还是与Dropbox有关的,就不再翻译了。

    转载请注明出处。

    相关文章

      网友评论

      本文标题:NSURLSession 教程

      本文链接:https://www.haomeiwen.com/subject/awyztttx.html