iOS项目开发—文件下载功能的实现

一、简单说明

 

1.思路

把下载的data追加到文件的尾部，直到所有的数据下载完为止。

1.在连通了服务器的时候，创建一个空的文件到沙盒中NSFileManager(文件管理类)

2.创建写数据的文件句柄

3.在接收到服务器返回的数据后，把data写入到创建的空文件中，但是不能使用writeTofile(会覆盖)

3.1移动到文件的尾部

3.2从当前移动的位置，写入数据

4.服务器的数据加载完毕后关闭连接，不再输入数据在文件中

二、代码示例

1.代码：

新建一个类，让其继承自NSObject类，一个文件下载器只下载一个文件。

自定义类的TXFileDownloader.h代码：

//
//  TXFileDownloader.h
//  文件下载
//
//  Created by 鑫 on 14/12/23.
//  Copyright (c) 2014年 梁镋鑫. All rights reserved.
//

#import <Foundation/Foundation.h>

@interface TXFileDownloader : NSObject
//下载的远程url(连接到服务器的路径)
@property(nonatomic,strong)NSString *url;
//下载后的存储路径（文件下载到什么地方）
@property(nonatomic,strong)NSString *destPath;
//是否正在下载(只有下载器内部清楚)
@property(nonatomic,readonly,getter = isDownloading)BOOL Downloading;
//用来监听下载进度
@property(nonatomic,copy)void (^progressHandler)(double progress);
//用来监听下载完成
@property(nonatomic,copy)void (^completionHandler)();
//用来监听下载错误
@property(nonatomic,copy)void(^failureHandler)(NSError *error);
-(void)pause;
-(void)start;
@end

自定义类的TXFileDownloader.m

//  TXFileDownloader.m
//  文件下载
//
//  Created by 鑫 on 14/12/23.
//  Copyright (c) 2014年 梁镋鑫. All rights reserved.
//

#import "TXFileDownloader.h"
@interface TXFileDownloader ()<NSURLConnectionDataDelegate>
//请求对象
@property(nonatomic,strong)NSURLConnection *cnnt;
//文件句柄
@property(nonatomic,strong)NSFileHandle *writeHandle;
//当前获取到的数据长度
@property(nonatomic,assign)long long currentLength;
//完整数据长度
@property(nonatomic,assign)long long sumLength;
@end

@implementation TXFileDownloader
//开始下载
-(void)start
{
    _Downloading=YES;
    
    //创建一个请求
    NSURL *URL=[NSURL URLWithString:self.url];
    NSMutableURLRequest *request=[NSMutableURLRequest requestWithURL:URL];
    
    //设置请求头信息
    //self.currentLength字节部分重新开始读取
    NSString *value=[NSString stringWithFormat:@"bytes=%lld-",self.currentLength];
    [request setValue:value forHTTPHeaderField:@"Range"];
    
    //发送请求（使用代理的方式）
    self.cnnt=[NSURLConnection connectionWithRequest:request delegate:self];
    
}

//暂停下载
-(void)pause
{
    _Downloading=NO;
    //取消发送请求
    [self.cnnt cancel];
    self.cnnt=nil;
}

#pragma mark- NSURLConnectionDataDelegate代理方法
/*
 *当接收到服务器的响应（连通了服务器）时会调用
 */
-(void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response
{
#warning 判断是否是第一次连接
    if (self.sumLength) return;
    
    //1.创建文件存数路径
    NSString *caches=[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject];
    NSString *filePath=[caches stringByAppendingPathComponent:@"video.zip"];
    
    
    
    //2.创建一个空的文件,到沙盒中
    NSFileManager *mgr=[NSFileManager defaultManager];
    //刚创建完毕的大小是o字节
    [mgr createFileAtPath:filePath contents:nil attributes:nil];
    
    //3.创建写数据的文件句柄
    self.writeHandle=[NSFileHandle fileHandleForWritingAtPath:filePath];
    
    //4.获取完整的文件长度
    self.sumLength=response.expectedContentLength;
}

/*
 *当接收到服务器的数据时会调用（可能会被调用多次，每次只传递部分数据）
 */
-(void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data
{
    //累加接收到的数据长度
    self.currentLength+=data.length;
    //计算进度值
    double progress=(double)self.currentLength/self.sumLength;
    //    self.progress.progress=progress;
    if (self.progressHandler) {//传递进度值给block
        self.progressHandler(progress);
        
        //相当于在此处调用了下面的代码
        //        ^(double progress)
        //        {
        //            //把进度的值，传递到控制器中进度条，以进行显示
        //            vc.progress.progress=progress;
        //        };
    }
    
    
    //一点一点接收数据。
    NSLog(@"接收到服务器的数据！---%d",data.length);
    //把data写入到创建的空文件中，但是不能使用writeTofile(会覆盖)
    //移动到文件的尾部
    [self.writeHandle seekToEndOfFile];
    //从当前移动的位置，写入数据
    [self.writeHandle writeData:data];
}

/*
 *当服务器的数据加载完毕时就会调用
 */
-(void)connectionDidFinishLoading:(NSURLConnection *)connection
{
    NSLog(@"下载完毕----%lld",self.sumLength);
    //关闭连接，不再输入数据在文件中
    [self.writeHandle closeFile];
    self.writeHandle=nil;
    
    //清空进度值
    self.currentLength=0;
    self.sumLength=0;
    
    if (self.completionHandler) {//下载完成通知控制器
        self.completionHandler();
        //相当于下面的代码
        //        ^{
        //            NSLog(@"下载完成");
        //            [self.btn setTitle:@"下载已经完成" forState:UIControlStateNormal];
        //        }
    }
    
}
/*
 *请求错误（失败）的时候调用（请求超时断网没有网，一般指客户端错误）
 */
-(void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error
{
    if (self.failureHandler) {//通知控制器，下载出错
        self.failureHandler(error);
        //相当于调用了下面的代码
        //        ^{
        //            NSLog(@"下载错误！");
        //        }
    }
}

@end

实现代码：

主控制器TXViewController.m

//
//  TXViewController.m
//  文件下载
//
//  Created by 鑫 on 14/12/23.
//  Copyright (c) 2014年 梁镋鑫. All rights reserved.
//

#import "TXViewController.h"
#import "TXFileDownloader.h"
@interface TXViewController ()


@property(nonatomic,strong)TXFileDownloader *fileDownloader;
@property (weak, nonatomic) IBOutlet UIButton *btn;
@property (weak, nonatomic) IBOutlet UIProgressView *progress;
@end

@implementation TXViewController

- (void)viewDidLoad
{
    [super viewDidLoad];
}

#pragma mark-懒加载
-(TXFileDownloader *)fileDownloader
{
    if (_fileDownloader==nil) {
        _fileDownloader=[[TXFileDownloader alloc]init];
        //设置文件下载路径
        _fileDownloader.url=@"http://192.168.1.53:8080/MJServer/resources/video.zip";
        
        //设置文件保存路径
        NSString *caches=[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject];
        NSString *filePath=[caches stringByAppendingPathComponent:@"video.zip"];
        _fileDownloader.destPath=filePath;
        
        //获取10的真实类型，把它作为a的类型
        //        typeof(10) a = 20; // int a = 20;
        __weak typeof(self) vc=self;
        _fileDownloader.progressHandler=^(double progress)
        {
            vc.progress.progress=progress;
            NSLog(@"%f",progress);
        };
        _fileDownloader.completionHandler=^{
            NSLog(@"下载完成");
            [vc.btn setTitle:@"下载已经完成" forState:UIControlStateNormal];
        };
        _fileDownloader.failureHandler=^(NSError *error){
            NSLog(@"下载错误！%@",error);
        };
    }
    return _fileDownloader;
}

//点击下载按钮，处理操作
- (IBAction)star {
    if (self.fileDownloader.isDownloading) {//如果正在下载，那么调用方法暂停
        [self.fileDownloader pause];
        [self.btn setTitle:@"暂停" forState:UIControlStateNormal];
    }else//如果没有正在下载，那么调用下载方法
    {
        [self.fileDownloader start];
        [self.btn setTitle:@"下载" forState:UIControlStateNormal];
    }
}

@end

代码：

 

控制器想监听下载器的下载进度，控制器想监听下载器的下载完毕，控制器想监听下载器的下载失败等都可以使用block的方式进行。

打印查看：

2.代码说明

（1）创建文件存储路径（写入到沙盒）

 NSString *caches=[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject];

 NSString *filePath=[caches stringByAppendingPathComponent:@"video.zip"];

（2）创建一个空的文件夹（ NSFileManager类的使用）

 NSFileManager *mgr=[NSFileManager defaultManager];

（3）创建写数据的文件句柄

      self.writeHandle=[NSFileHandle fileHandleForWritingAtPath:filePath];

（4）把data写入到创建的空文件中，但是不能使用writeTofile(会覆盖)

移动句柄到文件的尾部     [self.writeHandle seekToEndOfFile];

（5）下载完毕的时候，关闭连接

[self.writeHandle closeFile];

3、Range简单说明

通过设置请求头Range可以指定每次从网路下载数据包的大小

Range示例

bytes=0-499 从0到499的头500个字节

bytes=500-999 从500到999的第二个500字节

bytes=500- 从500字节以后的所有字节 

bytes=-500 最后500个字节

bytes=500-599,800-899 同时指定几个范围

Range小结

- 用于分隔

前面的数字表示起始字节数

后面的数组表示截止字节数，没有表示到末尾

, 用于分组，可以一次指定多个Range，不过很少用

注意：关键代码

        从self.currentLength字节部分重新开始读取

        NSString *value=[NSString stringWithFormat:@"bytes=%lld-",self.currentLength];

        [request setValue:value forHTTPHeaderField:@"Range"];