转载

用Swift更优雅地管理用户偏好设置

大部分项目都需要选择一种数据持久化方案来保存用户的偏好设置，在iOS开发中一般选择UserDefaults。下面先简单介绍下一般的实现方式，然后再介绍下我在开源项目中学到的一种新姿势。

准备

项目中除了要支持保存基本数据类型，也要支持自定义类型。为了简化描述，本文只选择了两种不同的基本数据类型和一种自定义类型。其中launchAtLogin是Bool型，launchCount是Int型，userInfo定义如下：

用Swift更优雅地管理用户偏好设置

注：由于自定义类需要遵循NScoding协议并编码成Data格式才能通过UserDefaults保存。以上代码通过Mirror去遍历对象属性来实现NSCoding协议，可参考前一篇博文：利用Swift的反射机制简化代码。当然，也可以将自定义类型转换成字典，然后通过UserDefaults提供的读写字典的方法访问。

一般的方式

在较小的项目中由于偏好设置的数目和读写的次数不多，直接用下面这种一般的方式保存也不太会觉得哪里不妥或效率不高。

用Swift更优雅地管理用户偏好设置

更优雅的方式

上面这种方式看着不那么优雅，每次读写相应设置也需要多敲一些代码，降低了编码效率，当偏好设置选项多起来后缺点就更明显了。另外，读取设置时需要知道该设置的类型，然后调用UserDefaults相应的实例方法。如PreferenceKey.launchAtLogin是Bool型，需要launchAtLogin = userDefaults.bool(forKey: PreferenceKey.launchAtLogin)。读取自定义类型时，还需要进行类型转换。如userInfo = userDefaults.object(forKey: PreferenceKey.userInfo) as! UserInfo。

后来在开源编辑器项目CotEditor中看到了一种比较巧妙的实现方式，最终可以通过类似Preferences[.launchAtLogin]的形式来读写相应的偏好设置，看着有点像访问字典的方式。实际上，这种方式的主要工作就是实现类似字典的语法。下面就来看看如何实现这种访问方式。

Preference Key

在Swift中如果想让自定义类作为Key去访问某个集合中的元素，那么必须满足两个条件：

用来访问集合元素的Key类型本身需要遵循Hashable协议。
集合实现了subscript操作符，支持通过方括号[]访问集合元素。

Hashable

用Swift更优雅地管理用户偏好设置

Hashable协议中只定义了一个整型的哈希值hashValue，在Swift中任何遵循了该协议的类型都可以用来当做Set或Dictionary的Key。官方文档里面提到，在Swift标准库中很多基本类型遵循了Hashable协议，如字符串、整型、浮点型、布尔型等。对于自定义类型也只要提供一个hashValue即可。为了保证访问字典时性能，需要保证同一个对象的哈希值相等，但不同对象的哈希值也是可以相等的。其实我们可以利用String类型本身已经实现了Hashable协议这点省去计算哈希值的工作，下面的RawRepresentable协议可以帮我们达到目的。

RawRepresentable

RawRepresentable协议一样很简洁，定义了一个初始化方法init?(rawValue:)，和rawValue。

正如上面提到的，Swift中的String类型本身就已经遵循了Hashable协议，我们可以利用这一点直接在自定义类型中引入一个字符串类型的rawValue，并通过计算型属性hashValue直接返回该字符串的hashValue，即可达到遵循Hashable协议的目的。下面定义了PreferenceKey类型，最后它将作为key去访问集合元素。

用Swift更优雅地管理用户偏好设置

注：如果直接将静态存储属性放在PreferenceKeys中，编译时就会报错：

“Static stored properties not support in generic types.”

CotEditor通过继承PreferenceKeys，在子类PreferenceKey中支持泛型来巧妙地避开上面的问题。

Preference Manager

为了方便管理用户的偏好设置，可采用单例模式定义一个PreferenceManager，主要负责包括模块初始化、注册默认配置，提供访问集合元素的方法等工作。

用Swift更优雅地管理用户偏好设置

上面的代码中registerDefaultPreferences函数通过reduce方法将字典类型从[PreferenceKey: Any]转换到[String: Any]，以便UserDefaults注册默认设置。

Subscript

为了支持通过方括号[]访问PreferenceManager中的元素，还要实现subscript方法。这里虽然显得有点繁琐，项目中计划支持的类型都需要写一遍，包括自定义类型，如UserInfo。但也只是需要编写一次即可，后面需要新增支持的类型时再添加新方法。

用Swift更优雅地管理用户偏好设置

到这里就差不多结束了。不过为了更方便地访问，再定义一个全局变量：

用Swift更优雅地管理用户偏好设置

下面是访问偏好设置的最终方式：

用Swift更优雅地管理用户偏好设置

相比开头的那种方式是不是看起来很清爽？简直和读写字典元素一毛一样。我们通过这种方式把NSKeyedArchiver/NSKeyedUnarchiver的编解码过程和UserDefaults的读写过程都封装起来之后，即使是自定义类型的访问也和基本类型毫无差别了，也不用去操心我们访问的设置是什么数据类型。

但不得不说这种方式目前还是有个小遗憾，那就是Xcode有时候会一脸懵逼变白板，但出现的次数也不多。这应该是因为Swift类型推断相对复杂，导致Xcode有点吃不消。大不了通过添加类型，放弃这部分类型推断，从而减小Xcode的负担来解决，使用Preferences[PreferenceKey.launchAtLogin]来访问。不过随着Swift和Xcode的不断优化，相信这种情况会慢慢改善。

后记

读源码是学习新招式的一个非常好的途径。开始时可能只是学习和模仿，新招式积累多了，加上思考和总结，慢慢地自己也会有更多创造性的点子。

如果大家有其他新姿势，期待你们的分享。我把代码放到了GitHub上了，前一种方式对应的Commit: 7d32ddb，后一种方式对应的Commit: 0f26fb5，大家可以clone一份自己感受感受。

最后，感谢CotEditor，感谢开源。

参考链接

正文到此结束