本文意义
- 实现大文件离线下载
- 即便由于系统原因,应用程序异常退出,下次进入,仍然能够继续上一次的下载
使用的技术
- 使用
NSURLSession
的代理方法,一点一点下载到沙盒中
- 使用输出流对象
NSOutputStream
,向沙盒中写文件
- 设置请求头
@"Range"
,实现断点下载
- 使用
NSFileManager
对象,获取文件的属性(文件已下载长度)
- 使用
MD5
,通过对请求文件的URL进行MD5加密,保证文件名的唯一性
分析实现代码
定义所需要的宏,方便调用
// 所需要下载的文件的URL
#define ZMJFileURL @"http://www.baidu.com/resources/videos/01.mp4"
// 文件名(沙盒中的文件名)
#define ZMJFilename ZMJFileURL.md5String
// 文件的存放路径(caches)
#define ZMJFileFullpath [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:ZMJFilename]
// 存储文件总长度的文件路径(caches)
#define ZMJTotalLengthFullpath [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:@"totalLength.ZMJ"]
// 文件的已下载长度
#define ZMJDownloadLength [[[NSFileManager defaultManager] attributesOfItemAtPath:ZMJFileFullpath error:nil][NSFileSize] integerValue]
定义所需的变量,遵守协议NSURLSessionDataDelegate
@interface ViewController () <NSURLSessionDataDelegate>
/** 下载任务 */
@property (nonatomic, strong) NSURLSessionDataTask *task;
/** session */
@property (nonatomic, strong) NSURLSession *session;
/** 写文件的流对象 */
@property (nonatomic, strong) NSOutputStream *stream;
/** 文件的总长度 */
@property (nonatomic, assign) NSInteger totalLength;
@end
创建对象
// 懒加载,第一次使用NSURLSession对象创建
- (NSURLSession *)session
{
if (!_session) {
_session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[[NSOperationQueue alloc] init]];
}
return _session;
}
// 懒加载,第一次使用NSOutputStream流对象创建
- (NSOutputStream *)stream
{
if (!_stream) {
_stream = [NSOutputStream outputStreamToFileAtPath:ZMJFileFullpath append:YES];
}
return _stream;
}
- (NSURLSessionDataTask *)task
{
if (!_task) {
// 从字典ZMJTotalLengthFullpath中获取文件ZMJFilename对应的文件大小
NSInteger totalLength = [[NSDictionary dictionaryWithContentsOfFile:ZMJTotalLengthFullpath][ZMJFilename] integerValue];
// 如果文件已经下载完成,直接退出
if (totalLength && ZMJDownloadLength == totalLength) {
NSLog(@"文件已下载");
return nil;
}
// 创建请求
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:ZMJFileURL]];
// 设置请求头
// Range : bytes=xxx-xxx
NSString *range = [NSString stringWithFormat:@"bytes=%zd-", ZMJDownloadLength];
[request setValue:range forHTTPHeaderField:@"Range"];
// 创建一个Data任务
_task = [self.session dataTaskWithRequest:request];
}
return _task;
}
代理方法,实现文件的下载
#pragma mark - <NSURLSessionDataDelegate>
// 1.接收到响应
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSHTTPURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler
{
// 打开流
[self.stream open];
// 获得服务器这次请求 返回数据的总长度
self.totalLength = [response.allHeaderFields[@"Content-Length"] integerValue] + ZMJDownloadLength;
// 存储总长度
NSMutableDictionary *dict = [NSMutableDictionary dictionaryWithContentsOfFile:ZMJTotalLengthFullpath];
// 如果字典为空,创建一个字典
if (dict == nil) dict = [NSMutableDictionary dictionary];
// 设置文件对应的文件长度
dict[ZMJFilename] = @(self.totalLength);
// 将文件长度信息存入沙盒文件
[dict writeToFile:ZMJTotalLengthFullpath atomically:YES];
// 接收这个请求,允许接收服务器的数据
completionHandler(NSURLSessionResponseAllow);
}
// 2.接收到服务器返回的数据(这个方法可能会被调用N次)
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data
{
// 写入数据
[self.stream write:data.bytes maxLength:data.length];
// 下载进度
NSLog(@"%f", 1.0 * ZMJDownloadLength / self.totalLength);
}
// 3.请求完毕(成功\失败)
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error
{
// 关闭流
[self.stream close];
self.stream = nil;
// 清除任务
self.task = nil;
}
开始下载和暂停下载
// 开始下载
- (IBAction)start:(id)sender {
// 启动任务
[self.task resume];
}
// 暂停下载
- (IBAction)pause:(id)sender {
[self.task suspend];
}
PS:如有不懂的,可以留言交流