通过Notification.Name看Swift是如何优雅的解决String硬编码

时间:2021-10-01 14:01:06

前面

初学 Swift 中相关 NSNotification 的代码时, 发现了之前熟悉的 name 参数的类型由 Objective-C 中的 NSString 变成了 Notification.Name 类型. 并不是我期望的 String 类型...这是怎么回事呢?

Swift 中如何使用 Notification

那么, 在 Swift 中如何使用 Notification 呢, 以 post 为例.

?
1
NotificationCenter.default.post(name: Notification.Name.UIApplicationDidFinishLaunching, object: nil)

其中, Notification.Name 是可以省略的, 就变为了

?
1
NotificationCenter.default.post(name: .UIApplicationDidFinishLaunching, object: nil)

查看定义发现了 UIApplicationDidFinishLaunching 实际上是定义在结构体 NSNotification.Name 扩展(extension)中的的一个静态常量 (static let), 类型是 NSNotification.Name

?
1
2
3
4
5
6
7
8
9
10
11
extension NSNotification.Name {
 
 @available(iOS 4.0, *)
 public static let UIApplicationDidEnterBackground: NSNotification.Name
 
 @available(iOS 4.0, *)
 public static let UIApplicationWillEnterForeground: NSNotification.Name
 
 public static let UIApplicationDidFinishLaunching: NSNotification.Name
 ...
}

复制代码所以我们才可以省略前面的 Notification.Name 直接使用 .UIApplicationDidFinishLaunching (Notification.Name 是 NSNotification.Name 的别名)

那我们如果想自定义一个通知怎么办呢, 直接可以仿照系统的方式, 我们自己为其增加一个 extension

?
1
2
3
extension Notification.Name {
 static let LoginStatusChanged = Notification.Name("LoginStatusChanged")
}

其中 Notification.Name("LoginStatusChanged") 是其初始化方法, 可查看文档说明, 使用时, 可直接

?
1
NotificationCenter.default.post(name: .LoginStatusChanged, object: nil)

因为这个通知 LoginStatusChanged 是定义在 Notification.Name 中的了, 所以也没必要在名称后面增加 Notification 等字样来表示这是一个通知了. 所以 Swift 中很多定义的名称都是非常简洁的.

对比 Objective-C 中的使用

对比之前在 Objective-C 中的使用

?
1
[[NSNotificationCenter defaultCenter] postNotificationName:"xxxxxxxxxx" object:nil

这样是非常容易出错的, 查这样的错误经常也是非常费时费力的, 也让人看来是非常不优雅的, 所以我们经常会进行宏定义或者是常量来防止字符串硬编码的问题.

但这实际上也是会带来一些令人头疼的问题的:

  • 为了表明定义的字符串常量是一个通知名, 还要为其增加冗长的前缀或者是后缀
  • 在开发中还经常会在代码补全中, 看到根本不和场合的一些常量名
  • 通常为了使用方便和易于维护, 还会在将所有的通知定义在一个 xxDefine.h 的头文件中, 并在 pch 文件中引用, 此时如果增删或者修改了任意通知. 将会引起工程的全量重新编译. 也很是头疼.
    ...

所以, Swift 这种使用方式可谓是十分优雅.

举一反三

在开发中, 其实类似于 Notification 这种需要传递字符串的场景还有很多, 我们都可以使用这类使用方法进行优化.

场景

假设有这样一个场景, 定义一个类 EventReporter 用来处理埋点请求.

?
1
2
3
4
5
6
7
8
class EventReporter {
 
 static let shared = EventReporter()
 
 func reportEvent(_ eventId: String, withParams params: [String:Any]?) {
 // 埋点上报逻辑
 }
}

相信这样的场景是很多人都见过的, 其中 eventId 是我们埋点的事件的ID, 那么该如何使用类似 Notification.Name 的方式来优化这类场景呢?

原理

从文档中看出 Notification.Name 实际上是遵从了一个协议 RawRepresentable

Overview
With a RawRepresentable type, you can switch back and forth between a custom type and an associated RawValue type without losing the value of the original RawRepresentable type. Using the raw value of a conforming type streamlines interoperation with Objective-C and legacy APIs and simplifies conformance to other protocols, such as Equatable, Comparable, and Hashable.
The RawRepresentable protocol is seen mainly in two categories of types: enumerations with raw value types and option sets.

简单的说就是, 使用 RawRepresentable 类型, 可以在自定义类型和其关联的 RawValue 类型之间来回切换, 可简化与 Objective-C 和传统 API 的交互, 两类:具有原始值类型和选项集的枚举(OptionSet, 其实 Swift 中的选项集枚举就是集成自 RawRepresentable 这个 Protocol 实现的), 说白了. 就是用一个类型封装一下我们想要使用的类型比如说 String, 来方便交互.

实现

使用起来很简单, 定义一个结构体来管理所有的埋点事件

?
1
2
3
struct EventID: RawRepresentable {
 
}

根据编译器提示, 补全协议代码

?
1
2
3
4
5
6
7
8
9
struct EventID: RawRepresentable {
 typealias RawValue = String
 
 var rawValue: String
 
 init?(rawValue: String) {
 
 }
}

从这就更容易看出其原理, 实际上内部的 rawValue 属性就是我们需要使用的 String 类型的事件名, 初始化方法传入该 String 对其赋值即可, 返回 EventID 类型的结构体

这里发现初始化方法返回的是一个 Optional 类型, 这样使用起来还需要解包, 不太方便, 可以看到 Notification.Name 的初始化方法返回并不是 Optional, 因为定义都是非常确定的事件名(通知名), 而且 init 方法中也不会产生异常, 所以此处没什么必要使用 Optional, 去掉 ? 即可

?
1
2
3
4
5
6
7
8
9
struct EventID: RawRepresentable {
 typealias RawValue = String
 
 var rawValue: String
 
 init(rawValue: String) {
 self.rawValue = rawValue
 }
}

那么, 我们的上报类的代码可以修改如下, 这里还可以给 params 一个默认值, 这样如果没有参数时, 可以只传递 eventId 一个参数即可.

?
1
2
3
4
5
6
7
8
9
class EventReporter {
 
 static let shared = EventReporter()
 
 func reportEvent(_ eventId: EventID, withParams params: [String:Any]? = nil) {
 let event = eventId.rawValue
 // 埋点逻辑
 }
}

最后, 定义一个埋点事件看看吧~, 推荐写到 extension 中易于维护.

?
1
2
3
extension EventID {
 static let LoginPageExposure = EventID(rawValue: "login_page_exposure")
}

那么使用的时候,

?
1
EventReporter.shared.reportEvent(.LoginPageExposure)

当我们打出 . 的时候, 代码补全就已经将 LoginPageExposure 提示给我们了.

总结

使用这种方式优化代码, 不仅可以让代码意图容易理解, 使用也更加简单不会出错. 而且也不会使得 LoginPageExposure 事件名在不想要出现的时候被代码补全功能强行弹出来.

好了,以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,如果有疑问大家可以留言交流,谢谢大家对服务器之家的支持。

Reference

原文链接:https://juejin.im/post/5b66ed0bf265da0fa50a3840