A Protocol-Oriented NotificationCenter which is type safe, thread safe and with memory safety.
-
Type Safe
No more
userInfodictionary and Downcasting, just deliver the concrete type value to the observer. -
Thread Safe
You can
register,notify,unregisterin any thread without crash and data corruption. -
Memory Safety
SwiftNotificationCenterstore the observer as a zeroing-weak reference. No crash and no need tounregistermanually.
It's simple, safe, lightweight and easy to use for one-to-many communication.
Usage
Define protocol and observer:
protocol Update {
func updateTitle(title: String)
}
extension ViewController: Update {
func updateTitle(title: String) {
self.titleLabel.text = title
}
}
let vc = ViewController()
Register:
Broadcaster.register(Update.self, observer: vc)
Broadcast:
Broadcaster.notify(Update.self) {
$0.updateTitle("new title")
}
Unregister:
Broadcaster.unregister(Update.self, observer: self)
Compare with NSNotificationCenter :
For example, handle UIKeyboardWillShowNotification
@objc func handleKeyboardNotification(notification: NSNotification) {
guard notification.name == NSNotification.Name.UIKeyboardWillShow
else { return }
guard let beginFrame = (notification
.userInfo?[UIKeyboardFrameBeginUserInfoKey] as? NSValue)?.cgRectValue
else { return }
guard let endFrame = (notification
.userInfo?[UIKeyboardFrameEndUserInfoKey] as? NSValue)?.cgRectValue
else { return }
// use beginFrame, endFrame
}
SwiftNotificationCenter way:
/*
If you want to observe the system built in notifications like this.
You can declare a protocol and the relevant method, and use a singleton as a mediator to observe system's notification, then notify our observers.
Please check the refactor example in SwiftNotificationCenterExample Project.
*/
func UIKeyboardWillShow(beginFrame: CGRect, endFrame: CGRect) {
}
Installation
CocoaPods:
pod 'SwiftNotificationCenter'
Carthage:
github "100mango/SwiftNotificationCenter"
Manually:
Just copy source files in the SwiftNotificationCenter folder into your project.
License
SwiftNotificationCenter is under the MIT license.
82 Apr 4, 2021
759 Dec 2, 2022
1.9k Dec 20, 2022
111 Dec 27, 2022
3.7k Dec 24, 2022
60 Aug 11, 2022
17 Apr 5, 2019
31 Dec 11, 2022
74 Nov 24, 2022
93 Dec 6, 2022
708 Jun 29, 2022
2 Mar 10, 2022
1.9k Dec 30, 2022
71 Aug 6, 2022
814 Oct 30, 2022
68 Jan 7, 2023
631 Dec 26, 2022