Combine-Publisher

2020-04-09 11:28:59 浏览数 (1)

概念

  • Combine 中包括Publisher在内的一系列角色都使用协议来进行定义,这是 Swift 面向协议编程思想的具体体现。
  • Publisher 随着时间推移向一个或多个Subscriber发布数据。
  • Publisher 最主要的工作其实有两个
    • 被 Subscriber 订阅
    • 发布数据和数据

Publisher定义

代码语言:javascript复制
public protocol Publisher {
    /// 发送的数据的类型
    associatedtype Output

    /// Publisher可能产生的错误类型,如果不会产生错误,则使用Never
    associatedtype Failure: Error

    /// 在调用Publisher的subscribe(_:)方法时方法内部会调用此方法去连接Subscriber
    func receive<S>(subscriber: S) where S: Subscriber, Self.Failure == S.Failure, Self.Output == S.Input
}

extension Publisher {
    /// 将指定的Subscriber连接到此Publisher
    /// 调用此方法连接而不是receive(subscriber:)
    public func subscribe<S>(_ subscriber: S) where S: Subscriber, Self.Failure == S.Failure, Self.Output == S.Input
}

解读

  • OutputFailure定义了 Publisher 所发布的数据的类型和可能产生的错误类型。
  • subscribe (_:)方法将 Subscriber 连接到 Publisher。 它规定: Publisher 的Output必须与 Subscriber 的Input类型匹配,Failure也是如此。

内置Publisher

  • Just:只提供一个结果然后终止的 Publisher ,失败类型为<Never>。(★)
  • Future:异步操作的 Publisher ,用一个闭包初始化,该闭包最终解析为单个输出数据或失败完成。(★)
  • Empty: 一个从不发布任何数据的 Publisher ,并且可以选择立即完成。
  • Fail:立即使用指定错误终止的 Publisher 。
  • Optional:如果可选数据具有数据,则 Publisher 仅向每个 Subscriber 发布一次可选数据。
  • Sequence:发布给定数据序列的 Publisher 。
  • Deferred:在运行提供的闭包之前等待订阅的 Publisher ,以便为新的 Subscriber 创建 Publisher 。
  • Record:允许记录一系列InputCompletion,供每个 Subscriber 回放。
  • Publishers.Share:实现者为类的 Publisher ,其行为与其上游 Publisher 相同。
  • Publishers.Multicast:多播 Publisher ,当有多个 Subscriber,但希望上游 Publisher 的每个数据仅调用一次receive(_ :)时使用。
  • ObservableObject:与 SwiftUI 一起使用,符合ObservableObject协议的对象可以提供 Publisher 。(★)
  • @Published:属性包装器,用来把一个属性数据转变为 Publisher 。(★)

0 人点赞