Class SyncOnSubscribe.SubscriptionProducer<S,​T>

  • Type Parameters:
    T - the type of compatible Subscribers
    All Implemented Interfaces:
    java.io.Serializable, Observer<T>, Producer, Subscription
    Enclosing class:
    SyncOnSubscribe<S,​T>

    static final class SyncOnSubscribe.SubscriptionProducer<S,​T>
    extends java.util.concurrent.atomic.AtomicLong
    implements Producer, Subscription, Observer<T>
    Contains the producer loop that reacts to downstream requests of work.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      private void doUnsubscribe()  
      private void fastpath()  
      private void handleThrownError​(Subscriber<? super T> a, java.lang.Throwable ex)  
      boolean isUnsubscribed()
      Indicates whether this Subscription is currently unsubscribed.
      private void nextIteration​(SyncOnSubscribe<S,​T> parent)  
      void onCompleted()
      Notifies the Observer that the Observable has finished sending push-based notifications.
      void onError​(java.lang.Throwable e)
      Notifies the Observer that the Observable has experienced an error condition.
      void onNext​(T value)
      Provides the Observer with a new item to observe.
      void request​(long n)
      Request a certain maximum number of items from this Producer.
      private void slowPath​(long n)  
      private boolean tryUnsubscribe()  
      void unsubscribe()
      Stops the receipt of notifications on the Subscriber that was registered when this Subscription was received.
      • Methods inherited from class java.util.concurrent.atomic.AtomicLong

        accumulateAndGet, addAndGet, compareAndExchange, compareAndExchangeAcquire, compareAndExchangeRelease, compareAndSet, decrementAndGet, doubleValue, floatValue, get, getAcquire, getAndAccumulate, getAndAdd, getAndDecrement, getAndIncrement, getAndSet, getAndUpdate, getOpaque, getPlain, incrementAndGet, intValue, lazySet, longValue, set, setOpaque, setPlain, setRelease, toString, updateAndGet, weakCompareAndSet, weakCompareAndSetAcquire, weakCompareAndSetPlain, weakCompareAndSetRelease, weakCompareAndSetVolatile
      • Methods inherited from class java.lang.Number

        byteValue, shortValue
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    • Field Detail

      • actualSubscriber

        private final Subscriber<? super T> actualSubscriber
      • onNextCalled

        private boolean onNextCalled
      • hasTerminated

        private boolean hasTerminated
      • state

        private S state
    • Method Detail

      • isUnsubscribed

        public boolean isUnsubscribed()
        Description copied from interface: Subscription
        Indicates whether this Subscription is currently unsubscribed.
        Specified by:
        isUnsubscribed in interface Subscription
        Returns:
        true if this Subscription is currently unsubscribed, false otherwise
      • unsubscribe

        public void unsubscribe()
        Description copied from interface: Subscription
        Stops the receipt of notifications on the Subscriber that was registered when this Subscription was received.

        This allows unregistering an Subscriber before it has finished receiving all events (i.e. before onCompleted is called).

        Specified by:
        unsubscribe in interface Subscription
      • tryUnsubscribe

        private boolean tryUnsubscribe()
      • doUnsubscribe

        private void doUnsubscribe()
      • 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
      • fastpath

        private void fastpath()
      • handleThrownError

        private void handleThrownError​(Subscriber<? super T> a,
                                       java.lang.Throwable ex)
      • slowPath

        private void slowPath​(long n)