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
</br>
NSURLConnection使用步骤
1、根据url创建一个NSURL对象
2、根据创建的NSURL创建一个NSURLRequest对象,创建请求对象(此对象内容全部都是默认值,如:请求方法默认是GET),如果想要自定数据则创建NSMutableURLRequest对象
3、最后使用NSURLConnection发送创建好的NSURLRequest或者NSMutableURLRequest对象,与服务器建立链接
</br>
下面就结合代码来看一下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头部,注意此时<strong>request需要是NSMutableURLRequest对象</strong>
//设置请求数据范围
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];
</br>
关于NSURLConnection的使用到这里也就结束,这里只是简单的介绍了NSURLConnection的使用,其实NSURLConnection的使用还有许多的使用细节,更深入的研究可以参考相应的文档,这里只是抛砖引玉,还请大家多多指教。。
其实,在 2013的WWDC上,苹果推出了NSURLConnection的继任者:NSURLSession,大有取代NSURLConnection之势,我们可以直接研究NSURLSession。。