2.3 特殊的 Publisher:Subject

Subject 协议继承自 Publisher 协议,遵循 Subject 协议的 Publisher 是一种特定类型的 Publisher,它有如下方法:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
/** Subject 协议方法 */

/** 向订阅者发送数据 */
// 发送指定值
func send(Self.Output)
// 发送空值(此时 Output 类型为 Void)
func send()

/** 向订阅者发送生命周期事件 */
// 发送 subscription 实例
func send(subscription: Subscription)

// 发送 completion 信号
func send(completion: Subscribers.Completion<Self.Failure>)

Subject 的特别之处在于,我们可以手动调用 send 方法向数据流注入新的值。

Combine 内置了如下两种 Subject:CurrentValueSubject 和 PassthroughSubject。

CurrentValueSubject

CurrentValueSubject 需要一个初始化的值,并将该值暂存,当我们注入新值时,暂存的值也会更新。除了使用 send 方法来实现注入和更新值,我们还能给 value 属性赋值来达到同样的目的。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
let subject = CurrentValueSubject<Int, Never>(0)
subject.send(1)

// 0 是订阅前已经生产的数据,没有订阅者可以接收该值,它会被丢弃
// 被暂存的 1 会成为 cancellableA 接收到的第一个值
let cancellableA = subject.sink(receiveValue: {
  print("cancellableA receiveValue:\($0)")
})
subject.send(2)
print("Current value: ", subject.value)

let cancellableB = subject.sink(receiveValue: {
  print("cancellableB receiveValue:\($0)")
})

subject.value = 3
print("Current value: ", subject.value)

// print
cancellableA receiveValue:1
cancellableA receiveValue:2
Current value:  2
cancellableB receiveValue:2
cancellableA receiveValue:3
cancellableB receiveValue:3
Current value:  3

PassthroughSubject

PassthroughSubject 和 CurrentValueSubject 是类似的,区别在于它不要初始化值,也不会保存值。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
let subject = PassthroughSubject<Int, Never>()

subject.send(0)

// 订阅前发送的 0 同样会被丢弃
// cancellableA 只能接收此后发送的所有数据
let cancellableA = subject.sink(receiveValue: {
  print("cancellableA receiveValue:\($0)")
})

subject.send(1)

let cancellableB = subject.sink(receiveValue: {
  print("cancellableB receiveValue:\($0)")
})

subject.send(2)

// print
cancellableA receiveValue:1
cancellableA receiveValue:2
cancellableB receiveValue:2

小结:

  • CurrentValueSubject:订阅者会接收它发布的最近一个暂存数据和之后所有数据
  • PassthroughSubject:订阅者会接收它之后发布的所有数据