Packages

final class ConnectableSubscriber[-A] extends Subscriber[A]

Wraps a Subscriber into an implementation that abstains from emitting items until the call to connect() happens. Prior to connect() you can enqueue events for delivery once connect() happens, but before any items emitted by onNext / onComplete and onError.

Example:

import monix.execution.Ack.Continue
import monix.execution.Scheduler.Implicits.global

val subscriber = new Subscriber[String] {
  val scheduler = global
  def onNext(a: String) = {
    println(s"Received: $$a")
    Continue
  }
  def onError(e: Throwable) =
    println(s"Error: $$e")
  def onComplete() =
    println("Completed!")
}

val out = ConnectableSubscriber(subscriber)

// schedule onNext event, after connect()
out.onNext("c")

// schedule event "a" to be emitted first
out.pushFirst("a")
// schedule event "b" to be emitted second
out.pushFirst("b")

// underlying observer now gets events "a", "b", "c" in order
out.connect()

Example of an observer ended in error:

val out2 = ConnectableSubscriber(subscriber)

// schedule onNext event, after connect()
out2.onNext("c")

out2.pushFirst("a") // event "a" to be emitted first
out2.pushFirst("b") // event "b" to be emitted second

// schedule an onError sent downstream, once connect()
// happens, but after "a" and "b"
out2.pushError(new RuntimeException())

// underlying observer receives ...
// onNext("a") -> onNext("b") -> onError(RuntimeException)
out2.connect()

// NOTE: that onNext("c") never happens
Self Type
ConnectableSubscriber[A]
Source
ConnectableSubscriber.scala
Linear Supertypes
Subscriber[A], Observer[A], Serializable, AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. ConnectableSubscriber
  2. Subscriber
  3. Observer
  4. Serializable
  5. AnyRef
  6. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  4. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  5. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @native()
  6. def connect(): CancelableFuture[Ack]

    Connects the underling observer to the upstream publisher.

    Connects the underling observer to the upstream publisher.

    This function should be idempotent. Calling it multiple times should have the same effect as calling it once.

  7. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  8. def equals(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef → Any
  9. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.Throwable])
  10. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  11. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  12. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  13. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  14. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  15. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  16. def onComplete(): Unit

    The Subscriber.onComplete method that pushes the complete event to the underlying observer.

    The Subscriber.onComplete method that pushes the complete event to the underlying observer.

    It will wait for connect to happen and the queue of scheduled events to be drained.

    Definition Classes
    ConnectableSubscriberObserver
  17. def onError(ex: Throwable): Unit

    The Subscriber.onError method that pushes an error event to the underlying observer.

    The Subscriber.onError method that pushes an error event to the underlying observer.

    It will wait for connect to happen and the queue of scheduled events to be drained.

    Definition Classes
    ConnectableSubscriberObserver
  18. def onNext(elem: A): Future[Ack]

    The Subscriber.onNext method that pushes events to the underlying subscriber.

    The Subscriber.onNext method that pushes events to the underlying subscriber.

    It will back-pressure by means of its Future[Ack] result until connect happens and the underlying queue of scheduled events have been drained.

    Definition Classes
    ConnectableSubscriberObserver
  19. def pushComplete(): Unit

    Schedule a complete event when connect happens, but before any elements scheduled with pushFirst or pushFirstAll.

    Schedule a complete event when connect happens, but before any elements scheduled with pushFirst or pushFirstAll.

    After pushComplete no more pushFirst or onNext events are accepted.

  20. def pushError(ex: Throwable): Unit

    Schedule an error event when connect happens, but before any elements scheduled with pushFirst or pushFirstAll.

    Schedule an error event when connect happens, but before any elements scheduled with pushFirst or pushFirstAll.

    After pushError no more pushFirst or onNext events are accepted.

  21. def pushFirst(elem: A): Unit

    Schedule one element to be pushed to the underlying subscriber when connect happens.

    Schedule one element to be pushed to the underlying subscriber when connect happens.

    The given elements are appended to a queue that will be drained on connect. Afterwards no more elements are allowed to be pushed in the queue.

    These elements are streamed before any elements that will eventually get streamed with onNext, because of the applied back-pressure from onNext.

  22. def pushFirstAll[U <: A](xs: Iterable[U]): Unit

    Schedule elements to be pushed to the underlying subscriber when connect happens.

    Schedule elements to be pushed to the underlying subscriber when connect happens.

    The given elements are appended to a queue that will be drained on connect. Afterwards no more elements are allowed to be pushed in the queue.

    These elements are streamed before any elements that will eventually get streamed with onNext, because of the applied back-pressure from onNext.

  23. implicit val scheduler: Scheduler
    Definition Classes
    ConnectableSubscriberSubscriber
  24. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  25. def toString(): String
    Definition Classes
    AnyRef → Any
  26. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  27. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  28. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException]) @native()

Inherited from Subscriber[A]

Inherited from Observer[A]

Inherited from Serializable

Inherited from AnyRef

Inherited from Any

Ungrouped