iOS网络--『文件下载、断点下载』的实现（三）：AFNetworking

2017-02-14

字数统计: 1.4k字 | 阅读时长≈ 6分

目录

AFNetworking下载简介
AFNetworking下载相关
2.1 AFNetworking（文件下载）
2.2 AFNetworking（断点下载 | 支持离线）
关于『文件下载、断点下载』所有实现的Demo地址：
Demo地址

iOS网络–『文件下载、断点下载』的实现相关文章：

iOS网络–『文件下载、断点下载』的实现（一）：NSURLConnection

iOS网络–『文件下载、断点下载』的实现（二）：NSURLSession

iOS网络–『文件下载、断点下载』的实现（三）：AFNetworking

AFNetworking下载简介

这里只讲解AFNetworking下载文件相关知识。对于第三方框架的导入在这里不做讲解，如果有问题可以上AFNetworking的GitHub上了解。—> AFNetworking官方地址

AFNetworking下载相关

2.1 AFNetworking（文件下载）

AAFNetworking（文件下载）效果.gif
AFNetworking实现文件下载总共四步：

创建会话管理者
创建下载路径和请求对象
创建下载任务
启动下载任务
具体实现代码如下：

  NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
  // 1. 创建会话管理者
  AFURLSessionManager *manager = [[AFURLSessionManager alloc] initWithSessionConfiguration:configuration];

  // 2. 创建下载路径和请求对象
  NSURL *URL = [NSURL URLWithString:@"http://dldir1.qq.com/qqfile/QQforMac/QQ_V5.4.0.dmg"];
  NSURLRequest *request = [NSURLRequest requestWithURL:URL];

 // 3.创建下载任务
 /**
  * 第一个参数 - request：请求对象
  * 第二个参数 - progress：下载进度block
  *      其中： downloadProgress.completedUnitCount：已经完成的大小
  *            downloadProgress.totalUnitCount：文件的总大小
  * 第三个参数 - destination：自动完成文件剪切操作
  *      其中： 返回值:该文件应该被剪切到哪里
  *            targetPath：临时路径 tmp NSURL
  *            response：响应头
  * 第四个参数 - completionHandler：下载完成回调
  *      其中： filePath：真实路径 == 第三个参数的返回值
  *            error:错误信息
  */
  NSURLSessionDownloadTask *downloadTask = [manager downloadTaskWithRequest:request progress:^(NSProgress *downloadProgress) {

// 下载进度
self.progressView.progress = 1.0 * downloadProgress.completedUnitCount / downloadProgress.totalUnitCount;
self.progressLabel.text = [NSString stringWithFormat:@"当前下载进度:%.2f%%",100.0 * downloadProgress.completedUnitCount / downloadProgress.totalUnitCount];

} destination:^NSURL *(NSURL *targetPath, NSURLResponse *response) {

NSURL *path = [[NSFileManager defaultManager] URLForDirectory:NSDocumentDirectory inDomain:NSUserDomainMask appropriateForURL:nil create:NO error:nil];
return [path URLByAppendingPathComponent:@"QQ_V5.4.0.dmg"]; 

} completionHandler:^(NSURLResponse *response, NSURL *filePath, NSError *error) {        
NSLog(@"File downloaded to: %@", filePath);
 }];

// 4. 开启下载任务
[downloadTask resume];
2.2 AFNetworking（断点下载 | 支持离线）

AFNetworking（断点下载 | 支持离线）下载效果.gif
AFNetworking3.0是基于NSURLSession的。所以实现原理和NSURLSession差不多。可参考NSURLConnection实现断点下载的方法。
相关文章链接：iOS网络 - 『文件下载、断点下载』的实现（二）：NSURLSession。
这里使用了NSURLSessionDataTask，以便实现『离线断点下载』。

具体实现步骤如下：

 定义下载文件需要用到的类，这里不需要实现代理
 @interface ViewController ()

  /** 下载进度条 */
  @property (weak, nonatomic) IBOutlet UIProgressView *progressView;
  /** 下载进度条Label */
  @property (weak, nonatomic) IBOutlet UILabel *progressLabel;

  /** AFNetworking断点下载（支持离线）需用到的属性 **********/
  /** 文件的总长度 */
  @property (nonatomic, assign) NSInteger fileLength;
  /** 当前下载长度 */
  @property (nonatomic, assign) NSInteger currentLength;
  /** 文件句柄对象 */
  @property (nonatomic, strong) NSFileHandle *fileHandle;

  /** 下载任务 */
  @property (nonatomic, strong) NSURLSessionDataTask *downloadTask;
  /* AFURLSessionManager */
  @property (nonatomic, strong) AFURLSessionManager *manager;

  @end
  添加全局NSURLSessionDataTask、AFURLSessionManager懒加载代码。这里我把实现『离线断点下载』的代码都放这里了。
  /**
   * manager的懒加载
   */
 - (AFURLSessionManager *)manager {
if (!_manager) {
    NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
    // 1. 创建会话管理者
    _manager = [[AFURLSessionManager alloc] initWithSessionConfiguration:configuration];
}
return _manager;
}

/**
 * downloadTask的懒加载
 */
- (NSURLSessionDataTask *)downloadTask {
if (!_downloadTask) {
    // 创建下载URL
    NSURL *url = [NSURL URLWithString:@"http://dldir1.qq.com/qqfile/QQforMac/QQ_V5.4.0.dmg"];

    // 2.创建request请求
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];

    // 设置HTTP请求头中的Range
    NSString *range = [NSString stringWithFormat:@"bytes=%zd-", self.currentLength];
    [request setValue:range forHTTPHeaderField:@"Range"];

    __weak typeof(self) weakSelf = self;
    _downloadTask = [self.manager dataTaskWithRequest:request completionHandler:^(NSURLResponse * _Nonnull response, id  _Nullable responseObject, NSError * _Nullable error) {
        NSLog(@"dataTaskWithRequest");

        // 清空长度
        weakSelf.currentLength = 0;
        weakSelf.fileLength = 0;

        // 关闭fileHandle
        [weakSelf.fileHandle closeFile];
        weakSelf.fileHandle = nil;

    }];

    [self.manager setDataTaskDidReceiveResponseBlock:^NSURLSessionResponseDisposition(NSURLSession * _Nonnull session, NSURLSessionDataTask * _Nonnull dataTask, NSURLResponse * _Nonnull response) {
        NSLog(@"NSURLSessionResponseDisposition");

        // 获得下载文件的总长度：请求下载的文件长度 + 当前已经下载的文件长度
        weakSelf.fileLength = response.expectedContentLength + self.currentLength;

        // 沙盒文件路径
        NSString *path = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:@"QQ_V5.4.0.dmg"];

        NSLog(@"File downloaded to: %@",path);

        // 创建一个空的文件到沙盒中
        NSFileManager *manager = [NSFileManager defaultManager];

        if (![manager fileExistsAtPath:path]) {
            // 如果没有下载文件的话，就创建一个文件。如果有下载文件的话，则不用重新创建(不然会覆盖掉之前的文件)
            [manager createFileAtPath:path contents:nil attributes:nil];
        }

        // 创建文件句柄
        weakSelf.fileHandle = [NSFileHandle fileHandleForWritingAtPath:path];

        // 允许处理服务器的响应，才会继续接收服务器返回的数据
        return NSURLSessionResponseAllow;
    }];

    [self.manager setDataTaskDidReceiveDataBlock:^(NSURLSession * _Nonnull session, NSURLSessionDataTask * _Nonnull dataTask, NSData * _Nonnull data) {
        NSLog(@"setDataTaskDidReceiveDataBlock");

        // 指定数据的写入位置 -- 文件内容的最后面
        [weakSelf.fileHandle seekToEndOfFile];

        // 向沙盒写入数据
        [weakSelf.fileHandle writeData:data];

        // 拼接文件总长度
        weakSelf.currentLength += data.length;

        // 获取主线程，不然无法正确显示进度。
        NSOperationQueue* mainQueue = [NSOperationQueue mainQueue];
        [mainQueue addOperationWithBlock:^{
            // 下载进度
            if (weakSelf.fileLength == 0) {
                weakSelf.progressView.progress = 0.0;
                weakSelf.progressLabel.text = [NSString stringWithFormat:@"当前下载进度:00.00%%"];
            } else {
                weakSelf.progressView.progress =  1.0 * weakSelf.currentLength / weakSelf.fileLength;
                weakSelf.progressLabel.text = [NSString stringWithFormat:@"当前下载进度:%.2f%%",100.0 * weakSelf.currentLength / weakSelf.fileLength];
            }

        }];
    }];
}
return _downloadTask;
}
添加支持断点下载的[开始下载/暂停下载]按钮，并实现相应功能的代码
/**
 * 点击按钮 -- 使用AFNetworking断点下载（支持离线）
 */
- (IBAction)OfflinResumeDownloadBtnClicked:(UIButton *)sender {
// 按钮状态取反
sender.selected = !sender.isSelected;

if (sender.selected) { // [开始下载/继续下载]
    // 沙盒文件路径
    NSString *path = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:@"QQ_V5.4.0.dmg"];

    NSInteger currentLength = [self fileLengthForPath:path];
    if (currentLength > 0) {  // [继续下载]
        self.currentLength = currentLength;
    }

    [self.downloadTask resume];

} else {
    [self.downloadTask suspend];
    self.downloadTask = nil;
}
}

/**
 * 获取已下载的文件大小
 */
- (NSInteger)fileLengthForPath:(NSString *)path {
NSInteger fileLength = 0;
NSFileManager *fileManager = [[NSFileManager alloc] init]; // default is not thread safe
if ([fileManager fileExistsAtPath:path]) {
    NSError *error = nil;
    NSDictionary *fileDict = [fileManager attributesOfItemAtPath:path error:&error];
    if (!error && fileDict) {
        fileLength = [fileDict fileSize];
    }
}
return fileLength;
}

这样我们用AFNetworking也实现了『离线断点下载』的需求。

本文作者： Grx
本文链接： https://ruixiaoguo.github.io/Grx.github.io/Grx.github.io/2017/02/14/iOS网络-『文件下载、断点下载』的实现（三）：AFNetworking/
版权声明： 本博客所有文章除特别声明外，均采用 MIT 许可协议。转载请注明出处！