Class ProducerObserverArbiter<T>

java.lang.Object
rx.internal.producers.ProducerObserverArbiter<T>
Type Parameters:
T - the value type
All Implemented Interfaces:
Observer<T>, Producer

public final class ProducerObserverArbiter<T> extends Object implements Producer, Observer<T>
Producer that serializes any event emission with requesting and producer changes.

The implementation shortcuts on error and overwrites producers that got delayed, similar to ProducerArbiter.

  • Field Details

    • child

      final Subscriber<? super T> child
    • emitting

      boolean emitting
    • queue

      List<T> queue
    • currentProducer

      Producer currentProducer
    • requested

      long requested
    • missedRequested

      long missedRequested
    • missedProducer

      Producer missedProducer
    • missedTerminal

      Object missedTerminal
    • hasError

      volatile boolean hasError
    • NULL_PRODUCER

      static final Producer NULL_PRODUCER
  • Constructor Details

    • ProducerObserverArbiter

      public ProducerObserverArbiter(Subscriber<? super T> child)
  • Method Details

    • onNext

      public void onNext(T t)
      Description copied from interface: Observer
      Provides the Observer with a new item to observe.

      The Observable may call this method 0 or more times.

      The Observable will not call this method again after it calls either Observer.onCompleted() or Observer.onError(java.lang.Throwable).

      Specified by:
      onNext in interface Observer<T>
      Parameters:
      t - the item emitted by the Observable
    • onError

      public void onError(Throwable e)
      Description copied from interface: Observer
      Notifies the Observer that the Observable has experienced an error condition.

      If the Observable calls this method, it will not thereafter call Observer.onNext(T) or Observer.onCompleted().

      Specified by:
      onError in interface Observer<T>
      Parameters:
      e - the exception encountered by the Observable
    • onCompleted

      public void onCompleted()
      Description copied from interface: Observer
      Notifies the Observer that the Observable has finished sending push-based notifications.

      The Observable will not call this method if it calls Observer.onError(java.lang.Throwable).

      Specified by:
      onCompleted in interface Observer<T>
    • request

      public void request(long n)
      Description copied from interface: Producer
      Request a certain maximum number of items from this Producer. This is a way of requesting backpressure. To disable backpressure, pass Long.MAX_VALUE to this method.

      Requests are additive but if a sequence of requests totals more than Long.MAX_VALUE then Long.MAX_VALUE requests will be actioned and the extras may be ignored. Arriving at Long.MAX_VALUE by addition of requests cannot be assumed to disable backpressure. For example, the code below may result in Long.MAX_VALUE requests being actioned only.

       request(100);
       request(Long.MAX_VALUE-1);
       
      Specified by:
      request in interface Producer
      Parameters:
      n - the maximum number of items you want this Producer to produce, or Long.MAX_VALUE if you want the Producer to produce items at its own pace
    • setProducer

      public void setProducer(Producer p)
    • emitLoop

      void emitLoop()