KeyPath 最佳实践

Swift 4.0 带来的一个新功能就是 Smart KeyPath,之前在 Twitter 上看到 Chris Eidhof 大神在征集 KeyPath 的用法。

我也搜集了一下,当作是一次总结,这里面的技巧其实大部分都很难在实践中用上,只是好玩有趣而已,也算是一种启发吧。

类型安全的 Query API

出处:Kuery

利用了 KeyPath 类型安全的特性,提供了类型安全的 Query API。目前唯一做出来的一个成品是 Kuery 库,类型安全的 CoreData 查询 API,相同的方式也可以为 Realm,SQLite 等数据库服务,下面是它的使用范例:

Query(Person.self).filter(\.name != "Katsumi")
Query(Person.self).filter(\.age > 20)

其实我个人觉得这个 API 还可以再简化:

Query.filter(\Person.name != "Katsumi")
// 或
Query<Person>.filter(\.name != "Katsumi")

这个库的原理是操作符重载,大家看一下函数声明就能大概理解了:

public func == <ManagedObject: NSManagedObject, Property: Equatable>(
    lhs: KeyPath<ManagedObject, Property?>,
    rhs: Property?) 
    -> NSPredicate<ManagedObject> { ... }

具体实现的时候使用了 KeyPath 的属性 _kvcKeyPathString,这是为了兼容 ObjectiveC 的 KVC 而存在的属性,它并非是一个公开的 API,在正式文档或 Xcode 里是查不到这个属性的,具体的细节我们可以在 GitHub 上看到。

虽然查不到,但目前代码里是可以使用这个属性的(Xcode 9.0,Swift 4.0),Kuery 的作者也去 Rader 里反馈了将这个 API 正式化的需求,不过暂时还是不推荐大家使用这种方式。

ReadOnly 的 Class

出处:Chris Eidhof

final class ReadOnly<T> {
    private let value: T
    
    init(_ value: T) {
        self.value = value
    }
    
    subscript<P>(keyPath: KeyPath<T, P>) -> P {
        return value[keyPath: keyPath]
    }
}

import UIKit

let textField = UITextField()

let readOnlyTextField = ReadOnly(textFiled)

r[\.text]          // nil
r[\.text] = "Test" // 编译错误

这是个很好玩的实现,正常来说我们实现只读,都是使用接口的权限设计,例如 private(set) 之类的做法,但这里利用了 KeyPath 无法修改值的特性实现了这一个功能,强行修改就会像上面那样在编译时就抛出错误。

不过这种只读权限的颗粒度太大,只能细致到整个类实例,而不能针对每一个属性。而且我在实践中也没有找到合适的使用场景。

取代 Selector 的抽象

这是我在泊学网的会员群里偶然看到的,11 说 Swift 4 里也有原生的 Selector。仔细想了一下,就只有 KeyPath 了,实现出来大概会是这样:

// 定义
extension UIControl {
    func addTarget<T>(
        _ target: T,
        action: KeyPath<T, (UIControl) -> ()>,
        for controlEvents: UIControlEvents)
    { ... }
}

// 调用
button.addTarget(self, action: \ViewController.didTapButton, for: .touchUpInside)

这样处理的话,didTapButton 方法甚至都不需要依赖于 Objective-C 的 runtime,只要能用 KeyPath 把方法取出来就行了。

但实际试了一下之后,发现并不可行,我就去翻了一下 KeyPath 的提案

We think the disambiguating benefits of the escape-sigil would greatly benefit function type references, but such considerations are outside the scope of this proposal.

前半句其实我不太理解,但整句话读下来,感觉应该是实现起来很复杂,会与另外的一个问题交织在一起,所以暂时不在这个提案里处理。我去翻邮件列表的时候终于找到了想要的答案:

for unapplied method references, bringing the two closely-related features into syntactic alignment over time and providing an opportunity to stage in the important but currently-source-breaking changes accepted in SE-0042 https://github.com/apple/swift-evolution/blob/master/proposals/0042-flatten-method-types.md.

KeyPath 指向方法的这个 Feature,和 SE-0042 很接近,所以后面会两个功能一起实现。

状态共享的值类型

出处:Swift Talk #61 | Swift Talk #62

这应该算是这篇文章里面最 Tricky 但是也最有趣的一个用法了,我在看 Swift Talk 的时候,介绍的一种状态共享的值类型,直接上代码:

final class Var<A> {
    private var _get: () -> A
    private var _set: (A) -> ()
    
    var value: A {
        get { return _get()  }
        set { _set(newValue) }
    }
    
    init(_ value: A) {
        var x = value
        _get = { x }
        _set = { x = $0 }
    }
    
    private init(get: @escaping () -> A, set: @escaping (A) -> ()) {
        _get = get
        _set = set
    }
    
    subscript<Part>(_ kp: WritableKeyPath<A, Part>) -> Var<Part> {
        return Var<Part>(
            get: { self.value[keyPath: kp]      },
            set: { self.value[keyPath: kp] = $0 })
    }
}

看完代码可能有点难理解,我们再看一下示例然后再解释:

var john = Person(name: "John", age: 11)

let johnVar = Var(john)
let ageVar = johnVar[\.age]

print(johnVar.value.age) // 11
print(ageVar.value)      // 11

ageVar.value = 22

print(johnVar.value.age) // 22
print(ageVar.value)      // 22

johnVar.value.age = 33

print(johnVar.value.age) // 33
print(ageVar.value)      // 33

上面我们可以看到 ageVarjohnVar 分割出来之后,它的状态依旧跟 johnVar 保持一致,这是因为 Var 的 init 方法里使用 block 捕获了 x 这个变量,也就相当于作为 inout 参数传入了进去,这个时候 x 会存放在堆区。

并且使用 subscript 生成了 ageVar 之后,ageVar 使用的 init 的方法只是在原本的 _get_set 方法外面再包了一层,所以 ageVar 修改值的时候,也是使用了原本 johnVar 一样的 _set,修改了最初 johnVar 初始化时使用的 x。换句话说,ageVarjohnVar 使用的都是堆区里同一个 x。听着是不是很像 class?🤔

更具体的细节,大家可以去看 Swift Talk。

结尾

KeyPath is incredibly important in Cocoa Development. And this is they let us reason about the structure of our types apart from any specific instance in a way that's far more constrained than a closure.

—— What's New in Foundation · WWDC 2017 · Session 212

上面这段话摘录自今年 WWDC 的 What's New in Foundation,简单的翻译就是 KeyPath 对于 Cocoa 的使用非常重要,因为它可以通过类型的结构,去获取任意一个实例的相应属性,而且这种方式远比闭包更加简单和紧凑。

觉得文章还不错的话可以关注一下我的博客

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,793评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,567评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,342评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,825评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,814评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,680评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,033评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,687评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,175评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,668评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,775评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,419评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,020评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,978评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,206评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,092评论 2 351
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,510评论 2 343

推荐阅读更多精彩内容