[iOS] SwiftSafe:并发情况下的数据存取(线程保护)工具库

SwiftSafe Thread synchronization made easy :question:Why? Performance-sensitive classes need interna


Thread synchronization made easy.


Performance-sensitive classes need internal state synchronization, so that external accessors don't break the internal invariants and cause race conditions. Using GCD (Grand Central Dispatch) directly can confuse newcomers, because the API doesn't necessarily reflect the actual reason why it's being used. That's why wrapping it in a straighforward Swifty API can introduce a bit more clarity to your code. See examples below.

:watch:️Concurrency modes supported

  • EREW - Exclusive Read, Exclusive Write: The most common synchronization method, where only one thread can read or write your protected resource at one time. One big disadvantage is that it's prone to deadlocks.
  • CREW - Concurrent Read, Exclusive Write: Less common, but IMO more powerful method, where multiple threads can read, but only one thread can write at one time. Reading and writing is automatically made exclusive, i.e. all reads enqueued before a write are executed first, then the single write is executed, then more reads can be executed (those enqueued after the write).


  • iOS 8.0+
  • Swift 3.0+



github "nodes-ios/SwiftSafe" ~> 2.0

For Swift 2.2 release:

github "nodes-ios/SwiftSafe" ~> 1.0


pod 'SwiftSafe'


Let's say you're writing a thread-safe NSDatacache. You'd like it to use CREW access to maximize performance.

class MyCache { private let storage: NSMutableDictionary = NSMutableDictionary() public func hit(key: String) -> NSData? { let found = self.storage[key] if let found = found { print("Hit for key /(key) -> /(found)") } else { print("Miss for key /(key)") } return found } public func update(key: String, value: NSData) { print("Updating /(key) -> /(value)") self.storage[key] = value }}

This is the first implementation. It works, but when you start calling it from multiple threads at the same time, you'll encounter inconsistencies and race conditions - meaning you'll be getting different results with the same sequence of actions. In more complicated cases, you might even cause a runtime crash.

The way you fix it is obviously by protecting the internal storage(note: NSDictionaryis not thread-safe). Again, to be most efficient, we want to allow any number of threads reading from the cache, but only one to update it (and ensure that nobody is reading from it at that time). You can achieve these guarantees with GCD, which is what SwiftSafedoes. What this API brings to the table, however, is the simple and obvious naming.

Let's see how we can make our cache thread-safe in a couple lines of code.

import SwiftSafeclass MyCache { private let storage: NSMutableDictionary = NSMutableDictionary() private let safe: Safe = CREW() public func hit(key: String) -> NSData? { var found: NSData? safe.read { found = self.storage[key] if let found = found { print("Hit for key /(key) -> /(found)") } else { print("Miss for key /(key)") } } return found } public func update(key: String, value: NSData) { safe.write { print("Updating /(key) -> /(value)") self.storage[key] = value } }}

That's it! Just import the library, create a Safeobject which follows the concurrency mode you're trying to achieve (CREW in this case) and wrap your accesses to the shared resource in readand writecalls. Note that readclosures always blockthe caller thread, whereas writedon't. If you ever have a call which both updates your resource and reads from it, make sure to split that functionality into the writingand readingpart. This will make it much easier to reason about and parallelize.

:point_right:Bottom line

Even though it might sound unnecessary to some, understandable and correct methods of synchronization will save you days of debugging and many headaches. :)

:blue_heart:Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.




Honza Dvorsky - http://honzadvorsky.com, @czechboy0