NSURLSession的简单使用步骤
通常使用NSURLSessionTask的子类来创建任务
NSURLSession对象的获取方法
获取全局的NSURLSession对象( 无法设置代理
)
+ (NSURLSession *)sharedSession
通过NSURLSessionConfiguration获取( 可以设置代理
),NSURLSessionConfiguration类通常用来设置一些请求参数
+ (NSURLSession *)sessionWithConfiguration:(NSURLSessionConfiguration *)configuration delegate:(nullable id <NSURLSessionDelegate>)delegate delegateQueue:(nullable NSOperationQueue *)queue
常用的属性
常用的方法(任务的状态控制)
任务优先级属性priority的取值
NSURLSessionTask
NSURLSessionDownloadTask,提供了一个取消任务的方法,但是会保存用于以后继续任务的信息,方法如下:
- (void)cancelByProducingResumeData:(void (^)(NSData * __nullable resumeData))completionHandler;
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:下载的文件保存的临时位置 * 需要将下载的文件保存在可以长期保存的位置 */
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];
实现代理方法做进一步处理