iOS 大神之路iOS developer第三方框架

MCDownloader(iOS下载器)说明书

2017-04-10  本文已影响2676人  老马的春天

示例

前言

很多iOS应用中都需要下载数据，并对这些下载的过程和结果进行管理，因此我才有了写这个MCDownloader的想法。在IOS 文件下载器-MCDownloadManager这篇文章中，我使用GCD和集合来实现了这个功能，基本上也能满足需求，这一部分的实现原理主要参考AFNetworking的源码，有兴趣的同学可以看看我写的AFNetworking 3.0 源码解读系列。

但是本篇文章中讲的MCDownloader的实现原理和上边提到的不一样，是基于NSOperation来实现的，可以说是我对SDWebImage源码解读的一些额外的扩展，同样，有兴趣的同学可以看看我写的SDWebImage源码解读系列。

MCDownloader目前的版本是1.0.0，可以在这里下载https://github.com/agelessman/MCDownloader

功能

MCDownloader1.0.0版本提供了以下几个功能：

  1. 多线程异步下载，支持自定义并发线程数。在上图的示例图中，采用的并发数为3
  2. 边下载变保存，这一条是该下载器最重要的思想，数据被实时的保存在本地，同时支持断点下载
  3. 十分方便的数据获取能力，通过MCDownloadReceipt来对下载的数据进行抽象，几乎所有的信息都能在MCDownloadReceipt中获取
  4. 提供了下载进度，可以通过接口函数的block监听下载进度和完成回调，也可以通过给MCDownloadReceipt绑定block来监听block回调
  5. 支持显示当前的下载速度
  6. 支持批量下载，批量取消功能
  7. 支持任务的暂停，取消，删除功能
  8. 支持下载顺序定制，先入先出或者后入先出
  9. 支持后台和锁屏下载

如何使用？

开启下载

每一个下载任务的唯一标识是url，因此我们使用下边的代码开始一个下载任务：

 [[MCDownloader sharedDownloader] downloadDataWithURL:[NSURL URLWithString:url] progress:^(NSInteger receivedSize, NSInteger expectedSize, NSInteger speed, NSURL * _Nullable targetURL) {
                
  } completed:^(MCDownloadReceipt * _Nullable receipt, NSError * _Nullable error, BOOL finished) {
      NSLog(@"==%@", error.description);
  }];

可以在上边的progress和completed中自定义处理方法。进度和完成的block回调都在主线程触发。

暂停或取消

MCDownloader的暂停和取消功能是一样的，由于内部下载是基于NSOperation实现的，因此每一个任务就是一个NSOperation，然后再把他们添加到队列之中。当取消或者暂停一个任务后，在重新恢复下载，实际上会重新把该任务添加到队列中，这一点一定要注意。

使用下边的代码来暂停或取消一个下载任务：

[[MCDownloader sharedDownloader] cancel:receipt completed:^{
            [self.button setTitle:@"Start" forState:UIControlStateNormal];
        }];

由于取消不是发生在主线程，所以需要一个completed来捕获取消成功事件，然后在主线程调用。

移除数据

通过下边的方法来移除保存在本地的数据：

 [[MCDownloader sharedDownloader] remove:receipt completed:^{
            [self.tableView reloadData];
        }];

获取数据信息

可以通过下边的代码来获取数据的一些信息，这些信息既可以在下载过程中获取，也可以在下载完成后获取。

MCDownloadReceipt *receipt = [[MCDownloader sharedDownloader] downloadReceiptForURLString:self.url];

通过上边的代码可以看出来，url被当做数据的唯一标识。在上图的例子中，我们是在cell中更新下载进度的，为了防止cell的复用问题，我为每个receipt绑定了progress和complete回调block：

 __weak typeof(receipt) weakReceipt = receipt;
    receipt.downloaderProgressBlock = ^(NSInteger receivedSize, NSInteger expectedSize, NSInteger speed, NSURL * _Nullable targetURL) {
        __strong typeof(weakReceipt) strongReceipt = weakReceipt;
        if ([targetURL.absoluteString isEqualToString:self.url]) {
            [self.button setTitle:@"Stop" forState:UIControlStateNormal];
            self.bytesLable.text = [NSString stringWithFormat:@"%0.1fm/%0.1fm", receivedSize/1024.0/1024,expectedSize/1024.0/1024];
            self.progressView.progress = (receivedSize/1024.0/1024) / (expectedSize/1024.0/1024);
            self.speedLable.text = [NSString stringWithFormat:@"%@/s", strongReceipt.speed ?: @"0"];
        }
        
    };
    
    receipt.downloaderCompletedBlock = ^(MCDownloadReceipt *receipt, NSError * _Nullable error, BOOL finished) {
        if (error) {
            [self.button setTitle:@"Start" forState:UIControlStateNormal];
            self.nameLabel.text = @"Download Failure";
        }else {
            [self.button setTitle:@"Play" forState:UIControlStateNormal];
            self.nameLabel.text = @"Download Finished";
        }
        
    };

取消全部下载和删除全部数据

在某种场景下需要取消全部的下载，比如说监听到网络状态变成4G时，需要询问用户是否继续下载。又或者在需要清空缓存的时候：

[[MCDownloader sharedDownloader] cancelAllDownloads];

[[MCDownloader sharedDownloader] removeAndClearAll];

上边说的这些功能，在demo中都有演示。

核心思想

由于下载功能不算是特别复杂的功能，所以我就简单的说说内部的实现原理。

在代码设计之初，我最先写的类就是MCDownloadReceipt。通过它来对数据进行抽象封装，我们先不管它是如何获取的，只关心它需要暴露多少信息。这个类很简单，我就不把代码弄上来了，但是需要注意下边几点：

完成了模型的搭建后，就要处理最基本的下载任务了，MCDownloadOperation继承自NSOperation，因此在MCDownloadOperation中我们就不需要关心线程的问题。我们在这个类中只做了下边这几件事：

接下来就到了最核心的地方，如何把MCDownloadReceipt和MCDownloadOperation组合在一起，也就是MCDownloader的内容。MCDownloader是暴露出来最核心的模块，在设计上主要考虑下边几件事情：

综上所述，这基本上是写任何一个框架的基本流程，在编码之前先进行设计。 另外，在使用的过程中，如果有任何问题，可以给我留言，如果有新的需求，也可以给我留言。

由于水平有限，难免会出现错误，如果发现后，还望能够告知一声。

上一篇下一篇

猜你喜欢

热点阅读