NSURLSession 简介
The NSURLSession class and related classes provide an API for downloading content via HTTP. This API provides a rich set of
delegate methods for supporting authentication and gives your app the ability to perform background downloads
when your app is not running or, in iOS, while your app is suspended.
NSURLSession类和相关类提供一个API通过HTTP下载内容。这个API提供了一组丰富的委托方法支持
身份验证和给你的应用能力来执行后台下载,当应用程序不运行时,或者在iOS应用程序被挂起;
如何创建NSURLSession
/*
* The shared session uses the currently set global NSURLCache,
* NSHTTPCookieStorage and NSURLCredentialStorage objects.
*第一种方式是使用静态的sharedSession方法,该类使用共享的会话,该会话使用全局的Cache,Cookie和证书。
*/
+ (NSURLSession *)sharedSession;
/*
* Customization of NSURLSession occurs during creation of a new session.
* If you only need to use the convenience routines with custom
* configuration options it is not necessary to specify a delegate.
* If you do specify a delegate, the delegate will be retained until after
* the delegate has been sent the URLSession:didBecomeInvalidWithError: message.
*第二种方式是通过sessionWithConfiguration:方法创建对象,也就是创
建对应配置的会话,与NSURLSessionConfiguration合作使用。
*/
+ (NSURLSession *)sessionWithConfiguration:(NSURLSessionConfiguration *)configuration;
/*
* 第三种方式是通过sessionWithConfiguration:delegate:delegateQueue方法创建对象,二三两种方式可以创建一个新会话并定制其会话类型。该方式中指定了session的委托和委托所处的队列。当不再需要连接时,可以调用Session的invalidateAndCancel直接关闭,或者调用finishTasksAndInvalidate等待当前Task结束后关闭。这时Delegate会收到
URLSession:didBecomeInvalidWithError:这个事件。Delegate收到这个事件之后会被解引用。
*/
+ (NSURLSession *)sessionWithConfiguration:(NSURLSessionConfiguration *)configuration delegate:(nullable id <NSURLSessionDelegate>)delegate delegateQueue:(nullable NSOperationQueue *)queue;
NSURLSessionConfiguration
用于配置会话的属性,可以通过该类配置会话的工作模式
- 有三种模式
+(NSURLSessionConfiguration *)defaultSessionConfiguration;
+(NSURLSessionConfiguration*)ephemeralSessionConfiguration;
+(NSURLSessionConfiguration*)backgroundSessionConfiguration:(NSString *)identifier;
- 几个重要属性
@property BOOL allowsCellularAccess:代表只允许蜂窝数据下访问
@property (getter=isDiscretionary) BOOL discretionary NS_AVAILABLE(NA, 7_0);
discretionary:是根据系统做性能优化,电量充足的时候使用wifi
NSURLSessionTask
NSURLSessionTask是一个抽象子类,它的子类:NSURLSessionDataTask,NSURLSessionUploadTask和NSURLSessionDownloadTask;iOS9+的版本新增NSURLSessionStreamTask;
NSURLSessionDataTask的使用
-(void)loadData{
NSURL* url = [NSURL URLWithString:@"http://www.jianshu.com"];
NSURLRequest* urlRquest = [NSURLRequest requestWithURL:url];
NSURLSession* urlSession = [NSURLSession sharedSession];
NSURLSessionDataTask* dataTask = [urlSession dataTaskWithRequest:urlRquest completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
NSHTTPURLResponse* httpResponse = (NSHTTPURLResponse*)response;
NSInteger responseStatusCode = [httpResponse statusCode];
if (responseStatusCode == 200) {
dispatch_async(dispatch_get_main_queue(), ^{
NSString* htmlStr = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
UIWebView* webView = [[UIWebView alloc] initWithFrame:self.view.frame];
[webView loadHTMLString:htmlStr baseURL:nil];
[self.view addSubview:webView];
});
}
}];
[dataTask resume];
}
NSURLSessionDelegate和NSURLSessionTaskDelegate协议
在协议的方法中可以完成各种各样的回调动作,如身份验证、完成任务后的动作、错误处理和后台任务完成的动作等。委托方法指定在NSURLSession中一定数量的字节传输使用int64_t类型的参数
-(void)URLSessionDidFinishEventsForBackgroundURLSession:(NSURLSession *)session NS_AVAILABLE_IOS(7_0);
-(void)application:(UIApplication *)application handleEventsForBackgroundURLSession:(NSString *)identifier completionHandler:(void (^)())completionHandler NS_AVAILABLE_IOS(7_0);
将任务切换到后台之后,Session的Delegate不会再收到和Task相关的消息。当所有Task全都完成后,程序将被唤醒,并调用ApplicationDelegate的application:handleEventsForBackgroundURLSession:completionHandler:回调,在这里要为后台session(由background session的identifier标识)指定对应的回调代码块 随后,对于每一个完成的后台Task调用该Session的Delegate中的URLSession:downloadTask:didFinishDownloadingToURL:(成功的话)和URLSession:task:didCompleteWithError:(成功或者失败都会调用)方法做处理,以上的回调代码块可以在这里调用
NSURLSessionDownloadTask的使用
NSURL* downLoadURL = [NSURL URLWithString:@"http://pic.4j4j.cn/upload/pic/20131213/0f37a308d8.jpg"];
NSURLRequest* request = [[NSURLRequest alloc] initWithURL:downLoadURL];
NSURLSession* session = [NSURLSession sharedSession];
NSURLSessionDownloadTask* downLoadTask = [session downloadTaskWithRequest:request completionHandler:^(NSURL * _Nullable location, NSURLResponse * _Nullable response, NSError * _Nullable error) {
dispatch_async(dispatch_get_main_queue(), ^{
NSData* data = [NSData dataWithContentsOfURL:location];
UIImage* image = [UIImage imageWithData:data];
self.downLoad_IMageView.image = image;
});
}];
[downLoadTask resume];
NSURLRequest
NSURLRequest及其分类和NSMutableURLRequest及其分类提供了相应的API供开发者配置HTTP请求;类似请求的缓存策略NSURLRequestCachePolicy
、请求超时时间timeoutInterval
、设置请求的Head filed、设置HTTPMethod(GET/POST)、使用POST请求时设置HTTPBody等
NSHTTPCookieStorage
对于移动端请求服务器的某些接口时需要验证这种请求,移动端可以使用NSHTTPCookieStorage来获取服务端响应的Cookie信息,NSHTTPCookieStorage他是一个单例对象,API中提供了处理Cookie的相关方法;
NSURLCache
关于网络请求缓存实现实现的必要性不言而喻,而实现方案也是千差万别;如果对于NSURLCache不了解的话你可能会走一些弯路;在NSHipster的NSURLCache这篇文章中详细的阐述了NSURLCache能提供的功能,在实际的开发中你只需要确认选取哪种NSURLRequestCachePolicy
即可;
NSURL
对于URL来说他定位了你所发起请求的地址,在实际的使用中尤其是GET请求时,要注意中文字符的编码,否则构建的请求会出现问题;更多的NSURL可以看看这边文章的介绍;
NSURLProtocol
对于NSURLProtocol平时接触的较少,但NSURLProtocol这篇文件还是给了一些使用建议;
苹果的URL Load System
附上苹果的URL Load System 介绍来加深网络请求的理解。