简介
- NSURLSession也能完成网络请求
- NSURLConnection在iOS9中不推荐使用,NSURLSession是iOS9中推荐使用的网络请求方式
- NSURLSession需要与NSURLSessionTask配合使用
-
NSURLSession的简单使用步骤
- 创建请求任务
- 执行请求任务
通常使用NSURLSessionTask的子类来创建任务
NSURLSession
-
NSURLSession对象的获取方法
-
获取全局的NSURLSession对象(
无法设置代理
)+ (NSURLSession *)sharedSession
-
通过NSURLSessionConfiguration获取(
可以设置代理
),NSURLSessionConfiguration类通常用来设置一些请求参数+ (NSURLSession *)sessionWithConfiguration:(NSURLSessionConfiguration *)configuration delegate:(nullable id <NSURLSessionDelegate>)delegate delegateQueue:(nullable NSOperationQueue *)queue
-
NSURLSessionTask
-
常用的属性
- taskIdentifier(NSUInteger, readonly),任务标识,唯一确定一个任务
- originalRequest(NSURLRequest *, readonly),上一个请求对象
- currentRequest(NSURLRequest *, readonly),当前请求对象
- response(NSURLResponse *, readonly),服务器的响应数据
- countOfBytesReceived(int64_t, readonly),已经接收到的数据量
- countOfBytesExpectedToReceive(int64_t, readonly),所要接收到的总数据量
- countOfBytesSent(int64_t, readonly),已经发送的数据量
- countOfBytesExpectedToSend(int64_t, readonly),所要发送的总数据量
- taskDescription(NSString *),任务描述
- state(NSURLSessionTaskState, readonly),任务的状态
- error(NSError *, readonly),错误信息
- priority(float),任务的优先级
-
常用的方法(任务的状态控制)
- - (void)cancel,取消任务
- - (void)suspend,暂停任务
- - (void)resume,继续任务
-
任务优先级属性priority的取值
- NSURLSessionTaskPriorityDefault
- NSURLSessionTaskPriorityLow
- NSURLSessionTaskPriorityHigh
-
NSURLSessionTask
- NSURLSessionDataTask,该子类没有扩充属性和方法,只是为了与NSURLSessionUploadTask和NSURLSessionDownloadTask区分
- NSURLSessionUploadTask,用于上传任务
-
NSURLSessionDownloadTask,提供了一个取消任务的方法,但是会保存用于以后继续任务的信息,方法如下:
- (void)cancelByProducingResumeData:(void (^)(NSData * __nullable resumeData))completionHandler;
与NSURLSession相关的代理协议
- NSURLSessionDelegate
- NSURLSessionTaskDelegate,遵守NSURLSessionDelegate协议
-
NSURLSessionDataDelegate,遵守NSURLSessionTaskDelegate协议,
是网络请求通常遵循的协议
,常用的方法:-
接受到服务响应时调用的方法
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition disposition))completionHandler;
/**
* 必须在该方法中对服务器的响应进行授权,才能继续接收服务器返回的数据,调用如下函数
* completionHandler(NSURLSessionResponseAllow)
*/ -
接收到服务器返回的数据时调用的方法
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data
/**
* data:服务返回的数据,通常为JSON格式数据
*/ -
请求完成时调用的方法(成功或失败)
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(nullable NSError *)error
/**
* 若出现错误,error中存放错误信息
*/
-
-
NSURLSessionDownloadDelegate(
通常用于下载大量数据
),遵守NSURLSessionTaskDelegate协议,常用的方法:-
写入数据到临时文件时调用的方法(服务器返回一点就写入一点)
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
/**
* totalBytesWritten,已写入数据的总长度
* totalBytesExpectedToWrite:总共要写入数据的总长度
* 可以在该方法中计算下载进度
*/ -
遇到错误的时候调用
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error
/**
*error:若遇到错误,则保存错误信息
*/ -
用于断点下载的方法
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didResumeAtOffset:(int64_t)fileOffset expectedTotalBytes:(int64_t)expectedTotalBytes
/**
* fileOffset:继续下载时,文件的开始位置
* expectedTotalBytes:剩余的数据总数
*/ -
下载完成时调用的方法
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location
/**
* location:下载的文件保存的临时位置
* 需要将下载的文件保存在可以长期保存的位置
*/
-
NSURLSession网络请求
-
Block回调的方式
-
获取NSURLSession对象
NSURLSession *session =[NSURLSession sharedSession];
-
创建请求任务
NSURLSessionTask *task = [session downloadTaskWithURL:(此处为请求的URL路径) completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) {
//此处为请求任务完成后的回调Block,即:任务完成后会执行这里的代码
}]; -
启动任务
[task resume];
-
-
代理的方式
-
获得NSURLSession对象
NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[[NSOperationQueue alloc] init]];
-
创建请求任务
NSURLSessionTask *task = [session dataTaskWithRequest:(此处为NSURLRequest对象)];
-
启动任务
[task resume];
实现代理方法做进一步处理
-