这是小专栏《彻底搞定 GCD🚦并发编程》的一篇副产品文章
简介
Repeat 是 Daniele 开发的一个基于 GCD - Grand Central Dispatch 的轻量定时器，可用于替代 NSTimer，解决其多项不足。
特性
Daniel 着重强调的一些特性：
- 接口简洁明了不冗余
- 避免强引用，解决潜在的内存泄露问题
- 支持注册多个观察者对象监听定时器
- 支持暂停、开始、恢复、重置等操作
- 支持设置多种重复模式
- infinite：无限定时重复
- finite：有限次定时重复
- once：单次定时执行
针对以上特性，我们接下来阅读源码时可以着重看看 Daniel 是怎样实现的。
另外，这个库还扩展提供了两个有趣的特性：
- Debouncer: 防抖动，避免方法调用过于密集，总是执行每隔一定时间段内最后一个调用。
- Throttler: 节流阀，确保每隔一定时间段内仅执行一次，并忽略其他调用。
这两个特性对于用过 RxSwift 的开发者肯定不陌生，有了定时器，实现这两者也是顺理成章。
接口的设计、使用与实现
首先，从接口的设计来看看其是否「简洁明了」、「不冗余」，再逐步深入其内部实现。
定时器
注意：
Repeater被设计成和其他许多对象一样，需要被持有来避免被释放。
创建单次定时器
- 接口设计与调用
// 创建单次执行定时器
log("当时只道是寻常")
self.timer = Repeater.once(after: .seconds(5)) { timer in
// 5s 后运行
log("岁月如歌,简单爱一次")
}
输出：
2019-10-14 15:12:04 +0000: 当时只道是寻常
2019-10-14 15:12:09 +0000: 岁月如歌,简单爱一次
- 单元测试设计
func test_timer_once() {
let exp = expectation(description: "test_once")
let timer = Repeater.once(after: .seconds(5)) { _ in
exp.fulfill()
}
print("Allocated timer \(timer)")
wait(for: [exp], timeout: 6)
}
创建有限次重复的定时器
- 接口设计与调用
log("当时只道是寻常")
self.timer = Repeater.every(.seconds(10), count: 5) { timer in
// 每 10s 运行 1 次，5 次后结束
log("岁月如歌,简单爱一次")
}
输出：
2019-10-14 15:18:56 +0000: 当时只道是寻常
2019-10-14 15:19:06 +0000: 岁月如歌,简单爱一次
2019-10-14 15:19:16 +0000: 岁月如歌,简单爱一次
2019-10-14 15:19:26 +0000: 岁月如歌,简单爱一次
2019-10-14 15:19:36 +0000: 岁月如歌,简单爱一次
2019-10-14 15:19:46 +0000: 岁月如歌,简单爱一次
- 单元测试设计
func test_timer_finiteAndRestart() {
let exp = expectation(description: "test_finiteAndRestart")
var count: Int = 0
var finishedFirstTime: Bool = false
let timer = Repeater(interval: .seconds(0.5), mode: .finite(5)) { _ in
count += 1
print("Iteration #\(count)")
}
timer.onStateChanged = { (_, state) in
print("State changed: \(state)")
if state.isFinished {
if finishedFirstTime == false {
print("Now restart")
timer.start()
finishedFirstTime = true
} else {
exp.fulfill()
}
}
}
timer.start()
wait(for: [exp], timeout: 30)
}
单元测试输出：
State changed: running
State changed: executing
Iteration #1
State changed: executing
Iteration #2
State changed: executing
Iteration #3
State changed: executing
Iteration #4
State changed: executing
Iteration #5
State changed: finished
Now restart
State changed: idle/paused
State changed: running
State changed: executing
Iteration #6
State changed: executing
Iteration #7
State changed: executing
Iteration #8
State changed: executing
Iteration #9
State changed: executing
Iteration #10
State changed: finished
可以看到，有限次的定时器在次数达到结束后，还可以继续调用 start() 重新开始再次复用，而不必另外创建新实例。
创建无限重复定时器
- 接口设计与调用
log("当时只道是寻常")
let timer = Repeater.every(.seconds(5)) { timer in
// 每 5s 运行一次，直到 timer 生命周期结束
log("岁月如歌,简单爱一次")
}
输出：
2019-10-14 15:24:05 +0000: 当时只道是寻常
2019-10-14 15:24:10 +0000: 岁月如歌,简单爱一次
2019-10-14 15:24:15 +0000: 岁月如歌,简单爱一次
2019-10-14 15:24:20 +0000: 岁月如歌,简单爱一次
2019-10-14 15:24:25 +0000: 岁月如歌,简单爱一次
2019-10-14 15:24:30 +0000: 岁月如歌,简单爱一次
2019-10-14 15:24:35 +0000: 岁月如歌,简单爱一次
2019-10-14 15:24:40 +0000: 岁月如歌,简单爱一次
2019-10-14 15:24:45 +0000: 岁月如歌,简单爱一次
...
- 单元测试设计
func test_timer_infinite() {
let exp = expectation(description: "test_once")
var count: Int = 0
let timer = Repeater.every(.seconds(0.5), { _ in
count += 1
if count == 20 {
exp.fulfill()
}
})
print("Allocated timer \(timer)")
wait(for: [exp], timeout: 10)
}
手动管理计时器
- 接口设计与调用
log("当时只道是寻常")
self.timer = Repeater(interval: .seconds(5), mode: .infinite) { _ in
// 每 5s 运行一次，直到 timer 生命周期结束
log("岁月如歌,简单爱一次")
}
timer.start()
输出：
2019-10-14 23:13:46 +0000: 当时只道是寻常
2019-10-14 23:13:51 +0000: 岁月如歌,简单爱一次
2019-10-14 23:13:56 +0000: 岁月如歌,简单爱一次
2019-10-14 23:14:01 +0000: 岁月如歌,简单爱一次
2019-10-14 23:14:06 +0000: 岁月如歌,简单爱一次
2019-10-14 23:14:11 +0000: 岁月如歌,简单爱一次
2019-10-14 23:14:16 +0000: 岁月如歌,简单爱一次
2019-10-14 23:14:21 +0000: 岁月如歌,简单爱一次
2019-10-14 23:14:26 +0000: 岁月如歌,简单爱一次
...
其他方法：
start(): 开始一个已暂停或新创建的定时器pause()：暂停一个正在运行的定时器reset(_ interval: Interval, restart: Bool)：重置一个正在运行的定时器，更改时间间隔并重新开始fire()：额外手动调用一次定时器绑定事件
属性：
.mode：定时器类型模式infinite：无限定时重复finite：有限次定时重复once：单次定时执行
.remainingIterations：针对.finite有限次重复模式结束前的剩余迭代次数
添加或移除多个定时处理
一般而言，初始化定时器时会指定一个处理方法。除此之外， Repeat 的定时器还支持通过observe()额外添加处理方法，并且支持通过token再移除。
// 添加额外的处理监听
let token = timber.observe { _ in
// 额外的新处理
log("一个闹钟能够同时叫醒相爱的两个人。")
}
timer.start()
// 移除
timer.remove(token)
观察定时器的状态变化
每个定时器维护着一个状态机，处在以下某个状态：
.paused：空闲（未被开始过）或已暂停.running：正在计时中.executing：注册的定时处理方法正在执行.finished：计时结束
可以通过.onStateChanged属性添加状态变化回调监听：
timer.onStateChanged = { timer, newState in
// 观察定时器状态变化并做相应处理
log("你永远叫不醒一个装睡的人")
}
防抖动器
TBD
节流阀
TBD
源码探究
接下来，进一步看看以上的接口都是如何实现的吧。
文件目录结构
.
├── CHANGELOG.md
├── Configs
│ ├── Repeat.plist
│ └── RepeatTests.plist
├── LICENSE
├── Package.swift
├── README.md
├── Repeat.podspec
├── Repeat.xcodeproj
├── Sources
│ └── Repeat
│ ├── Debouncer.swift
│ ├── Repeater.swift
│ └── Throttler.swift
└── Tests
├── LinuxMain.swift
└── RepeatTests
└── RepeatTests.swift
主要文件：
- Sources/Repeat/Repeater.swift： 核心定时器实现
- Sources/Repeat/Debouncer.swift： 扩展「防抖动器」实现
- Sources/Repeat/Throttler.swift： 扩展「节流阀」实现
- Tests/RepeatTests/RepeatTests.swift： 单元测试
类图与方法概览
工厂类方法实现以及与 Timer 的异同
在接口设计与使用中可以看到，Repeater 提供了便捷工厂类方法，并且生成的定时器都会「自动开始」，与 Timer 的工厂类方法相似：
/// Alternative API for timer creation with a block.
/// - Experiment: This is a draft API currently under consideration for official import into Foundation as a suitable alternative to creation via selector
/// - Note: Since this API is under consideration it may be either removed or revised in the near future
/// - Warning: Capturing the timer or the owner of the timer inside of the block may cause retain cycles. Use with caution
open class func scheduledTimer(withTimeInterval interval: TimeInterval,
repeats: Bool,
block: @escaping (Timer) -> Void) -> Timer {
let timer = Timer(fire: Date(timeIntervalSinceNow: interval), interval: interval, repeats: repeats, block: block)
CFRunLoopAddTimer(CFRunLoopGetCurrent(), timer._timer!, kCFRunLoopDefaultMode)
return timer
}
👆Tips & Declaration： Timer.swift，注释中有特别提醒注意循环引用的问题。
对比一下 Repeater 的类工厂方法实现：
/// Create and schedule a timer that will call `handler` once after the specified time.
///
/// - Parameters:
/// - interval: interval delay for single fire
/// - queue: destination queue, if `nil` a new `DispatchQueue` is created automatically.
/// - observer: handler to call when timer fires.
/// - Returns: timer instance
@discardableResult
public class func once(after interval: Interval,
tolerance: DispatchTimeInterval = .nanoseconds(0),
queue: DispatchQueue? = nil,
_ observer: @escaping Observer) -> Repeater {
let timer = Repeater(interval: interval, mode: .once, tolerance: tolerance, queue: queue, observer: observer)
timer.start()
return timer
}
/// Create and schedule a timer that will fire every interval optionally by limiting the number of fires.
///
/// - Parameters:
/// - interval: interval of fire
/// - count: a non `nil` and > 0 value to limit the number of fire, `nil` to set it as infinite.
/// - queue: destination queue, if `nil` a new `DispatchQueue` is created automatically.
/// - handler: handler to call on fire
/// - Returns: timer
@discardableResult
public class func every(_ interval: Interval,
count: Int? = nil,
tolerance: DispatchTimeInterval = .nanoseconds(0),
queue: DispatchQueue? = nil,
_ handler: @escaping Observer) -> Repeater {
let mode: Mode = (count != nil ? .finite(count!) : .infinite)
let timer = Repeater(interval: interval, mode: mode, tolerance: tolerance, queue: queue, observer: handler)
timer.start()
return timer
}
两者的做法大相径庭，都是创建一个定时器实例并「自动开始」，只是开始的方式由于内部固有的实现方式有所不同：
Timer依赖RunLoop，需要将创建定时器生成的CFRunLoopTimer加入当前RunloopRepeater依赖 GCD 的DispatchSourceTimer，start内部会调DispatchSourceTimer的 实例方法resume
初始化方法
/// Initialize a new timer.
///
/// - Parameters:
/// - interval: interval of the timer
/// - mode: mode of the timer
/// - tolerance: tolerance of the timer, 0 is default.
/// - queue: queue in which the timer should be executed; if `nil` a new queue is created automatically.
/// - observer: observer
public init(interval: Interval, mode: Mode = .infinite, tolerance: DispatchTimeInterval = .nanoseconds(0), queue: DispatchQueue? = nil, observer: @escaping Observer) {
self.mode = mode
self.interval = interval
self.tolerance = tolerance
self.remainingIterations = mode.countIterations
self.queue = (queue ?? DispatchQueue(label: "com.repeat.queue"))
self.timer = configureTimer()
self.observe(observer)
}
初始化方法参数列表：
interval：定时器时间间隔mode：定时器重复模式，默认为.infinite，无限重复tolerance：容许误差（这个最终是作为DispatchSourceTimer的leeway参数）queue：指定定时器运行的队列，若未指定，则自动创建默认队列observer：定时器运行的回调方法
创建并配置 DispatchSourceTimer
private func configureTimer() -> DispatchSourceTimer {
let associatedQueue = (queue ?? DispatchQueue(label: "com.repeat.\(NSUUID().uuidString)"))
let timer = DispatchSource.makeTimerSource(queue: associatedQueue)
let repeatInterval = interval.value
let deadline: DispatchTime = (DispatchTime.now() + repeatInterval)
if self.mode.isRepeating {
timer.schedule(deadline: deadline, repeating: repeatInterval, leeway: tolerance)
} else {
timer.schedule(deadline: deadline, leeway: tolerance)
}
timer.setEventHandler { [weak self] in
if let unwrapped = self {
unwrapped.timeFired()
}
}
return timer
}
- 根据初始化传入的参数，初始化并配置一个 DispatchSourceTimer
- 将 DispatchSourceTimer 的处理回调通过
timeFired方法处理
这一段代码是 Repeat 中 GCD 的应用关键，Repeat 的核心计时器即是 DispatchSourceTimer，进一步封装并屏蔽部分复杂逻辑，以提供简洁易用的接口。
计时器启动、暂停与重置
/// Reset the state of the timer, optionally changing the fire interval.
///
/// - Parameters:
/// - interval: new fire interval; pass `nil` to keep the latest interval set.
/// - restart: `true` to automatically restart the timer, `false` to keep it stopped after configuration.
public func reset(_ interval: Interval?, restart: Bool = true) {
if self.state.isRunning {
self.setPause(from: self.state)
}
// For finite counter we want to also reset the repeat count
if case .finite(let count) = self.mode {
self.remainingIterations = count
}
// Create a new instance of timer configured
if let newInterval = interval {
self.interval = newInterval
} // update interval
self.destroyTimer()
self.timer = configureTimer()
self.state = .paused
if restart {
self.timer?.resume()
self.state = .running
}
}
/// Start timer. If timer is already running it does nothing.
@discardableResult
public func start() -> Bool {
guard self.state.isRunning == false else {
return false
}
// If timer has not finished its lifetime we want simply
// restart it from the current state.
guard self.state.isFinished == true else {
self.state = .running
self.timer?.resume()
return true
}
// Otherwise we need to reset the state based upon the mode
// and start it again.
self.reset(nil, restart: true)
return true
}
/// Pause a running timer. If timer is paused it does nothing.
@discardableResult
public func pause() -> Bool {
guard state != .paused && state != .finished else {
return false
}
return self.setPause(from: self.state)
}
/// Pause a running timer optionally changing the state with regard to the current state.
///
/// - Parameters:
/// - from: the state which the timer should only be paused if it is the current state
/// - to: the new state to change to if the timer is paused
/// - Returns: `true` if timer is paused
@discardableResult
private func setPause(from currentState: State, to newState: State = .paused) -> Bool {
guard self.state == currentState else {
return false
}
self.timer?.suspend()
self.state = newState
return true
}
start方法主要是做状态判断并进行相应处理返回结果，其开始计时的核心是调用内部DispatchSourceTimer的resume方法pause方法类似，调用的是suspend方法，并更新内部计时器状态reset重置内部的一些计时标志位的同时，会将内部的DispatchSourceTimer销毁并新建
添加或移除多个定时观察者
/// List of the observer of the timer
private var observers = [ObserverToken: Observer]()
/// Next token of the timer
private var nextObserverID: UInt64 = 0
/// Add new a listener to the timer.
///
/// - Parameter callback: callback to call for fire events.
/// - Returns: token used to remove the handler
@discardableResult
public func observe(_ observer: @escaping Observer) -> ObserverToken {
var (new, overflow) = self.nextObserverID.addingReportingOverflow(1)
if overflow { // you need to add an incredible number of offset...sure you can't
self.nextObserverID = 0
new = 0
}
self.nextObserverID = new
self.observers[new] = observer
return new
}
/// Remove an observer of the timer.
///
/// - Parameter id: id of the observer to remove
public func remove(observer identifier: ObserverToken) {
self.observers.removeValue(forKey: identifier)
}
- 通过字典储存观察者回调事件，通过 UInt64 的 ObserverToken 来进行标识
- 观察者数量上限控制在 UInt64 的溢出范围
定时事件触发
/// Called when timer is fired
private func timeFired() {
self.state = .executing
if case .finite = self.mode {
self.remainingIterations! -= 1
}
// dispatch to observers
self.observers.values.forEach { $0(self) }
// manage lifetime
switch self.mode {
case .once:
// once timer's lifetime is finished after the first fire
// you can reset it by calling `reset()` function.
self.setPause(from: .executing, to: .finished)
case .finite:
// for finite intervals we decrement the left iterations count...
if self.remainingIterations! == 0 {
// ...if left count is zero we just pause the timer and stop
self.setPause(from: .executing, to: .finished)
}
case .infinite:
// infinite timer does nothing special on the state machine
break
}
}
timeFired方法被两个地方调用，一个是配置DispatchSourceTimer时设置的事件回调，一个是对外暴露的手动触发方法fire(andPause:)中- 根据计时模式更新计时器状态，计时模式的实现核心逻辑即在于此
- 遍历所有观察者逐个回调，触发真正的计时器绑定事件
总结
致谢与参考
文中涉及源码大部分来自开源社区，以及部分其他文献参考。
-
Repeat by Daniele Margutti, under The MIT License (MIT)
-
swift-corelibs-foundation Licensed under Apache License v2.0 with Runtime Library Exception
-
A Background Repeating Timer in Swift by Daniel Galasko
