iOS 文件下载Download,支持断点续传、后台下载、设置下载并发数

Download.gif
下载功能的实现:

使用的网络连接的类为URLSession,在初始化URLSession前,需要先创建URLSessionConfiguration,可以理解为是URLSession需要的一个配置。URLSessionConfiguration有三种模式:

  1. default:可以使用缓存的Cache、Cookie、鉴权。
  2. ephemeral,仅内存缓存,不使用缓存的Cache、Cookie、鉴权。
  3. background,支持后台传输,需要一个identifier标识,用来重新连接session对象。

创建URLSession,设置配信息、代理、代理线程:

private lazy var session: URLSession = {
     let configuration = URLSessionConfiguration.background(withIdentifier: "DownloadBackgroundSessionIdentifier")
     let queue = OperationQueue()
     queue.maxConcurrentOperationCount = 1
     let session = URLSession(configuration: configuration, delegate: self, delegateQueue: queue)
     return session
}()

在实现下载前,还需要了解一个很重要的类,URLSessionTask,无论下载多少文件,我们只需要初始化一个URLSession即可,而每个task对应一个任务,需要通过task才能实现下载,URLSessionTask是一个基类,有四个子类:

1、URLSessionDataTask:下载时,内容以Data对象返回,需要我们不断写入文件

2、URLSessionUploadTask:继承自URLSessionDataTask,内容以Data对象返回,协议方法中可以查看请求时上传内容的过程

3、URLSessionStreamTask::建立了一个TCP/IP连接,替代InputStream/OutputStream,新的API可异步读写,自动通过HTTP代理连接远程服务器

4、URLSessionDownloadTask:资源会下载到一个临时文件,下载完成需将文件移动至想要的路径,系统会删除临时路劲文件,暂停时,系统会返回NSData对象,恢复下载时用这个data创建task

Download 是通过URLSessionDataTask进行下载的,核心代码:

// 创建流
let stream = OutputStream(toFileAtPath: path(url: url), append: true)
// 创建请求
var request = URLRequest(url: URL(string: url)!)
// 忽略本地缓存,代理服务器以及其他中介,直接请求源服务端
request.cachePolicy = .reloadIgnoringLocalAndRemoteCacheData
// 设置请求头
request.setValue("bytes=\(getDownloadSize(url: url))-", forHTTPHeaderField: "Range")
// 创建一个Data任务
let task = session.dataTask(with: request)
let taskIdentifier = arc4random() % ((arc4random() % 10000 + arc4random() % 10000))
task.setValue(taskIdentifier, forKey: "taskIdentifier")
// 开启下载
task.resume()

/// URLSessionDataDelegate
/// 接收到响应
func urlSession(_ session: URLSession, dataTask: URLSessionDataTask, didReceive response: URLResponse, completionHandler: @escaping (URLSession.ResponseDisposition) -> Void) {
      guard let model = sessionModels["\(dataTask.taskIdentifier)"],
            let stream = model.stream,
            let url = model.model.url else { return }
        
      // 打开流
      stream.open()
      // 接收这个请求,允许接收服务器的数据
      completionHandler(.allow)
}

/// 接收到服务器返回的数据,会被调用多次
func urlSession(_ session: URLSession, dataTask: URLSessionDataTask, didReceive data: Data) {
      guard let model = sessionModels["\(dataTask.taskIdentifier)"],
            let stream = model.stream,
            let url = model.model.url else { return }

      let bytes = [UInt8](data)
      // 写入数据
      stream.write(UnsafePointer<UInt8>(bytes), maxLength: data.count)
      // 已下载大小
      let receivedSize = getDownloadSize(url: url)
      // 总大小 
      let expectedSize = model.model.totalLength
      // 下载进度
      let progress: Double = Double(receivedSize) / Double(expectedSize)
}

/// URLSessionTaskDelegate
// 当请求完成之后调用,如果错误,那么error有值
func urlSession(_ session: URLSession, task: URLSessionTask, didCompleteWithError error: Error?) {
        
      guard let model = sessionModels["\(task.taskIdentifier)"],
            let url = model.model.url,
            url.dw_isURL else { return }
        
      if let error = error {
            debugPrint("下载失败")
      } else {
            debugPrint("下载完成")
      }
        
      // 关闭流
      model.stream?.close()
      model.stream = nil
}

/// URLSessionDelegate
/// 应用处于后台,所有下载任务完成及URLSession协议调用之后调用
func urlSessionDidFinishEvents(forBackgroundURLSession session: URLSession) {}

Download API:
/// 设置下载并发数, 默认3
DownloadManager.default.maxDownloadCount = 3
/// 开启下载
func download(model: DownloadModel)
/// 判断该文件是否下载完成
func isCompletion(url: String) -> Bool
/// 判断该文件是否存在
func isExistence(url: String) -> Bool
/// 根据url取消/暂停任务
func cancelTask(url: String)
/// 取消/暂停所有任务
func cancelAllTask()
/// 根据url删除资源
func deleteFile(url: String)
/// 清空所有下载资源
func deleteAllFile()
/// 获取下载的数据
func getDownloadModels() -> [DownloadModel]
/// 获取下载完成的数据
func getDownloadFinishModels() -> [DownloadModel]
/// 获取未下载完成的数据
func getDownloadingModel() -> [DownloadModel]
/// 将未完成的下载状态改为.suspended
func updateDownloadingStateWithSuspended()
/// 开启未完成的下载
func updateDownloading()
/// 获取下载完成的文件路径
func getFile(url: String) -> String
/// 获取总缓存大小 单位:字节
func getCacheSize() -> Double
使用:见demo

Demo地址: Download

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,088评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,715评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,361评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,099评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,987评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,063评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,486评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,175评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,440评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,190评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,550评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2 335

推荐阅读更多精彩内容