|
|
@@ -0,0 +1,111 @@
|
|
|
+// Timeline.swift
|
|
|
+//
|
|
|
+// Copyright (c) 2014–2016 Alamofire Software Foundation (http://alamofire.org/)
|
|
|
+//
|
|
|
+// Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
|
+// of this software and associated documentation files (the "Software"), to deal
|
|
|
+// in the Software without restriction, including without limitation the rights
|
|
|
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
|
+// copies of the Software, and to permit persons to whom the Software is
|
|
|
+// furnished to do so, subject to the following conditions:
|
|
|
+//
|
|
|
+// The above copyright notice and this permission notice shall be included in
|
|
|
+// all copies or substantial portions of the Software.
|
|
|
+//
|
|
|
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
|
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
|
+// THE SOFTWARE.
|
|
|
+
|
|
|
+import Foundation
|
|
|
+
|
|
|
+/// Responsible for computing the timing metrics for the complete lifecycle of a `Request`.
|
|
|
+public struct Timeline {
|
|
|
+ /// The time the request was initialized.
|
|
|
+ public let requestStartTime: CFAbsoluteTime
|
|
|
+
|
|
|
+ /// The time the first bytes were received from or sent to the server.
|
|
|
+ public let initialResponseTime: CFAbsoluteTime
|
|
|
+
|
|
|
+ /// The time when the request was completed.
|
|
|
+ public let requestCompletedTime: CFAbsoluteTime
|
|
|
+
|
|
|
+ /// The time when the response serialization was completed.
|
|
|
+ public let serializationCompletedTime: CFAbsoluteTime
|
|
|
+
|
|
|
+ /// The time interval in seconds from the time the request started to the initial response from the server.
|
|
|
+ public let latency: NSTimeInterval
|
|
|
+
|
|
|
+ /// The time interval in seconds from the time the request started to the time the request completed.
|
|
|
+ public let requestDuration: NSTimeInterval
|
|
|
+
|
|
|
+ /// The time interval in seconds from the time the request completed to the time response serialization completed.
|
|
|
+ public let serializationDuration: NSTimeInterval
|
|
|
+
|
|
|
+ /// The time interval in seconds from the time the request started to the time response serialization completed.
|
|
|
+ public let totalDuration: NSTimeInterval
|
|
|
+
|
|
|
+ init(
|
|
|
+ requestStartTime: CFAbsoluteTime,
|
|
|
+ initialResponseTime: CFAbsoluteTime,
|
|
|
+ requestCompletedTime: CFAbsoluteTime,
|
|
|
+ serializationCompletedTime: CFAbsoluteTime)
|
|
|
+ {
|
|
|
+ self.requestStartTime = requestStartTime
|
|
|
+ self.initialResponseTime = initialResponseTime
|
|
|
+ self.requestCompletedTime = requestCompletedTime
|
|
|
+ self.serializationCompletedTime = serializationCompletedTime
|
|
|
+
|
|
|
+ self.latency = initialResponseTime - requestStartTime
|
|
|
+ self.requestDuration = requestCompletedTime - requestStartTime
|
|
|
+ self.serializationDuration = serializationCompletedTime - requestCompletedTime
|
|
|
+ self.totalDuration = serializationCompletedTime - requestStartTime
|
|
|
+ }
|
|
|
+}
|
|
|
+
|
|
|
+// MARK: - CustomStringConvertible
|
|
|
+
|
|
|
+extension Timeline: CustomStringConvertible {
|
|
|
+ /// The textual representation used when written to an output stream, which includes the latency, the request
|
|
|
+ /// duration and the total duration.
|
|
|
+ public var description: String {
|
|
|
+ let latency = String(format: "%.3f", self.latency)
|
|
|
+ let requestDuration = String(format: "%.3f", self.requestDuration)
|
|
|
+ let serializationDuration = String(format: "%.3f", self.serializationDuration)
|
|
|
+ let totalDuration = String(format: "%.3f", self.totalDuration)
|
|
|
+
|
|
|
+ let timings = [
|
|
|
+ "\"Latency\": \(latency) secs",
|
|
|
+ "\"Request Duration\": \(requestDuration) secs",
|
|
|
+ "\"Serialization Duration\": \(serializationDuration) secs",
|
|
|
+ "\"Total Duration\": \(totalDuration) secs"
|
|
|
+ ]
|
|
|
+
|
|
|
+ return "Timeline: { \(timings.joinWithSeparator(", ")) }"
|
|
|
+ }
|
|
|
+}
|
|
|
+
|
|
|
+// MARK: - CustomDebugStringConvertible
|
|
|
+
|
|
|
+extension Timeline: CustomDebugStringConvertible {
|
|
|
+ /// The textual representation used when written to an output stream, which includes the request start time, the
|
|
|
+ /// initial response time, the request completed time, the serialization completed time, the latency, the request
|
|
|
+ /// duration and the total duration.
|
|
|
+ public var debugDescription: String {
|
|
|
+ let timings = [
|
|
|
+ "\"Request Start Time\": \(requestStartTime)",
|
|
|
+ "\"Initial Response Time\": \(initialResponseTime)",
|
|
|
+ "\"Request Completed Time\": \(requestCompletedTime)",
|
|
|
+ "\"Serialization Completed Time\": \(serializationCompletedTime)",
|
|
|
+ "\"Latency\": \(latency) secs",
|
|
|
+ "\"Request Duration\": \(requestDuration) secs",
|
|
|
+ "\"Serialization Duration\": \(serializationDuration) secs",
|
|
|
+ "\"Total Duration\": \(totalDuration) secs"
|
|
|
+ ]
|
|
|
+
|
|
|
+ return "Timeline: { \(timings.joinWithSeparator(", ")) }"
|
|
|
+ }
|
|
|
+}
|
Christian Noon