summaryrefslogtreecommitdiffhomepage
path: root/ios/MullvadVPN/REST/RESTNetworkOperation.swift
blob: bbdd27c18836f3be0a42cf2110b2f7270a3a4a99 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
//
//  NetworkOperation.swift
//  MullvadVPN
//
//  Created by pronebird on 08/12/2021.
//  Copyright © 2021 Mullvad VPN AB. All rights reserved.
//

import Foundation
import Logging

extension REST {

    enum RetryAction {
        /// Retry request using next endpoint.
        case useNextEndpoint

        /// Retry request using current endpoint.
        case useCurrentEndpoint

        /// Fail immediately.
        case failImmediately
    }

    class NetworkOperation<Success>: AsyncOperation {
        typealias CompletionHandler = (Result<Success, REST.Error>) -> Void
        typealias Generator = (AnyIPEndpoint, @escaping CompletionHandler) -> Result<URLSessionTask, REST.Error>

        private let networkTaskGenerator: Generator
        private let addressCacheStore: AddressCache.Store
        private var completionHandler: CompletionHandler?
        private var sessionTask: URLSessionTask?

        private let retryStrategy: RetryStrategy
        private var retryTimer: DispatchSourceTimer?
        private var retryCount = 0

        private let logger = Logger(label: "REST.NetworkOperation")
        private let loggerMetadata: Logger.Metadata = ["requestID": .string(UUID().uuidString)]

        init(networkTaskGenerator: @escaping Generator, addressCacheStore: AddressCache.Store, retryStrategy: RetryStrategy, completionHandler: @escaping CompletionHandler) {
            self.networkTaskGenerator = networkTaskGenerator
            self.addressCacheStore = addressCacheStore
            self.retryStrategy = retryStrategy
            self.completionHandler = completionHandler
        }

        override func cancel() {
            DispatchQueue.main.async {
                super.cancel()

                // Cancel pending retry
                self.retryTimer?.cancel()

                // Cancel active network task
                self.sessionTask?.cancel()
            }
        }

        override func main() {
            DispatchQueue.main.async {
                // Finish immediately if operation was cancelled before execution
                guard !self.isCancelled else {
                    self.finish(with: .failure(Self.cancellationError))
                    return
                }

                // Get current endpoint
                self.addressCacheStore.getCurrentEndpoint { endpoint in
                    DispatchQueue.main.async {
                        self.sendRequest(endpoint: endpoint) { [weak self] result in
                            self?.finish(with: result)
                        }
                    }
                }
            }
        }

        private func sendRequest(endpoint: AnyIPEndpoint, completionHandler: @escaping CompletionHandler) {
            // Handle operation cancellation
            guard !isCancelled else {
                completionHandler(.failure(Self.cancellationError))
                return
            }

            // Create network task and execute it
            let taskResult = networkTaskGenerator(endpoint) { [weak self] result in
                DispatchQueue.main.async {
                    self?.handleResponse(endpoint: endpoint, result: result, completionHandler: completionHandler)
                }
            }

            switch taskResult {
            case .success(let dataTask):
                logger.debug("Executing request using \(endpoint)", metadata: loggerMetadata)

                sessionTask = dataTask
                dataTask.resume()

            case .failure(let error):
                logger.error(chainedError: error, message: "Failed to create data task", metadata: loggerMetadata)

                completionHandler(.failure(error))
            }
        }

        private func handleResponse(endpoint: AnyIPEndpoint, result: Result<Success, REST.Error>, completionHandler: @escaping CompletionHandler) {
            guard case .failure(let error) = result else {
                completionHandler(result)
                return
            }

            logger.debug("Failed to perform request to \(endpoint)", metadata: self.loggerMetadata)

            switch Self.evaluateError(error) {
            case .useNextEndpoint:
                // Pick next endpoint in the event of network error
                addressCacheStore.selectNextEndpoint(endpoint) { nextEndpoint in
                    DispatchQueue.main.async {
                        self.retryRequest(endpoint: nextEndpoint, previousResult: result, completionHandler: completionHandler)
                    }
                }

            case .useCurrentEndpoint:
                // Retry request using the same endpoint otherwise
                retryRequest(endpoint: endpoint, previousResult: result, completionHandler: completionHandler)

            case .failImmediately:
                // Fail immediately in case of other errors, like server errors
                completionHandler(result)
            }
        }

        private func retryRequest(endpoint: AnyIPEndpoint, previousResult: Result<Success, REST.Error>, completionHandler: @escaping CompletionHandler) {
            // Handle operation cancellation
            guard !isCancelled else {
                completionHandler(.failure(Self.cancellationError))
                return
            }

            // Increment retry count
            retryCount += 1

            // Check if retry count is not exceeded.
            guard retryCount < retryStrategy.maxRetryCount else {
                logger.debug("Ran out of retry attempts (\(retryStrategy.maxRetryCount))", metadata: loggerMetadata)

                completionHandler(previousResult)
                return
            }

            // Retry immediatly if retry delay is set to .never
            guard retryStrategy.retryDelay != .never else {
                sendRequest(endpoint: endpoint, completionHandler: completionHandler)
                return
            }

            // Create timer to delay retry
            retryTimer = DispatchSource.makeTimerSource(queue: .main)

            retryTimer?.setEventHandler { [weak self] in
                self?.sendRequest(endpoint: endpoint, completionHandler: completionHandler)
            }

            retryTimer?.setCancelHandler {
                completionHandler(.failure(Self.cancellationError))
            }

            retryTimer?.schedule(wallDeadline: .now() + retryStrategy.retryDelay)
            retryTimer?.activate()
        }

        private func finish(with result: Result<Success, REST.Error>) {
            completionHandler?(result)
            completionHandler = nil

            finish()
        }

        private static func evaluateError(_ error: REST.Error) -> RetryAction {
            guard case .network(let networkError) = error else {
                return .failImmediately
            }

            switch networkError.code {
            case .cancelled:
                return .failImmediately

            case .notConnectedToInternet, .internationalRoamingOff, .callIsActive:
                return .useCurrentEndpoint

            default:
                return .useNextEndpoint
            }
        }

        private static var cancellationError: REST.Error {
            return .network(URLError(.cancelled))
        }
    }

}