NSURLSession详解

原创
2015/12/11 23:35
阅读数 308

    <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];

}














展开阅读全文
打赏
0
2 收藏
分享
加载中
更多评论
打赏
0 评论
2 收藏
0
分享
OSCHINA
登录后可查看更多优质内容
返回顶部
顶部