Нативная разработка мобильных приложений

Приостановка и возобновление
Обновления прогресса в процессе длительной загрузки – не единственное, что 
может понадобиться вашим пользователям. Возможно, в какой-то момент за
-

---

iOS 

169
грузка может потерпеть неудачу. Или, может быть, пользователь решит при
-
остановить загрузку, чтобы переключиться на сеть Wi-Fi, и затем возобновить 
ее. В любом случае, приостановка и возобновление 
URLSession
возможны, но 
выглядит эта процедура немного странно.
Давайте сначала рассмотрим пример, а затем обсудим его:
class PauseableClient: NSObject {
let url = URL(string: "https://www.example.com/file.zip")!
var resumeData: Data?
func startDownload() ­> URLSessionDownloadTask? {
let task = URLSession.shared.downloadTask(with: url)
task.resume()
return task
}
func pauseDownload(for task: URLSessionDownloadTask?) {
guard let task = task else { return }
task.cancel { (resumeData) in
self.resumeData = resumeData
}
}
func resumeDownload() ­> URLSessionDownloadTask? {
guard let resumeData = resumeData else {
print("Download can't be resumed!")
return nil
}
let task = URLSession.shared.downloadTask(withResumeData: resumeData)
task.resume()
return task
}
}
let client = PauseableClient()
var task = client.startDownload()
client.pauseDownload(for: task)
task = client.resumeDownload()
В этом примере определяется класс 
PauseableClient
с тремя методами: 
start­
Download()
, 
pauseDownload()
и 
resumeDownload()
. Метод 
startDownload()
запускает 
задание загрузки предположительно большого файла. Он возвращает объект 
задания 
task
, который будет использоваться позже. Далее мы вызываем 
start­
Download()
и тут же вызываем метод 
pauseDownload(for:)
, которому передаем за
-
дание.
Внутри 
pauseDownload()
мы вызываем метод 
cancel(byProroductionResumeDa
ta:)
полученного задания и передаем ему замыкание в единственном ар
-
гументе. Сразу после отмены задания вызывается наше замыкание, и ему 
передается токен – экземпляр 
Data
, – который затем используется для возоб-
новления загрузки. Сохранение этого токена позволяет в будущем возобно
-
вить загрузку.

---

170

Сетевые взаимодействия
Данные для возобновления можно также сохранить в методе делегата 
urlSession(
_:task:didCompleteWithError:)
, который вызывается в случае появления ошибки на 
стороне клиента, и проверить 
userInfo[NSURLSessionDownloadTaskResumeData]
на на
-
личие ошибки в параметре 
error
. Также следует отметить, что существуют опреде
-
ленные ограничения, касающиеся генерирования данных для возобновления. За 
дополнительной информацией о них обращайтесь к документации разработчика 
Apple с описанием 
URLSessionTask
(
https://o
reil.ly/GITHH).
На самом деле задание, созданное для загрузки файла, на этом этапе ис
-
чезнет. Вызов 
cancel
в действительности не приостанавливает загрузку, а 
от
-
меняет
ее. Тем не менее этот запрос можно вернуть к жизни без повторной 
загрузки уже загруженных данных.
Это делается в нашем примере с помощью метода 
resumeDownload()
, кото
-
рый проверяет данные для возобновления и затем вызывает 
URLSession
, что
-
бы создать новый экземпляр 
URLSessionDownloadTask
вызовом метода 
download­
Task(withResumeData:)
. Данные для возобновления – это тот же экземпляр 
resu me Data
, который был сохранен в 
pauseDownload(for:)
при отмене предыдуще
-
го задания.
Наконец, после создания нового задания вызывается метод 
resume()
, чтобы 
продолжить загрузку с той же точки, на которой она была прервана раньше.