iOS NSURLConnection的简单使用

因为最近在做项目的过程中牵扯到一些离线断点下载的需求，用到了NSURLConnection和NSRULSession这两个对象，而平时工作大多数的时间都是和AFNetworking打交道，所以对这两个对象用起来不是那么的熟练，所以想借着今天整理一下，以备以后查看

我们都知道在iOS7后，NSURLSession对象基本代替了NSURLConnection进行网络开发，在iOS9后，NSURLConnection相关方法被完全的弃用，iOS系统有向下兼容的特性，尽管NSURLConnection已经被弃用，但在开发中，其方法依然可以被使用，并且如果需要兼容到很低版本的iOS系统，有时就必须使用NSURLConnection类了。

网络请求分为同步和异步两种，同步是指在请求结果返回之前，程序代码会卡在请求处，之后的代码不会被执行，异步是指在发送请求之后，一边在子线程中接收返回数据，一边执行之后的代码，当返回数据接收完毕后，采用回调的方式通知主线程做处理。

使用NSURLConnection进行同步Get请求

// 1.确定请求路径
NSURL *url = [NSURL URLWithString:@"http://xxxx.htm?username=gzp&pwd=123&type=JSON"];
    
// 2.创建请求对象,请求方法--->默认为GET
NSURLRequest *request = [[NSURLRequest alloc] initWithURL:url];

// 3.发送请求 真实类型:NSHTTPURLResponse
NSHTTPURLResponse *response = nil;
/*
  第一个参数:请求对象
  第二个参数:响应头信息
  第三个参数:错误信息
  返回值:响应体,只有
*/
// 该方法是阻塞的,即如果该方法没有执行完则后面的代码将得不到执行
NSData *data = [NSURLConnection sendSynchronousRequest:request returningResponse:&response error:nil];
    
// 4.解析响应数据 data--->字符串
NSLog(@"%@",[[NSString alloc]initWithData:data encoding:NSUTF8StringEncoding]);

使用NSURLConnection进行异步Post请求

使用同步的方式进行请求有一个很大的弊端，就是在进行网络请求的时候，数据的返回往往需要一定时间，不可能瞬间完成，使用同步的方式将导致界面卡死，这样的话 用户体验非常的不好.
NSURLConnection类提供两种方式进行异步请求操作。

使用block的方式进行异步请求

// 1.确定请求路径
NSURL *url = [NSURL URLWithString:@"http://xxx.htm"];

// 2.创建可变请求对象
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
    
// 3.修改请求方法,POST必须大写
request.HTTPMethod = @"POST";

// request.HTTPMethod = @"HEAD";只请求页面的首部。

// 可以设置请求头的一些属性,比如请求超时时间
request.timeoutInterval = 10;

// 设置请求头User-Agent  注意:key一定要一致(用于传递数据给后台)
[request setValue:@"ios 10.1" forHTTPHeaderField:@"User-Agent"];
    
// 可用于断点续传
// [request setValue:[NSString stringWithFormat:@"bytes=%zd-", self.currentSize] forHTTPHeaderField:@"Range"];

// 4.设置请求体信息,字符串--->NSData
request.HTTPBody = [@"username=gzp&pwd=123&type=JSON" dataUsingEncoding:NSUTF8StringEncoding];

// 3.发送异步请求
/*
  第一个参数:请求对象
  第二个参数:队列 决定代码块completionHandler的调用线程
  第三个参数:completionHandler 当请求完成(成功|失败)的时候回调
    response:响应头
    data:响应体
    connectionError:错误信息
*/
[NSURLConnection sendAsynchronousRequest:request queue:[NSOperationQueue mainQueue] completionHandler:^(NSURLResponse * _Nullable response, NSData * _Nullable data, NSError * _Nullable connectionError) {

    // 6.解析数据,NSData --->NSString  但是只有这个响应结束之后才能拿到这个数据
    NSLog(@"%@",[[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);
    }];

这种方式较下面的代理方式更为简单,但是block方式监听不了响应的进度.

使用代理回调的异步请求方式

首先需要遵守协议与声明一个可变的NSData用于接收数据：

@interface ViewController () <NSURLConnectionDataDelegate>
{
    NSMutableData * _data;
}
@end

发送请求

// 1.确定请求路径
NSURL *url = [NSURL URLWithString:@"http://xxx?username=123&pwd=123&type=JSON"];
    
// 2.创建请求对象
NSURLRequest *request = [NSURLRequest requestWithURL:url];

// 3.设置代理,发送请求
// [NSURLConnection connectionWithRequest:request delegate:self];

[[NSURLConnection alloc] initWithRequest:request delegate:self];

回调方法

#pragma mark ----------------------
#pragma mark NSURLConnectionDataDelegate
//1.当接收到服务器响应的时候调用
- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response
{
    NSLog(@"%s", __func__);
}

//2.接收到服务器返回数据的时候调用,调用多次
- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data
{
     NSLog(@"%s", __func__);
    
    //拼接数据(如果返回的数据较大,这种方式会导致内存飙升)
    [self.resultData appendData:data];
}
//3.当请求失败的时候调用
- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error
{
     NSLog(@"%s", __func__);
}

//4.请求结束的时候调用
- (void)connectionDidFinishLoading:(NSURLConnection *)connection
{
    NSLog(@"%s", __func__);
    
    NSLog(@"%@", [[NSString alloc] initWithData:self.resultData encoding:NSUTF8StringEncoding]);
}

在didReceiveData:方法中，拼接接收到的所有数据，等所有数据都拿到后，在connectionDidFinishLoading:方法中进行解析处理. 另外在做网络开发的时候，一定要考虑到网络延迟情况的处理，可以通过设置请求超时时间来处理

NSMutableURLRequest请求对象

NSMutableURLRequest是NSURLRequest的子类，常用的方法有

设置请求超时等待时间,在指定的时间内，如果没有得到服务器的响应，则认为请求是失败的 默认是60s 但是建议在15~30s之间

- (void)setTimeoutInterval:(NSTimeInterval)seconds;

cachePolicy 缓存策略
NSURLRequestUseProtocolCachePolicy = 0，默认的策略
NSURLRequestReloadIgnoringLocalCacheData = 1，每次从服务器加载，忽略本地缓存。一般使用在实时性要求很高的应用，股票/12306等。

下面两个一般使用在开发离线版应用。 离线版应用一般需要两个数据库，一个是本地数据库Sqlite3，一个服务器数据库。
NSURLRequestReturnCacheDataElseLoad = 2，有缓存，就返回缓存数据，没有就从服务器加载。
NSURLRequestReturnCacheDataDontLoad = 3，有缓存，就返回缓存数据，没有就不加载

设置请求方法（比如GET、POST或者Head）

- (void)setHTTPMethod:(NSString *)method;

设置请求体

- (void)setHTTPBody:(NSData *)data;

设置请求头

- (void)setValue:(NSString *)value forHTTPHeaderField:(NSString *)field;

NSHTTPURLResponse响应对象

statusCode：状态码，可以根据这个值判断是否请求出错。
allHeaderFields：获得响应体内容
URL： 一般使用在重定向,如果不需要重定向,响应的url和请求的url是一样的。
MIMEType：服务器告诉客户端返回的数据类型
textEncodingName：服务器告诉客户端返回内容的编码格式
expectedContentLength：服务器返回数据的长度，客户端可以通过该属性获得文件大小
suggestedFilename：服务器建议客户端保存文件使用的名字

好了，说了这么多最后贴一段离线断点下载的代码：

@interface ViewController () <NSURLConnectionDataDelegate>
@property(weak, nonatomic) IBOutlet UIProgressView *progressView;

@property(nonatomic, assign) NSInteger totalSize;//文件总大小

@property(nonatomic, assign) NSInteger currentSize;//已经下载大小

@property(nonatomic, strong) NSString *fullPath;/** 沙盒路径 */

@property(nonatomic, strong) NSURLConnection *connect;/** 连接对象 */

@property(nonatomic, strong) NSOutputStream *stream;/** 输出流*/
@end

@implementation ViewController

/**开始下载*/
- (IBAction)startBtnClick:(id)sender {
    [self download];
}
/**取消下载*/
- (IBAction)cancelBtnClick:(id)sender {
    [self.connect cancel];
}
/**继续下载*/
- (IBAction)goOnBtnClick:(id)sender {
    [self download];
}


- (void)download
{
    NSURL *url = [NSURL URLWithString:@"http://www.33lc.com/article/UploadPic/2012-10/2012102514201759594.jpg"];
    
    //2.创建请求对象
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
    
    //设置请求头信息,离线断点续传。
    NSString *range = [NSString stringWithFormat:@"bytes=%zd-",self.currentSize];
    [request setValue:range forHTTPHeaderField:@"Range"];
    
    //3.发送请求
    NSURLConnection *connect = [[NSURLConnection alloc] initWithRequest:request delegate:self];
    self.connect = connect;
}

#pragma mark ----------------------
#pragma mark NSURLConnectionDataDelegate
-(void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response
{
    //1.得到文件的总大小(本次请求的文件数据的总大小 != 文件的总大小)
    // self.totalSize = response.expectedContentLength + self.currentSize;
    
    if (self.currentSize > 0) {
        return;
    }
    
    self.totalSize = response.expectedContentLength;
    
    //2.写数据到沙盒中
    self.fullPath = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject]stringByAppendingPathComponent:@"123.jpg"];
    
    //3.创建输出流
    /*
     第一个参数:文件的路径
     第二个参数:YES 追加
     特点:如果该输出流指向的地址没有文件,那么会自动创建一个空的文件
     */
    NSOutputStream *stream = [[NSOutputStream alloc] initToFileAtPath:self.fullPath append:YES];
    
    //打开输出流
    [stream open];
    self.stream = stream;
}

- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data
{
    //向输出流中写入数据
    [self.stream write:data.bytes maxLength:data.length];
    
    //3.累计已经下载的数据；
    self.currentSize += data.length;
    
    //进度=已经下载/文件的总大小
    self.progressView.progress = 1.0 *  self.currentSize/self.totalSize;
}
- (void)connectionDidFinishLoading:(NSURLConnection *)connection
{
    
    //下载完毕关闭输出流
    [self.stream close];
    self.stream = nil;
    NSLog(@"%@",self.fullPath);
}
- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error
{
}

在进行一些大文件的下载的时候，为了避免内存飙升，我们常常采用
NSOutputStream输出流或者是NSFileHandler文件句柄的方式来进行下载，上面的代码我们就是使用了输出流的方式。一定要记住在下载之前将输出流打开，在下载完成之后将输出流关闭。

补充

HTTP协议的请求方法：
HTTP请求方法并不是只有GET和POST请求，只是这两种请求较为常用而已。在HTTP/1.1协议中，定义了8种发送HTTP请求的方法OPTIONS、GET、HEAD、POST、PUT、DELETE、TRACE和CONNECT。

那么这里我们重点说一些HEAD请求
HEAD和GET本质是一样的，区别在于HEAD不含有呈现数据，而仅仅是HTTP头信息。经常用来测试超链接的有效性、可用性和最近的修改。