NSURLSession类

NSURLSession

1. 在2013年, 苹果解开了NSURLSession的面纱, 作为NSURLConnection的继承者, 比较NSURLConnection, NSURLSession提供了配置会话缓存,协议,cookie和证书的能力, 这使得网络架构和应用程序可以独立工作, 互不干扰, 另外, NSURLSession另一个重要的部分是会话任务, 它负责加载数据, 在客户端和服务器端进行文件的上传下载.

2. NSURLSession

   • NSURLConnection主要任务:
     • 获取数据(JSON, XML),
     • 文件上传.
     • 文件下载.
   • NSURLSession中, 三个人物分别由以下的抽象类来完成.
     • NSURLSessionData
     • NSURLSessionUploadTask,
     • NSURLSessionDownloadTask,
       这三个类都是 NSURLSessionTask这个抽象类的子类, 相比直接使用NSURLConnection, NSURLSessionTask支持任务的暂停、取消和恢复，并且默认任务运行在其他非主线程中.

3. 数据请求

   NSURLSessionDataTask实现流程与NSURLConnection的静态方法类似, 代码如下:
    -(void)loadJsonData{
    
    1.创建url
    NSString *urlStr=[NSString stringWithFormat:@"http://192.168.1.208/ViewStatus.aspx?userName=%@&password=%@",@"KenshinCui",@"123"];
    urlStr =[urlStr stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
    NSURL *url=[NSURL URLWithString:urlStr];
    
    2.创建请求
    NSURLRequest *request=[NSURLRequest requestWithURL:url];
   
    3.创建会话（这里使用了一个全局会话）并且启动任务
    NSURLSession *session=[NSURLSession sharedSession];
    // 从会话创建任务
    NSURLSessionDataTask *dataTask=[session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
    if (!error) {
        NSString *dataStr=[[NSString alloc]initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@",dataStr);
    }else{
        NSLog(@"error is :%@",error.localizedDescription);
    }
    }]; 
    [dataTask resume];//恢复线程，启动任务
    }
   

4. 如何使用NSURLSessionUploadTask实现文件上传, 这里有几个方法

   #pragma mark 取得mime types
   -(NSString *)getMIMETypes:(NSString *)fileName{
   return @"image/jpg";
   }
   #pragma mark 取得数据体
   -(NSData *)getHttpBody:(NSString *)fileName{
   
   NSString *boundary=@"KenshinCui";
   
   NSMutableData *dataM=[NSMutableData data];
   
   NSString *strTop=[NSString stringWithFormat:@"--%@\nContent- Disposition: form-data; name=\"file1\"; filename=\"%@\"\nContent-Type: %@\n\n",boundary,fileName,[self getMIMETypes:fileName]];
      
   NSString *strBottom=[NSString stringWithFormat:@"\n--%@--",boundary];
   
   NSString *filePath=[[NSBundle mainBundle] pathForResource:fileName ofType:nil];
   
   NSData *fileData=[NSData dataWithContentsOfFile:filePath];
   
   [dataM appendData:[strTop dataUsingEncoding:NSUTF8StringEncoding]];
   
   [dataM appendData:fileData];
    [dataM appendData:[strBottom dataUsingEncoding:NSUTF8StringEncoding]];
    return dataM;
    }
   
   #pragma mark 上传文件
   -(void)uploadFile{
   NSString *fileName=@"pic.jpg";
   
   //1.创建url
   NSString *urlStr=@"http://192.168.1.208/FileUpload.aspx";
   
   urlStr =[urlStr stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
   
   NSURL *url=[NSURL URLWithString:urlStr];
   //2.创建请求
   
   NSMutableURLRequest *request=[NSMutableURLRequest requestWithURL:url];
   
   request.HTTPMethod=@"POST";
   
   //3.构建数据
    NSString *path=[[NSBundle mainBundle] pathForResource:fileName ofType:nil];
   NSData *data=[self getHttpBody:fileName];
   request.HTTPBody=data;
   
   [request setValue:[NSString stringWithFormat:@"%lu",(unsigned long)data.length] forHTTPHeaderField:@"Content-Length"];
   [request setValue:[NSString stringWithFormat:@"multipart/form-data; boundary=%@",@"KenshinCui"] forHTTPHeaderField:@"Content-Type"];
   //4.创建会话
   NSURLSession *session=[NSURLSession sharedSession];
   NSURLSessionUploadTask *uploadTask=[session uploadTaskWithRequest:request fromData:data completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
   if (!error) {
       NSString *dataStr=[[NSString alloc]initWithData:data encoding:NSUTF8StringEncoding];
       NSLog(@"%@",dataStr);
   }else{
       NSLog(@"error is :%@",error.localizedDescription);
   }
   }];
   
   [uploadTask resume];
   }
   

5. 文件下载
   使用NSURLSessionDownloadTask下载文件的过程与前面差不多, 需要注意的是文件下载文件之后会自动保存到一个临时目录. 需要开发人员自己讲文件重新放到其他指定的目录下.

    -(void)downloadFile{
    //1.创建url
    NSString *fileName=@"1.jpg";
    NSString *urlStr=[NSString stringWithFormat: @"http://192.168.1.208/FileDownload.aspx?file=%@",fileName];
    urlStr =[urlStr stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
    NSURL *url=[NSURL URLWithString:urlStr];
    //2.创建请求
        requestWithURL:url];
   
    //3.创建会话（这里使用了一个全局会话）并且启动任务
    NSURLSession *session=[NSURLSession sharedSession];
    NSURLSessionDownloadTask *downloadTask=[session downloadTaskWithRequest:request completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) {
    if (!error) {
        //注意location是下载后的临时保存路径,需要将它移动到需要保存的位置
        
        NSError *saveError;
        NSString *cachePath=[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject];
        NSString *savePath=[cachePath stringByAppendingPathComponent:fileName];
        NSLog(@"%@",savePath);
        NSURL *saveUrl=[NSURL fileURLWithPath:savePath];
        [[NSFileManager defaultManager] copyItemAtURL:location toURL:saveUrl error:&saveError];
        if (!saveError) {
            NSLog(@"save sucess.");
        }else{
            NSLog(@"error is :%@",saveError.localizedDescription);
        }
        
    }else{
        NSLog(@"error is :%@",error.localizedDescription);
    }
    }];
   
    [downloadTask resume];
    }
   

6. 会话,(session 翻译成会话不太好)
   NSURLConnection通过全局状态管理cookies, 认证信息等公共资源, 这样如果遇到两个链接需要使用不同的资源配置情况时,就无法解决了, 但是这个问题在NSURLSession中得到了结局. NSURLSession同事对应着多个链接, 会话通过工厂方法来创建, 同一个会话使用相同的状态信息. NSURLSession支持进程三种会话:

   1. defaultSessionConfiguration：进程内会话（默认会话），用硬盘来缓存数据。
   2. ephemeralSessionConfiguration：临时的进程内会话（内存），不会将cookie、缓存储存到本地，只会放到内存中，当应用程序退出后数据也会消失。
   3. backgroundSessionConfiguration：后台会话，相比默认会话，该会话会在后台开启一个线程进行网络数据处理。