NSURLConnection基本用法介绍

NSURLConnection基本用法介绍

NSURLConnection 作为苹果网络基础架构，已经服务了成千上万的 iOS 和 Mac OS 程序，并且做的还算相当不错。NSURLConnection 这个名字，实际上是指代的 Foundation 框架的 URL 加载系统中一系列有关联的组件：NSURLRequest、NSURLResponse、NSURLProtocol、 NSURLCache、 NSHTTPCookieStorage、NSURLCredentialStorage 以及同名类 NSURLConnection。

NSURLConnection常用的类

1、NSURL：根据url生成的请求地址
2、NSURLRequest：封装的一个请求，携带发送给服务器的全部数据，里面包含一个NSURL对象，请求方法，请求头，请求体等等。。
3、NSMutableURLRequest：这个是NSURLRequest的子类，通过名字我们可以看出这是一个可变的对象，我们可以在这里自定义设置发送的服务器的全部数据（超市等待时间、请求方法、请求体、请求头）
4、NSURLResponse：服务的响应类，和NSURLRequest对象，包含服务返回的响应头部数据
5、NSURLConnection：负责发送请求，建立客户端和服务器的连接。发送NSURLRequest的数据给服务器，并收集来自服务器的响应头部数据NSURLResponse或者NSData

NSURLConnection使用步骤

1、根据url创建一个NSURL对象
2、根据创建的NSURL创建一个NSURLRequest对象，创建请求对象（此对象内容全部都是默认值，如：请求方法默认是GET），如果想要自定数据则创建NSMutableURLRequest对象
3、最后使用NSURLConnection发送创建好的NSURLRequest或者NSMutableURLRequest对象，与服务器建立链接


下面就结合代码来看一下NSURLConnection的具体使用，NSURLConnection提供了两种形式的使用，代理模式和非代理模式

非代理模式

非代理模式中有提供了两个方法同步请求和异步请求(block实现)

    //设置访问的url地址
    self.imageUrl = @"http://7xt5rm.com2.z0.glb.clouddn.com/picjumbo.com_download.jpg";
    //根据url生成的NSURL请求地址
    NSURL *URL = [NSURL URLWithString:self.imageUrl];
    //创建请求对象
    self.request = [NSMutableURLRequest requestWithURL:URL];
    
    //发送同步请求 同步请求在主线程中执行 会一直在等待服务器返回数据，会阻塞主线程的执行，如果服务器没有返回数据，那么在主线程UI会卡住不能继续执行操作
    //不建议这么做
    NSData *data=[NSURLConnection sendSynchronousRequest:request returningResponse:nil error:nil];
    NSLog(@"data length = %lu",(unsigned long)data.length);
    
    ------------------------------------------------------------------
    
    //发送异步请求 
    //异步请求需要一个队列来负责回调代码块的执行，当获取到返回数据是，会在这个线程队列中执行代码块，这里我们使用主队列，
    NSOperationQueue *queue=[NSOperationQueue mainQueue];
    //异步请求传入一个^(NSURLResponse *response,NSData *data, NSError *connectionError)block代码块，当请求数据返回时，执行此代码块，此代码块有三个参数，respons响应头 data返回数据 connectionError错误代码
    [NSURLConnection sendAsynchronousRequest:self.request queue:queue completionHandler:^(NSURLResponse *response,NSData *data, NSError *connectionError){
       NSLog(@"response = %@",response);
       NSLog(@"data = %@",data);
       NSLog(@"error = %@",connectionError);
    }];

从上面的代码中我们可以看到：如果使用同步请求，则会阻塞主线程的执行，这么做太不理智了，如果使用异步请求，虽说可以达到不影响主线程的目的，但是我们无法监控数据下载的状态（同步请求也不能），自由度不大。
所以经常使用的还是代理模式

代理模式

使用代理模式需要实现NSURLConnectionDataDelegate协议，此协议提供了几个代理方法，涵盖了请求交互的几个步骤

//当接收到服务器响应时调用，response为响应头部
- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response;

//接收到服务返回的数据时调用，多次调用，直至接受到全部数据，每次接受一部分数据，放入到data中
- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data;

//数据接收完成是调用
- (void)connectionDidFinishLoading:(NSURLConnection *)connection;

//监控上传数据的进度，再上传数据时调用
- (void)connection:(NSURLConnection *)connection   didSendBodyData:(NSInteger)bytesWritten
                                                 totalBytesWritten:(NSInteger)totalBytesWritten
                                         totalBytesExpectedToWrite:(NSInteger)totalBytesExpectedToWrite;

//请求错误（失败）的时候调用
- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error;

看代码

//设置访问的url地址
    self.imageUrl = @"http://7xt5rm.com2.z0.glb.clouddn.com/picjumbo.com_download.jpg";
    //根据url生成的NSURL请求地址
    NSURL *URL = [NSURL URLWithString:self.imageUrl];
    //创建请求对象
    self.request = [NSMutableURLRequest requestWithURL:URL];
    
    //发送同步请求 同步请求在主线程中执行 会一直在等待服务器返回数据，会阻塞主线程的执行，如果服务器没有返回数据，那么在主线程UI会卡住不能继续执行操作
    //不建议这么做
    //NSData *data=[NSURLConnection sendSynchronousRequest:request returningResponse:nil error:nil];
    //NSLog(@"data length = %lu",(unsigned long)data.length);
    
    ------------------------------------------------------------------
    
    //发送异步请求 
    //异步请求需要一个队列来负责回调代码块的执行，当获取到返回数据是，会在这个线程队列中执行代码块，这里我们使用主队列，
    //NSOperationQueue *queue=[NSOperationQueue mainQueue];
    //异步请求传入一个^(NSURLResponse *response,NSData *data, NSError *connectionError)block代码块，当请求数据返回时，执行此代码块，此代码块有三个参数，respons响应头 data返回数据 connectionError错误代码
    //[NSURLConnection sendAsynchronousRequest:self.request queue:queue completionHandler:^(NSURLResponse *response,NSData *data, NSError *connectionError){
       NSLog(@"response = %@",response);
       NSLog(@"data = %@",data);
       NSLog(@"error = %@",connectionError);
    }];
    
    -------------------------------------------------------------------
    //创建连接，指定代理对象
    //创建连接有三个方法需要了解一下
    //- (nullable instancetype)initWithRequest:(NSURLRequest *)request delegate:(nullable id)delegate startImmediately:(BOOL)startImmediately  startImmediately决定是否立即下载数据，YES是立即下载，并把connection加入到当前的runloop中，不需要手动调用[connection start]
    //- (nullable instancetype)initWithRequest:(NSURLRequest *)request delegate:(nullable id)delegate 实质为调用用的[self initWithRequest:request delegate:delegate startImmediately:YES];
    //+ (NSURLConnection*)connectionWithRequest:(NSURLRequest *)request delegate:(id)delegate;类方法，不需要手动调用[connection start]
    
    self.connection = [NSURLConnection connectionWithRequest:self.request delegate:self];
    
    //代理方法
    #pragma mark - NSURLConnectionDataDelegate

    - (NSURLRequest *)connection:(NSURLConnection *)connection willSendRequest:(NSURLRequest *)request redirectResponse:    (NSURLResponse *)response{
        NSLog(@"将要发送请求！");
        NSLog(@"request = %@",request);
         NSLog(@"response = %@",response);
        return request;
    }
    - (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response{
         NSLog(@"接收到服务器的响应!");
         NSLog(@"response = %@",response);
    }

    - (void)connection:(NSURLConnection *)connection didReceiveData:(nonnull NSData *)data{
        NSLog(@"接受数据中。。。。。%lu",(unsigned long)data.length);
        //要把每一次接收到的数据拼接起来
        [self.imageData appendData:data];
    }

    - (void)connectionDidFinishLoading:(NSURLConnection *)connection{
        NSLog(@"数据接受完毕！");
        NSLog(@"image 大小 = %lu",(unsigned long)self.imageData.length);
        self.imageView.image = [UIImage imageWithData:self.imageData];
    }

    - (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error{
        NSLog(@"连接失败。。。%@",error);
    }

代码注释已经很详细了，每个代理方法都对应网络连接时的不同状态，我们可以在响应的状态中进行自己所需的操作。。

补充 断点下载

有时候数据文件比较大，我们一次不一定能够全部下载，如果之前下载了一部分，之后我们又要下载的话，在重头开始有点不太合适，这时候我们应该如何做呢。。
现在的下载一般是用http协议，http协议的头部有个字段Range，可以满足我们的需求。
Range用于请求头中，指定第一个字节的位置和最后一个字节的位置，一般格式：
Range:(unit=first byte pos)-[last byte pos]
当我们暂停下载的时候我们可以在代理方法- (void)connection:(NSURLConnection *)connection didReceiveData:(nonnull NSData *)data中记录已下载数据的大小

- (void)connection:(NSURLConnection *)connection didReceiveData:(nonnull NSData *)data{
        NSLog(@"接受数据中。。。。。%lu",(unsigned long)data.length);
        //要把每一次接收到的数据拼接起来
        [self.imageData appendData:data];
        //记录已下载数据的大小
        range = range + data.length;
    }

然后在再次下载的时候设置HTTP的Range头部,注意此时request需要是NSMutableURLRequest对象

      //设置请求数据范围
    NSString *rangeValue = [NSString stringWithFormat:@"bytes=%llu-", range];
    [self.request setValue:rangeValue forHTTPHeaderField:@"Range"];
    [self.request setCachePolicy:NSURLRequestReloadIgnoringLocalCacheData];
    self.connection = [NSURLConnection connectionWithRequest:self.request delegate:self];

关于NSURLConnection的使用到这里也就结束，这里只是简单的介绍了NSURLConnection的使用，其实NSURLConnection的使用还有许多的使用细节，更深入的研究可以参考相应的文档，这里只是抛砖引玉，还请大家多多指教。。
其实，在 2013的WWDC上，苹果推出了NSURLConnection的继任者：NSURLSession，大有取代NSURLConnection之势，我们可以直接研究NSURLSession。。