Combine 是 Swift 在 2019 年推出的一个框架,它供给了声明式的 API,用来处理随时间而改变的值。

它的主要概念分为两大类:Publisher、Subscriber。下面就来具体介绍一下这两种类型。

Publisher

Publisher 即发布者。当上游的值发生改变的时分,它负责对值进行处理(处理值的这一进程由 Operator 来完成),然后再下发给下流(下流即 Subscriber)。

下面是它的源码

public protocol Publisher<Output, Failure> {
    associatedtype Output
    associatedtype Failure : Error
    func receive<S>(subscriber: S) where S : Subscriber, Self.Failure == S.Failure, Self.Output == S.Input
}

首要,能够看到 Publisher 是一个协议。它有两个泛型参数:Output 代表输出的数据,Failure 代表失利。

它还有一个 receive 的函数,用来承受一个目标。该目标要恪守 Subscriber 协议,且该目标的 Failure 要与 Publisher 的 Failure 类型共同;该目标的 Input 类型要与 Publisher 的 Output 类型共同。

Tips:Publisher 的 extension 还有许多关于 Operator 的完成,代码太多就不放上来了,这块放到专门讲 Operator 的当地讲。

介绍完 Publisher,接下来就轮到 Subscriber 了。

Subscriber

Subscriber 即承受者。它承受 Publisher 传递过来的值。下面是它的源码:

public protocol Subscriber<Input, Failure> : CustomCombineIdentifierConvertible {
    associatedtype Input
    associatedtype Failure : Error
    func receive(subscription: Subscription)
    func receive(_ input: Self.Input) -> Subscribers.Demand
    func receive(completion: Subscribers.Completion<Self.Failure>)
}

它与 Publisher 一样,也是一个协议。有两个泛型参数:Input 和 Failure。

Input 用来承受上游传递的值,Failure 用来承受上游传递的过错。

它还有三个函数,用来进行 Subscriber 和 Publisher 之间的交互。

基本运用

假定,咱们现在在做一个从网络加载数据,UI 显示的需求。首要,咱们要导入该框架:

import Combine

接着界说一个数据加载完毕的告诉名字,界说一个承受网络数据的结构体,界说一个展现数据的标签:

extension Notification.Name {
    static let dataLoaded = Notification.Name("data_loaded")
}
struct Item {
    let title: String
}
private let titleLabel = UILabel()

声明一个 publisher 的目标,声明一个 subscriber 的目标,再将两个目标绑定:

let publisher = NotificationCenter.Publisher(center: .default, name: .dataLoaded)
let subscriber = Subscribers.Assign(object: self.titleLabel, keyPath: \.text)
publisher.subscribe(subscriber)

上面的代码你会发现编译报错,原因便是 publisher 的 Output 和 subscribe 的 Input 类型不共同。这个需求借助 operator 来进行类型转换

let publisher = NotificationCenter.Publisher(center: .default, name: .dataLoaded)
    .map { noti -> String?  in
        return (noti.object as? Item)?.title
    }

最后,咱们经过 touchesBegan 来模拟网络数据加载完成:

override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?) {
    let data = Item(title: "我是一个标题")
    NotificationCenter.default.post(name: .dataLoaded, object: data)
    print(titleLabel.text ?? "")
}

运转项目,点击屏幕之后,就能够看到调试区打印:我是一个标题

代码优化

上面的声明 subscriber 与 publisher 进行绑定的代码能够替换成下面的代码:

let subscriber = Subscribers.Assign(object: self.titleLabel, keyPath: \.text)
publisher.subscribe(subscriber)
// 替换为
private var cancel: AnyCancellable?
self.cancel = publisher.assign(to: \.text, on: self.titleLabel)

assign 操作符的作用便是将 publisher 的值赋值给绑定目标的属性。

需求留意的是:运用 assign 必须运用 AnyCancellable 类型的目标引证,否则不起作用。

当咱们不需求 Subscribe 的时分,需求调用 cancel() 将内存释放掉。