Combine进化之路2——Publisher

发布者 Publisher

在Combine中,Publisher是观察者模式中的Observable,并且可以通过组合变换(利用Operator)重新生成新的Publisher。

/// # Creating Your Own Publishers
///
/// Rather than implementing the `Publisher` protocol yourself, you can create your own publisher by using one of several types provided by the Combine framework:
///
/// - Use a concrete subclass of ``Subject``, such as ``PassthroughSubject``, to publish values on-demand by calling its ``Subject/send(_:)`` method.
/// - Use a ``CurrentValueSubject`` to publish whenever you update the subject’s underlying value.
/// - Add the `@Published` annotation to a property of one of your own types. In doing so, the property gains a publisher that emits an event whenever the property’s value changes. See the ``Published`` type for an example of this approach.
@available(macOS 10.15, iOS 13.0, tvOS 13.0, watchOS 6.0, *)
public protocol Publisher<Output, Failure> {

    /// The kind of values published by this publisher.
    associatedtype Output

    /// The kind of errors this publisher might publish.
    ///
    /// Use `Never` if this `Publisher` does not publish errors.
    associatedtype Failure : Error

    /// Attaches the specified subscriber to this publisher.
    ///
    /// Implementations of ``Publisher`` must implement this method.
    ///
    /// The provided implementation of ``Publisher/subscribe(_:)-4u8kn``calls this method.
    ///
    /// - Parameter subscriber: The subscriber to attach to this ``Publisher``, after which it can receive values.
    func receive<S>(subscriber: S) where S : Subscriber, Self.Failure == S.Failure, Self.Output == S.Input
}

在Publisher定义中,Output代表数据流中的输出值,值的更新可能是同步或者异步。Failure代表可能产生的错误。Publisher最核心的是定义了值与可能的错误
Publisher通过receive(subscriber:)接受订阅,并且要求Subscriber的值和错误的类型一致来保证类型安全。
官方例子:

extension NotificationCenter {
        struct Publisher: Combine.Publisher {
                typealias Output = Notification
                typealias Failure = Never
                init(center: NotificationCenter, name: Notification.Name, object: Any? = nil)
        }
}

例子中,Publisher提供的值是Notification类型,而且永远不会产生错误(Never)。这个扩展很方便的将任何Notification转换成Publisher,便于我们将应用改造成Reactive。

Just

只发送一次消息就结束

let justPublisher = Just("一次消息")

Empty

不提供任何值更新,并且可以选择立即正常结束。

func emptyFunc() {
        // 只发送一次消息,不带任何信息
        let emptyPublisher = Empty(completeImmediately: true, outputType: (Any).self, failureType: Never.self)
        let emptyPublisher2 = Empty<Any, Never>(completeImmediately: false)
    }

Once

Once可以提供两种数据流之一:

  1. 发送一次值更新,然后立即正常结束(和Just一样)
  2. 立即因错误而终止
没有找到对应的API,还在翻阅资料中……

Fail

  1. 发送一次值更新,然后立即因错误而终止
  2. 立即因错误而终止

enum NetWorkError: Error, Equatable {
    case message(String, Any?)
    case noNetWork
    
    static func == (lhs: NetWorkError, rhs: NetWorkError) -> Bool {
        lhs.errorDescription == rhs.errorDescription
    }
}
extension NetWorkError: LocalizedError {
    var errorDescription: String? {
        return "\(self)"
    }
}


let failPublisher = Fail(outputType: Any.self, failure: NetWorkError.message("我是错误", nil))

Sequence

将给定的一个序列按序通知到订阅者。

let sequencePublisher = [1, 2, 3].publisher

Future

Future需要提供执行具体操作的closure,这个操作可以是异步,最终返回一个Result。
所以Future要么发送一个值正常结束,要么因错误而终止。在将一些一步操作转换为Publisher时非常有用,特别是网络请求。

let future = Future<Data?, Never> { promise in
            URLSession.shared.dataTask(with: URL(string: "https://api")!) { data, response, error in
                promise(.success(data))
            }.resume()
        }

Deferred

deferred初始化需要提供一个closure,只有在Subscriber订阅的时候才会生成指定的Publisher,并且每个Subscriber获取到的Publisher都是全新的

let deferredPublisher = Deferred {
            return Just(arc4random())
}

延时发布消息

可以使用delay方法,生成一个新的Publisher。

// 只发送一次消息
let justPublisher = Just("一次消息")
        
// 延迟2秒发布消息
let delyPublisher = justPublisher.delay(for: 2, scheduler: DispatchQueue.main)

Combine进化之路合集

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

推荐阅读更多精彩内容