NSURLSession学习笔记(二)Session Task

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:方法创建。代码如下:

/* 使用NSURLSessionDataTask加载网页数据 */
- (IBAction)loadData:(id)sender {
    // 开始加载数据,让spinner转起来
    [self.spinner startAnimating];
    
    // 创建Data Task,用于打开我的csdn blog主页
    NSURL *url = [NSURL URLWithString:@"http://blog.csdn.net/u010962810"];
    NSURLRequest *request = [NSURLRequest requestWithURL:url];
    NSURLSession *session = [NSURLSession sharedSession];
    NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
                                                completionHandler:
                                      ^(NSData *data, NSURLResponse *response, NSError *error) {
                                          // 输出返回的状态码,请求成功的话为200
                                          [self showResponseCode:response];
                                          
                                          // 在webView中加载数据
                                          [self.webView loadData:data
                                                        MIMEType:@"text/html"
                                                textEncodingName:@"utf-8"
                                                         baseURL:nil];
                                          
                                          // 加载数据完毕,停止spinner
                                          [self.spinner stopAnimating];
                                      }];
    // 使用resume方法启动任务
    [dataTask resume];
}

/* 输出http响应的状态码 */
- (void)showResponseCode:(NSURLResponse *)response {
    NSHTTPURLResponse* httpResponse = (NSHTTPURLResponse*)response;
    NSInteger responseStatusCode = [httpResponse statusCode];
    NSLog(@"%d", responseStatusCode);
}

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

运行结果:

NSURLSession学习笔记(二)Session Task


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

/* 使用NSURLSessionUploadTask上传文件 */
- (IBAction)uploadFile:(id)sender {
//    NSURL *URL = [NSURL URLWithString:@"http://example.com/upload"];
//    NSURLRequest *request = [NSURLRequest requestWithURL:URL];
//    NSData *data = ...;
//    
//    NSURLSession *session = [NSURLSession sharedSession];
//    NSURLSessionUploadTask *uploadTask = [session uploadTaskWithRequest:request
//                                                               fromData:data
//                                                      completionHandler:
//                                          ^(NSData *data, NSURLResponse *response, NSError *error) {
//                                              // ...
//                                          }];
//    
//    [uploadTask resume];
}


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

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

/* 使用NSURLSessionDownloadTask下载文件 */
- (IBAction)downloadFile:(id)sender {
    [self.spinner startAnimating];
    
    NSURL *URL = [NSURL URLWithString:@"http://b.hiphotos.baidu.com/image/w%3D2048/sign=6be5fc5f718da9774e2f812b8469f919/8b13632762d0f703b0faaab00afa513d2697c515.jpg"];
    NSURLRequest *request = [NSURLRequest requestWithURL:URL];
    NSURLSession *session = [NSURLSession sharedSession];
    NSURLSessionDownloadTask *downloadTask = [session downloadTaskWithRequest:request
                                                            completionHandler:
                                              ^(NSURL *location, NSURLResponse *response, NSError *error) {
                                                  [self showResponseCode:response];
                                                  
                                                  // 输出下载文件原来的存放目录
                                                  NSLog(@"%@", location);
                                                  
                                                  // 设置文件的存放目标路径
                                                  NSString *documentsPath = [self getDocumentsPath];
                                                  NSURL *documentsDirectoryURL = [NSURL fileURLWithPath:documentsPath];
                                                  NSURL *fileURL = [documentsDirectoryURL URLByAppendingPathComponent:[[response URL] lastPathComponent]];
                                                  
                                                  // 如果该路径下文件已经存在,就要先将其移除,在移动文件
                                                  NSFileManager *fileManager = [NSFileManager defaultManager];
                                                  if ([fileManager fileExistsAtPath:[fileURL path] isDirectory:NULL]) {
                                                      [fileManager removeItemAtURL:fileURL error:NULL];
                                                  }
                                                  [fileManager moveItemAtURL:location toURL:fileURL error:NULL];
                                                  
                                                  // 在webView中加载图片文件
                                                  NSURLRequest *showImage_request = [NSURLRequest requestWithURL:fileURL];
                                                  [self.webView loadRequest:showImage_request];
                                                  
                                                  [self.spinner stopAnimating];
                                              }];
    
    [downloadTask resume];
}

/* 获取Documents文件夹的路径 */
- (NSString *)getDocumentsPath {
    NSArray *documents = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    NSString *documentsPath = documents[0];
    return documentsPath;
}

运行结果:

NSURLSession学习笔记(二)Session Task



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




NSURLSession学习笔记(二)Session Task

上一篇:LeetCode | Max Points on a Line


下一篇:LA 3704 Cellular Automaton / 矩阵快速幂