NSURLSession学习笔记（二）Session Task

时间：2024-01-08 22:05:14

Session Task分为三种Data Task，Upload Task，Download Task。毫无疑问，Session Task是整个NSURLSession架构的核心目标。

下面写了一个简单的Demo来初步使用下三种任务对象。这里使用的是convenience methods，并没有定制session和使用协议，都是采用completionHandler作为回调动作。

故事板内容为：

NSURLSession学习笔记（二）Session Task

第一种Data Task用于加载数据，使用全局的shared session和dataTaskWithRequest:completionHandler:方法创建。代码如下：

  1. /* 使用NSURLSessionDataTask加载网页数据 */
  2. - (IBAction)loadData:(id)sender {
  3. // 开始加载数据，让spinner转起来
  4. [self.spinner startAnimating];
  5. // 创建Data Task，用于打开我的csdn blog主页
  6. NSURL *url = [NSURL URLWithString:@"http://blog.csdn.net/u010962810"];
  7. NSURLRequest *request = [NSURLRequest requestWithURL:url];
  8. NSURLSession *session = [NSURLSession sharedSession];
  9. NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
  10. completionHandler:
  11. ^(NSData *data, NSURLResponse *response, NSError *error) {
  12. // 输出返回的状态码，请求成功的话为200
  13. [self showResponseCode:response];
  14. // 在webView中加载数据
  15. [self.webView loadData:data
  16. MIMEType:@"text/html"
  17. textEncodingName:@"utf-8"
  18. baseURL:nil];
  19. // 加载数据完毕，停止spinner
  20. [self.spinner stopAnimating];
  21. }];
  22. // 使用resume方法启动任务
  23. [dataTask resume];
  24. }
  25. /* 输出http响应的状态码 */
  26. - (void)showResponseCode:(NSURLResponse *)response {
  27. NSHTTPURLResponse* httpResponse = (NSHTTPURLResponse*)response;
  28. NSInteger responseStatusCode = [httpResponse statusCode];
  29. NSLog(@"%d", responseStatusCode);
  30. }

completionHandler指定任务完成后的动作。注意一定要使用resume方法启动任务。（Upload Task和Download Task同理）

运行结果：

NSURLSession学习笔记（二）Session Task

第二种Upload Task用于完成上传文件任务，使用方法类似：

  1. /* 使用NSURLSessionUploadTask上传文件 */
  2. - (IBAction)uploadFile:(id)sender {
  3. //    NSURL *URL = [NSURL URLWithString:@"http://example.com/upload"];
  4. //    NSURLRequest *request = [NSURLRequest requestWithURL:URL];
  5. //    NSData *data = ...;
  6. //
  7. //    NSURLSession *session = [NSURLSession sharedSession];
  8. //    NSURLSessionUploadTask *uploadTask = [session uploadTaskWithRequest:request
  9. //                                                               fromData:data
  10. //                                                      completionHandler:
  11. //                                          ^(NSData *data, NSURLResponse *response, NSError *error) {
  12. //                                              // ...
  13. //                                          }];
  14. //
  15. //    [uploadTask resume];
  16. }

第三种Download Task用于完成下载文件的任务，使用全局的shared session和downloadTaskWithRequest:completionHandler:方法创建。

注意：在下载任务完成后，下载的文件位于tmp目录下，由代码块中的location指定（不妨输出看看），我们必须要在completion handler中将文件放到持久化的目录下保存。代码如下：

  1. /* 使用NSURLSessionDownloadTask下载文件 */
  2. - (IBAction)downloadFile:(id)sender {
  3. [self.spinner startAnimating];
  4. NSURL *URL = [NSURL URLWithString:@"http://b.hiphotos.baidu.com/image/w%3D2048/sign=6be5fc5f718da9774e2f812b8469f919/8b13632762d0f703b0faaab00afa513d2697c515.jpg"];
  5. NSURLRequest *request = [NSURLRequest requestWithURL:URL];
  6. NSURLSession *session = [NSURLSession sharedSession];
  7. NSURLSessionDownloadTask *downloadTask = [session downloadTaskWithRequest:request
  8. completionHandler:
  9. ^(NSURL *location, NSURLResponse *response, NSError *error) {
  10. [self showResponseCode:response];
  11. // 输出下载文件原来的存放目录
  12. NSLog(@"%@", location);
  13. // 设置文件的存放目标路径
  14. NSString *documentsPath = [self getDocumentsPath];
  15. NSURL *documentsDirectoryURL = [NSURL fileURLWithPath:documentsPath];
  16. NSURL *fileURL = [documentsDirectoryURL URLByAppendingPathComponent:[[response URL] lastPathComponent]];
  17. // 如果该路径下文件已经存在，就要先将其移除，在移动文件
  18. NSFileManager *fileManager = [NSFileManager defaultManager];
  19. if ([fileManager fileExistsAtPath:[fileURL path] isDirectory:NULL]) {
  20. [fileManager removeItemAtURL:fileURL error:NULL];
  21. }
  22. [fileManager moveItemAtURL:location toURL:fileURL error:NULL];
  23. // 在webView中加载图片文件
  24. NSURLRequest *showImage_request = [NSURLRequest requestWithURL:fileURL];
  25. [self.webView loadRequest:showImage_request];
  26. [self.spinner stopAnimating];
  27. }];
  28. [downloadTask resume];
  29. }
  30. /* 获取Documents文件夹的路径 */
  31. - (NSString *)getDocumentsPath {
  32. NSArray *documents = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
  33. NSString *documentsPath = documents[0];
  34. return documentsPath;
  35. }

运行结果：

NSURLSession学习笔记（二）Session Task

这个Demo中没有为NSURLSession指定session的delegate，所以没有使用委托中的方法，功能比较有限，而且也没有自行定制session的配置，所以只能执行简单的任务，但是对于加载数据，下载一张图片等任务已经可以应付自如。对于创建后台下载任务，支持断点续传的下载任务等将在下一篇文章中分析介绍。

相关文章