iOS NSURLSession 封装下载类

  周六日鼓捣NSURLSession,效率虽然低下,最后还是有了一点点眉目。昨天和汤老师一起测试,又对它加深了一点理解。趁热打铁,先总结一下。

  封装的类,对外用的方法,我写的是类方法,所以,在类方法中,就不能调用本身的@property变量了。解决办法是:将本身的类先定义为单例,在利用单例将本身的属性方法调用出来。

  0.准备工作

  工具类必须先遵守DownloadDelegate,同时建立一个session的属性方法

@property(nonatomic, strong)NSURLSession * downloadSession;

  1.单例的构造方法:

+(DownloadTool *)instance{   //DownloadTool是当前封装类的名字
static DownloadTool * aInstance = nil;
static dispatch_once_t once_token;
dispatch_once(&once_token, ^{
aInstance = [[DownloadTool alloc]init];
aInstance.downloadDic = [NSMutableDictionary dictionary]; //这个是本身的一个@property属性变量,放在这个里面进行初始化
});
return aInstance;
}

  单例构造完成,在类方法里面,我们就可以使用单例来调出属性变量。

  2.单一session的构造方法

/**
* 创建session
*/
- (NSURLSession *)isDownloadSession{
if (!_downloadSession) {
NSString * configurationStr = @"DownloadTool";
NSURLSessionConfiguration * sessionConfiguration = [NSURLSessionConfiguration backgroundSessionConfigurationWithIdentifier:configurationStr];
NSURLSession * downloadSession = [NSURLSession sessionWithConfiguration:sessionConfiguration delegate:self delegateQueue:[NSOperationQueue mainQueue]];
_downloadSession = downloadSession; //_downloadSession是前面定义的属性方法
}
return _downloadSession;
}

  session用configuration来唯一标示,可以用identifier来唯一标识,和其他的不同的session来区分,如果整个项目的session用的是同一个的话,可以用shareSession单例。代理设置为self,Queue,一般设置为主线程。

  3.开始下载--这个可以定义类的调用方法里面,自己定义,同时将URL传入进来即可

    if ([[DownloadTool instance]isDownloadSession]) {
NSURLSessionDownloadTask * downloadTask = [[DownloadTool instance].downloadSession downloadTaskWithURL:[NSURL URLWithString:url]];
downloadTask.taskDescription = @"downloadTask01";
[downloadTask resume];
}

  3.1 先建立一个downloadTask,用唯一的session来启动,传入具体的URL。

  3.2 taskDescription,可以用来描述下载任务,这个属性是可以修改的,与taskIdentifier不同,taskIdentifier是由系统返回是,一般用数字来标识,可用性不高,我们可以把对下载任务的描述,唯一标识符等,放在taskDescription里面,到后面代理方法里面,可以根据downloadTask.taskDescription将这个值取出来

  3.3 resume:启动下载;必须调用这个方法,才会启动下载,否则不会。当然还有其他的方法,比如暂停、取消。

  4.实现代理方法

  4.1 下载完成

-(void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location{
//建立一个文件夹
BOOL isDirectory;
NSString * folderPath = [[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)objectAtIndex:0]stringByAppendingString:@"/script"];
BOOL isExistFolderPath = [[NSFileManager defaultManager]fileExistsAtPath:folderPath isDirectory:&isDirectory]; if (!isExistFolderPath) {
BOOL createFile = [[NSFileManager defaultManager]createDirectoryAtPath:folderPath withIntermediateDirectories:YES attributes:nil error:nil]; if (createFile) {
NSLog(@"创建文件成功");
}else{
NSLog(@"创建文件失败");
}
} //改变位置
NSString * sourcePath = location.path;
NSString * lastComponent = scScript.url.lastPathComponent;
NSString * destinationPath = [folderPath stringByAppendingPathComponent:lastComponent];
[[NSFileManager defaultManager]moveItemAtPath:sourcePath toPath:destinationPath error:nil]; //保存到数据库
[[DownloadStoreManager sharedInstance]insertScript:scScript]; //发送消息
NSDictionary * dic = @{@"script":scScript};
[[NSNotificationCenter defaultCenter]postNotificationName:DownloadNotificationName object:nil userInfo:dic];
NSLog(@"下载成功------");
}

  这个是下载完成比较早的一个方法,后面还有一个方法。

  在这个方法里面,会将下载到的文件,暂时放置temp文件里面,如果我们不处理,系统稍后会把这个文件给清除掉,所以,在这个里面,我们的任务之一,就是把文件移动到目标文件夹里面去。如果目标文件不存在,我们要创建一个文件夹。后面,有可能要存入到数据库里面,这个依业务来定。最后发送消息:DownloadNotificationName是我定义的消息的名称,这个可以依具体情况而定。

  3.2 数据下载完成的第二个方法

//下载完成
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task
didCompleteWithError:(NSError *)error{ if (error) {
NSDictionary * dic = @{@"error":@"下载失败"};
[[NSNotificationCenter defaultCenter]postNotificationName:DownloadNotificationName object:nil userInfo:dic];
} }

  一开始,我被这个方法名字给误导了,以为只有下载失败的时候才会调用这个方法,其实不是的,这个是在任务完成,不管是成功或者失败,都是要调用的一个方法。如果error为null,则说明下载成功,如果error有值,则下载失败,通过error这个值来判别。

当前NSURLSession里面,还有很多其他的方法,比如下载Data、upload上传,原理差不多。

今天先总结到这。昨天晚上太晚了,就没写总结,今天早上补上。

最近来接触新事物时,脑袋刚开始时,总是蒙蒙的,看来得多接受新事物才能调节啊!

上一篇:html5 Application Cache——加快简历二次访问速度


下一篇:HTML5应用程序缓存Application Cache