NSURLSession详解

    <1> NSURLSession 简介:
    {
        NSURLSession 是 iOS 7.0 以后推出的网络解决方案!用于替代 NSURLConnection,  针对下载/上传等复杂的网络操做提供了专门的解决方案!
   
        NSURLSession 使用更加简单/方便!
   
    }
    <2> NSURLSession 中新增的内容:
    {
        1> 全局的 NSURLSession 对象: 全部的网络会话都由一个 NSURLSession 对象发起, 实例化一个 NSURLSession 对象有两种方法:
            {
                *1 对于简单的,不须要监听网络请求过程的网络会话来讲,使用系统提供的,全局的 NSURLSession 单利对象:
           
                NSURLSession *session = [NSURLSession sharedSession];
           
                *2 若是须要监听网络进度,须要自定义一个 NSURLSession 对象,而且设置代理!这时还须要一个 NSURLSessionConfiguration,能够设置全局的网络访问属性.
           
                NSURLSessionConfiguration *cfg = [NSURLSessionConfiguration defaultSessionConfiguration];
           
                NSURLSession *session = [NSURLSession sessionWithConfiguration:cfg delegate:self delegateQueue:[NSOperationQueue mainQueue]];
            }
        2> 网络任务(Task);在 NSURLSession 中,有三种网络任务类型.
            {
                *1 用于非文件下载的普通的 GET/POST请求 NSURLSessionDataTask.实例化对象有如下2种方法:
                {
                    // 1> 经过一个 request 实例化普通网络任务,增长完成以后的 block 回调,使用比较多.
                    NSURLSessionDataTask *task = [self.session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
                       
                    }];
               
                    // 2> 经过一个 url 实例化普通网络任务,增长完成以后的 block 回调,使用比较多.
                    NSURLSessionDataTask *task = [self.session dataTaskWithURL:url completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
                   
                    }];
                }
                *2 用于文件下载的网络任务 NSURLSessionDownloadTask (不管文件大小,下载都使用 NSURLSessionDownloadTask) ,实例化对象有如下三种方法:
                {
                    // 1> 经过一个 request 实例化下载网络任务,增长任务完成以后的 block 回调,通常用在小文件下载.

                    NSURLSessionDownloadTask *task = [self.session downloadTaskWithRequest:request completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) {
                       
                    }];

                    // 2> 经过一个 url 实例化下载网络任务,增长任务完成以后的 block 回调,通常用在小文件下载.
                    NSURLSessionDownloadTask *task = [self.session downloadTaskWithURL:url completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) {
                       
                    }];
               
                    // 3> 经过以前下载的数据 ResumeData ,实例化一个下载任务,用于断点续传.
                    NSURLSessionDownloadTask *task = [session downloadTaskWithResumeData:ResumeData completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) {
                       
                    }];
                }
                *3 用于文件上传的网络任务 NSURLSessionUploadTask.
                {
                    // 目前,只有经过这种方式实例化的下载任务,才能实现文件上传.依然须要拼接数据.
               
                    NSURLSessionUploadTask *task = [session uploadTaskWithRequest:request fromData:fromData completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
                        //
                    }]
                }
            }
    }
    <3> NSURLSession 的使用分为三步:
    {
        1> 实例化一个 NSURLSession 对象 session ;
        NSURLSession *session = [NSURLSession sharedSession];

        2> 经过 NSURLSession 对象,实例化对应的网络任务 task;
        NSURLSessionDataTask *task = [session dataTaskWithRequest:request];

        3> 开启网络任务
        [task resume];
    }
}
/*------------------------------------  02 NSURLSession 下载的断点续传 ---------------------------*/
1.使用 NSURLSession 实现下载任务. 

2.实时监听下载进度,使用断点续传.
{
    利用 NSURLSession 实现文件下载,首先须要建立一个 NSURLSessionDownloadTask; 因为须要实时监听下载进度,因此,须要实现 <NSURLSessionDownloadDelegate>方法,这样,就须要自定义一个会话 session.而且制定代理.
   
    // NSURLSession 下载的断点续传实现步骤:
   
    1. 懒加载全局网络会话
    {
        -(NSURLSession *)session
        {
            if (!_session) {
               
                NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
               
                _session = [NSURLSession sessionWithConfiguration:config delegate:self delegateQueue:nil];
               
            }
            return _session;
        }
    }
    2. 利用全局网络会话,建立下载 task, 开始下载任务
    {
        self.task = [self.session downloadTaskWithURL:url];
       
        [self.task resume];
    }
    3. 在代理方法中,实时监听下载进度
    {
        // 监听下载进度的方法
        // bytesWritten :本次下载的字节数
        // totalBytesWritten :已经下载的字节数
        // totalBytesExpectedToWrite :下载文件的总字节数
        -(void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
        {
           
            NSLog(@"代理回调~");
           
            float progress = (float)totalBytesWritten/totalBytesExpectedToWrite;
           
            dispatch_async(dispatch_get_main_queue(), ^{
               
                self.progress.progress = progress;
               
            });
           
        }
       
        // 完成下载的时候调用
        -(void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location
        {
            NSLog(@"下载完成%@",location);
        }
       
        // 断点续传的代理方法,暂时什么都不写
        -(void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didResumeAtOffset:(int64_t)fileOffset expectedTotalBytes:(int64_t)expectedTotalBytes
        {
            NSLog(@"%s",__FUNCTION__);
        }
    }
    4. 当点击暂停以后,应该取消下载任务,记录当前下载的文件数据,而且将 task 任务设为 nil
    {
        [self.task cancelByProducingResumeData:^(NSData *resumeData) {
           
            self.reusemData = resumeData;
           
            self.task = nil;
        }];
    }
    5. 当点击继续以后,应该从上次下载的进度继续下载,这时,从新建立下载 task, 而且是根据上次记录的文件下载数据来实例化下载任务
    {
        if (!self.reusemData) {
            return;
        }
       
        self.task = [self.session downloadTaskWithResumeData:self.reusemData];
       
        self.reusemData = nil;
       
        [self.task resume];
    }
   
}
/*------------------------------------- 03 NSURLSession 实现上传文件 -----------------------------*/
1.使用 NSURLSession 实现文件上传.
{
    NSURLSession 上传文件和 NSURLConnection 同样须要按格式拼接文件数据.重要的是要学会封装方法,具体使用以下:
    {
        // NSURLSession 作文件上传
        - (void)uploadMfileSession
        {
            // 1.实例化全局网络会话
            NSURLSession *session = [NSURLSession sharedSession];
           
            // 2.建立网络请求
            {
                NSURL *url = [NSURL URLWithString:@"http://localhost/upload/upload-m.php"];
               
                NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
                // 设置请求方法
                request.HTTPMethod = @"POST";
                // 告诉服务器,须要作文件上传
                NSString *contentType = [NSString stringWithFormat:@"multipart/form-data; boundary=%@",kBOUNDARY];
               
                [request setValue:contentType forHTTPHeaderField:@"Content-Type"];
            }
           
            // 3. 将须要上传至服务器的文件包装在字典中.
            {
                // 须要上传的文件路径
                NSString *file1 = @"/Users/likaining/Desktop/meinv.jpg";
                NSString *file2 = @"/Users/likaining/Downloads/XMLdemo.xml";
               
                // 文件在服务器中保存的名称
                NSString *fileName1 = @"meinv";
                NSString *fileName2 = @"demo";
               
                // 将上传数据包装在字典中
                NSMutableDictionary *fileDict = [NSMutableDictionary dictionary];

                [fileDict setObject:file1 forKey:fileName1];
                [fileDict setObject:file2 forKey:fileName2];
            }
            // 4. 将须要上传的非文件数据也包装在字典中
            {
                NSMutableDictionary *parameter = [NSMutableDictionary dictionary];
                [parameter setObject:@"likaining" forKey:@"username"];
            }
            // 5. 将须要上传的数据,按照上传的数据格式化数据.而且转为二进制数据.
            NSData *dataM = [self formDataWithfileName:@"userfile[]" fileDict:fileDict parameter:parameter];
           
            // 6. 利用网络会话,创建上传任务
            NSURLSessionUploadTask *task = [session uploadTaskWithRequest:request fromData:dataM completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
                //
                NSLog(@"%@",[[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);
               
                NSLog(@"response: %@",response);
               
            }];
           
            // 7 .开始上传.
            [task resume];
        }
       
        // 格式化上传数据的方法封装.
        - (NSData *) formDataWithfileName:(NSString *)fileName fileDict:(NSDictionary *)fileDict parameter:(NSDictionary *)parameter
        {
           
            NSMutableData *data = [NSMutableData data];
           
            // key : 服务器保存的文件名
            // obj : 上传的文件地址
            [fileDict enumerateKeysAndObjectsUsingBlock:^(id key, id obj, BOOL *stop) {
                //
                NSMutableString *headerStrM = [NSMutableString stringWithFormat:@"\r\n--%@\r\n",kBOUNDARY];
                [headerStrM appendFormat:@"Content-Disposition: form-data; name=%@; filename=%@\r\n",fileName,key];
               
                NSString *contentType = [self getContentTypeFromFile:obj];
               
                [headerStrM appendFormat:@"Content-Type: %@\r\n\r\n",contentType];
               
                NSData *headerData = [headerStrM dataUsingEncoding:NSUTF8StringEncoding];
               
                NSData *fileData = [NSData dataWithContentsOfFile:obj];
               
               
                [data appendData:headerData];
                [data appendData:fileData];
               
            }];
           
            // key :username 服务器接收的 key
            // obj :上传文件的人
            [parameter enumerateKeysAndObjectsUsingBlock:^(id key, id obj, BOOL *stop) {
                //
                NSMutableString *headerM = [NSMutableString stringWithFormat:@"\r\n--%@\r\n",kBOUNDARY];
                [headerM appendFormat:@"Content-Disposition: form-data; name=%@\r\n\r\n",key];
               
                NSString *username = obj;
               
                NSData *headerData = [headerM dataUsingEncoding:NSUTF8StringEncoding];
               
                NSData *userData = [username dataUsingEncoding:NSUTF8StringEncoding];
               
                [data appendData:headerData];
                [data appendData:userData];
               
            }];
           
            NSMutableString *footerStrM = [NSMutableString stringWithFormat:@"\r\n--%@--\r\n",kBOUNDARY];
           
            NSData *footerData = [footerStrM dataUsingEncoding:NSUTF8StringEncoding];
           
            [data appendData:footerData];
           
            return data;
        }
    }
   
}
/*------------------------------------- 04 文件的复制和剪切 ---------------------------------------*/
文件操做中的复制和剪切.
{
    文件下载到本地以后,有时候须要对文件进行移动操做,这样就须要掌握掌握文件的复制和剪切操做.
   
    1.文件的拷贝
    // 新建一个文件路径
    NSString *path = @"/Users/likaining/Desktop/abc/";
   
    // 从一个文件路径拷贝文件到另外一个文件路径
    // AtPath : 拷贝前的文件路径
    // ToPath : 拷贝后的文件路径
    [[NSFileManager defaultManager] copyItemAtPath:location.path toPath:path error:0];
   
   
    2.文件的剪切
    // response.suggestedFilename:建议使用的文件名,通常跟服务器端的文件名一致
    NSString *file = [caches stringByAppendingPathComponent:downloadTask.response.suggestedFilename];
   
    // 将临时文件剪切到Caches文件夹
    // AtPath : 剪切前的文件路径
    // ToPath : 剪切后的文件路径
    [[NSFileManager defaultManager] moveItemAtPath:location.path toPath:file error:nil];
   
}
/*------------------------------------- 05 文件的解压缩 ------------------------------------------*/
文件的解压缩操做,使用解压缩框架.
{
    为了方便网络传输,文件常常被压缩以后再进行网络传输,这个时候,须要学会解压缩文件.
   
    1.文件的解压缩须要导入第三方框架: SSZipArchive ,须要注意的是,这个框架依赖一个动态度 libz.dylib.
   
    2. 压缩文件:
    // 1.得到须要压缩的文件夹
    NSString *images = [caches stringByAppendingPathComponent:@"images"];
   
    // 1.建立一个zip文件（压缩）
    NSString *zipFile = [caches stringByAppendingPathComponent:@"images.zip"];
   
    BOOL result = [SSZipArchive createZipFileAtPath:zipFile withContentsOfDirectory:images];
   
    3. 解压缩文件:
    // location.path:须要解压缩的文件
    // 文件解压缩以后存放的路径(注意,只须要给出一个文件路径就能够,由于极可能解压缩以后,生成不少个文件).
    [SSZipArchive unzipFileAtPath:location.path toDestination:path];

}