2019.12.02 update: 感谢掘友 Swteefish 的提醒 propertyWrapper 的正式中文名叫 属性包装
---下面是正文---
什么是@propertyWrapper?
从字面意思去理解 property Wrapper 就是属性包裹器(我初二英语水平硬翻，写的时候国内好像还没有一个统一的叫法。有知道学名的同学提醒下谢啦~)。
它的作用对象是属性
其主旨就是：通过property Wrapper机制，对一些类似的属性的实现代码做同一封装。
说简单点： 通过@propertyWrapper可以移除掉一些重复或者类似的代码。
@propertyWrapper 的使用步骤
propertyWrapper这个知识点不难,比较新而已。只要自己复制下面的Demo在playGround里跑一遍看一下就会了。
下面用UserDefaults保存是否显示新手引导的例子来让大家有一个直观的了解
没有@propertyWrapper 的时候。。😔
extension UserDefaults {
public enum Keys {
static let hadShownGuideView = "had_shown_guide_view"
}
var hadShownGuideView: Bool {
set {
set(newValue, forKey: Keys.hadShownGuideView)
}
get {
return bool(forKey: Keys.hadShownGuideView)
}
}
}
/// 下面的就是业务代码了。
let hadShownGuide = UserDefaults.standard.hadShownGuideView
if !hadShownGuide {
/// 显示新手引导 并保存本地为已显示
showGuideView() /// showGuideView具体实现略。
UserDefaults.standard.hadShownGuideView = true
}
可是项目中有很多地方需要UserDefaults保存本地数据,数据量多了这样的重复代码就很多了。
有@propertyWrapper 的时候。。😁
@propertyWrapper /// 先告诉编译器 下面这个UserDefault是一个属性包裹器
struct UserDefault<T> {
///这里的属性key 和 defaultValue 还有init方法都是实际业务中的业务代码
///我们不需要过多关注
let key: String
let defaultValue: T
init(_ key: String, defaultValue: T) {
self.key = key
self.defaultValue = defaultValue
}
/// wrappedValue是@propertyWrapper必须要实现的属性
/// 当操作我们要包裹的属性时 其具体set get方法实际上走的都是wrappedValue 的set get 方法。
var wrappedValue: T {
get {
return UserDefaults.standard.object(forKey: key) as? T ?? defaultValue
}
set {
UserDefaults.standard.set(newValue, forKey: key)
}
}
}
///封装一个UserDefault配置文件
struct UserDefaultsConfig {
///告诉编译器 我要包裹的是hadShownGuideView这个值。
///实际写法就是在UserDefault包裹器的初始化方法前加了个@
/// hadShownGuideView 属性的一些key和默认值已经在 UserDefault包裹器的构造方法中实现
@UserDefault("had_shown_guide_view", defaultValue: false)
static var hadShownGuideView: Bool
}
///具体的业务代码。
UserDefaultsConfig.hadShownGuideView = false
print(UserDefaultsConfig.hadShownGuideView) // false
UserDefaultsConfig.hadShownGuideView = true
print(UserDefaultsConfig.hadShownGuideView) // true
我把@propertyWrapper 的具体用法和知识点已经写到了demo中。 PlayGround中跑一跑就很稳了。
当添加新的key去保存数据的时候只用在UserDefaultsConfig 中添加新的属性和包裹器就行
struct UserDefaultsConfig {
@UserDefault("had_shown_guide_view", defaultValue: false)
static var hadShownGuideView: Bool
///保存用户名称
@UserDefault("username", defaultValue: "unknown")
static var username: String
}
Over.
参考资料：
最早关于Property Wrapper 的提案:swift-evolution 0258 (特别长一段英文，略略略)
Property wrappers to remove boilerplate code in Swift
nshipster-propertywrapper
